UFT Record Processing Routine

The record processing routine carries out any appropriate translation of the data, for example from EBCDIC to ASCII. If the exit routine changes the length of the data, the data count field (pointed to by Bytes 0 - 1 in Word 3 of the parameter list) must reflect this change before returning to the link driver. When the link driver regains control from this entry point, the data from the data record moves into the link driver's output buffer. When it is full, the link driver sends the buffer to the remote TCP/IP UFT daemon. This exit is driven for each record of the spool file being sent to a TCP/IP UFT daemon.

Each spool file record read will be in NETDATA format. Therefore, the spool file data may not be read on any kind of record boundary. This exit will have to save data in a local buffer to accumulate a record over multiple calls or there may be multiple records in a buffer.

Your exit routine must set the data count field in the data record vector to reflect the length of the data passed to the link driver. If your routine does not send a particular data record, it should set the data count field to zero. A data count that is negative or exceeds 1280 bytes terminates the link with user ABEND 011.

Entry Conditions

Register Contents
R0 Not applicable
R1 Address of a parameter list that contains:
Word 1 (+0)
Address of the CVT
Word 2 (+4)
Address of the LINKTABL entry
Word 3 (+8)
Address of the logical data vector that contains:
Byte 0 - 1
Number of bytes in the data record
Byte 2
CCW opcode associated with the data record
Byte 3 - n
Data record data (where n is a maximum of 1280)
Word 4 (+12)
Address of the TAG element
Word 5 (+16)
Address of the EPARM value
Word 6 (+20)
Address of the work area established by the initialization routine
Word 7 (+24)
Address of the UFTBLOK
R2 - R12 Not applicable
R13 Save area address
R14 Return address

Exit Conditions

On return, the UFT record processing routine sets the register conditions described in Exit Conditions.

Return Codes

Return Code Results
0 Tells RSCS that the spool file record element processing is complete.
4 RSCS adds the current record to the buffer and calls this exit routine again.
8 Tells RSCS to terminate the UFT link driver.
12 Tells RSCS to terminate the UFT link driver.
16 Tells RSCS to terminate the UFT link driver.