|
IN stage v1.3 |
Pipelines v2.1 |
|
Syntax |
>>──IN───────────────────────────────────────────────────────────────────────────────><
|
Purpose |
IN
is dual purpose. When IN is specified in a pipeline that is
launched through the CALLPIPE stage command; IN reads records from that calling
pipeline. When IN is specified in a pipeline that is
connected to the STDOUT stream of another WIN32 process; IN reads records from
its STDIN stream. IN splits its input at Line-Feed
characters; discarding both
individual and groups of Carriage-Return characters and
writes the resulting records to its primary output stream.
|
Operands |
|
Streams |
The following streams are used by the IN stage:
|
|
Usage |
|
1. |
IN
does not delay the records. |
|
2. |
When
IN reads from its STDIN stream, it reads its input records one at a time; waiting
for each one to be consumed from its primary output stream before reading
another. When IN reaches end-of-file on its STDIN stream, IN disconnects its
primary output stream and the stage ends. |
|
3. |
IN splits its input
at Line-Feed characters; discarding both individual and groups of
Carriage-Return characters and writes the resulting records to its primary
output stream. IN discards the last Line-Feed character of its input where
this would produce a null output record. |
|
4. |
You
should only specify the IN stage command once in a pipeline; otherwise the
results will be unpredictable. |
|
5. |
IN verifies that its secondary input and
secondary output streams are not connected and then begins execution. |
|
Examples |
|
1. |
The following pipeline shows the path
environment variable parsed into its individual values. environ.rex **** Top of file ****1 Address Rxpipe 23 'pipe in', 4 '| split at str /;/', 5 '| specs ws /=/ w-1 1', 6 '| cons' 78 Exit 0 **** End of file ****C:\>path | environ.rexoutput:C:\WINDOWS\system32C:\WINDOWSC:\WINDOWS\System32\WbemC:\Program files\TenFiftyTwo\Pipelines
|
|
2. |
Max length |
|
3. |
Parse CSV |
|
4. |
EBCDIC to ASCII |
|
Related |
CALLPIPE, CONSOLE, OUT, RUNPIPE