OUTPUT command v1.1

Pipelines v2.1

 

Purpose, Operands, Streams, Usage, Examples, Related

Home

 

Need examples

 

Syntax

 
            ┌─0──────┐
>>──OUTPUT──┼────────┼──┬─────────┬──────────────────────────────────────────────────><
            └─stream  varname
                        └─string──┘
 

Purpose

 

Use the OUTPUT command to write a record to the specified output stream stream. The stream to write to corresponds to the output stream of the calling pipelines' CALLPIPE stage. OUTPUT accepts an ooRexx variable name or literal character string as an argument. It writes the contents of the variable or literal string to the specified output stream. The ooRexx variable RC is set with the return code from OUTPUT. A return code of 12 (end-of-file) is set if the specified output stream is not connected.

 

Operands

 

stream

is the stream number of the calling pipelines' CALLPIPE stage that you want to write to. A record written to a stream that is not connected; is discarded, and the ooRexx variable RC is set to a value of 12 (end-of-file).

 

varname

string

is the name of an ooRexx variable, array or stem entry, or a literal character string that is to be written to the specified output stream.

 

Streams

 

None.

 

Usage notes

 

1.

If the specified CALLPIPE stages' output stream is not connected; records written to that stream are discarded.

 

2.

varname represents any valid ooRexx variable, array or stem entry.

 

Examples

 

None.

 

Related

 

ARRAY, VARIABLE

 

History

 

Version

 

Date

Action

Description

Pipelines

1.1

28.12.2021

changed

Application-wide rewrite.

2.1

1.0

04.02.2012

created

First version.

2.0