IBM SC34-6814-04 Server User Manual


 
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