Reads data records from an input pipe.
Syntax varies with the programming language.
STD and BIN pipes
are the only valid formats for the GETPIPE command.
SPINTO (see “SPINTO”) specifies the address of the RSP storage area to receive the input data. MainframeConnect places the data record into this area.
SPRECLEN (see “SPRECLEN”) specifies the length of the data record. Open ServerConnect sets the SPRECLEN for a GETPIPE.
GETPIPE is used with Access Service
Library only; it is not used with TRS.
This example reads data from a STD format input pipe into the DATAREC storage area (DATAREC is a data area defined in the RSP program):
SET ADDRESS OF DATAREAC TO SPINTO. CALL 'GETPIPE' USING SPAREA.
If you write fixed-length records of the same size as SPMAXLEN, the SPRECLEN value is not required.
However, when you have both an input pipe and an output pipe open, both pipes use this field and each must set the field value before writing or reading the record. See “Transmitting fixed-length or variable-length records” for more information.