Interface for input

If the operand value *MODULE(NAME=modulename) is specified in the INPUT-EXIT operand of the ASSIGN-INPUT-FILE statement, PERCON branches to the user module every time a record from this file has been read.

Register 1 indicates the following address list:

A(parameter area) 
A(current input record) 
A(user input record) 
X'80000000'

A description of the structure of the parameter area is provided on "Common parameter area for the interfaces ".

The following values are entered in the parameter area:

Identifier of the interface: X'04'

Additional information	Meaning
X'00'	The input record is transferred to the user module.
X'04'	End of the input file. No record is transferred; in this case only the return codes X'0C' thru X'18' are relevant. A return code X’00’ specified by the user is handled by PERCON in the same way as X’10’.

The user transfers information to PERCON via the return code of the parameter area.

Return code	Meaning
X'00'	Transfer record. PERCON transfers the record which has been made available. This record may have been changed by the user. The first 4 bytes (i.e. the record length field) of variable-length records must not be overwritten.
X'04'	Replace record. The record which is stored at the address of the user input record is transferred by PERCON as the input record. The address field is set by the user. In the case of variable-length records PERCON expects the record length field in the first 4 bytes. This return code is not permissible for OPEN=UPDATE. When RECORD-FORMAT=U, the length of the replaced record is expected to be that of the transferred record.
X'08'	Do not transfer record. Processing of this record is not continued. PERCON reads the next record in the input file.
X'0C'	Insert record. The user can insert a record in front of the record read by PERCON. The address of the record to be inserted must be the third entry in the address list. When RECORD-FORMAT=U, the length of the record to be inserted is expected to be that of the transferred record. Once the inserted record has been processed by PERCON, PERCON branches back to the user module and makes the input record read prior to the insertion available again. This return code is not permissible for OPEN=UPDATE.
X'10'	Do not branch back to user module. PERCON does not branch back to the user exit for this input file. The record made available is transferred in the same way as with return code X'00'.
X'14'	Terminate reading of input file. PERCON closes this input file and opens the next input file of this conversion step, if available. The record made available is no longer transferred.
X'18'	Terminate conversion step immediately with an error.