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.