The initialization exit, The get-command exit – IBM SC34-6814-04 User Manual
Page 847
DFHUEXIT DSECT
UEPEXN
DS
A
ADDRESS OF EXIT NUMBER
UEPGAA
DS
A
ADDRESS OF GLOBAL AREA
UEPGAL
DS
A
ADDRESS OF GLOBAL AREA LENGTH
UEPCRCA
DS
A
ADDRESS OF CURRENT RETURN-CODE
UEPTCA
DS
A
ADDRESS OF TCA
UEPCSA
DS
A
ADDRESS OF CSA
UEPHMSA
DS
A
ADDRESS OF SAVE AREA USED BY HOST
UEPSTACK DS
A
ADDRESS OF KERNEL STACK ENTRY
UEPXSTOR DS
A
ADDRESS OF STORAGE OF XPI PARMS
UEPTRACE DS
A
ADDRESS OF TRACE FLAG
*
UEPCMDA
DS
A
ADDRESS OF UTILITY COMMAND
UEPCMDL
DS
A
ADDRESS OF LENGTH OF UTILITY
*
COMMAND
Explanations of the exit-specific parameters are included in the descriptions of the
individual exits, which follow.
The initialization exit
The initialization exit is invoked once during DFHCSDUP initialization. Its purpose is
to allow a routine to perform exit-related initialization. For example, the routine may
obtain its own global work area and save its address in UEPGAA and its length in
the halfword pointed to by UEPGAL. These values are retained by DFHCSDUP and
become available at the other exit points.
When invoked
Invoked once, on entry to DFHCSDUP.
Exit-specific parameters
None.
Return codes
UERCNORM (X'00')
Continue processing.
UERCERR
Irrecoverable error. This causes DFHCSDUP to terminate with a
return code of ‘8’.
XPI calls
Must not be used.
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
Chapter 34. User programs for the system definition utility program (DFHCSDUP)
825