The get-command exit

The purpose of the get-command exit is to read in command lines. If it is specified, no commands are read from SYSIN.

On invocation, your exit routine must supply the address and length of a complete command. It must return control with either the normal return code ‘UERCNORM’ or with the code ‘UERCDONE’, signifying that it has no more commands to pass. After it has processed each command, DFHCSDUP reinvokes the exit until return code ‘UERCDONE’ is received.

When invoked
Invoked multiple times, at the point where DFHCSDUP would otherwise read commands from SYSIN.
Exit-specific parameters
UEPCMDA
Pointer to the address of a command.
UEPCMDL
Address of a halfword containing the length of the command text. The maximum length that can be specified is 1536 bytes.
Return codes
UERCNORM (X'00')
Continue processing.
UERCDONE (X'04')
No more commands to process. (This is equivalent to reaching end-of-file on the SYSIN file.)
UERCERR
Irrecoverable error. This causes DFHCSDUP to terminate with a return code of ‘8’.
XPI calls
Must not be used.


dfha3c00353.html | Timestamp icon Last updated: Sunday, 4 June 2017