PIPE
PIPE( command, recorddef )
PIPE( recordset, command [, recorddef ] [, REPEAT] )
| command | The name of a program to execute. This must have already been deployed on the supercomputer. |
| recorddef | The RECORD structure format for output. If omitted, output is the same as the input format. |
| recordset | The input dataset. |
| REPEAT | Optional. Specifies a new instance of the command program is created for each row in the recordset. |
| Return: | PIPE returns a record set. |
The PIPE function has two forms. Form 1 has no input, executes the command, producing output in the recorddef format. Form 2 takes the input recordset, executes the command, producing output in the recorddef format. This is a "through" pipe.
Example:
namesRecord := RECORD
STRING10 forename;
STRING10 surname;
STRING2 nl := '
';
END;
d := PIPE('pipeRead 200', namesRecord); //form 1
t := PIPE(d, 'pipeThrough'); //form 2
OUTPUT(t,,PIPE('pipeWrite hordata
ames.all'));
See Also: OUTPUT, DATASET
US: 1.877.316.9669
