The Initialization Exit; The Get-Command Exit - IBM SC34-6814-04 Customization Manual

Cics transaction server for z/os
Table of Contents

Advertisement

DFHUEXIT DSECT
UEPEXN
UEPGAA
UEPGAL
UEPCRCA DS
UEPTCA
UEPCSA
UEPHMSA DS
UEPSTACK DS
UEPXSTOR DS
UEPTRACE DS
*
UEPCMDA DS
UEPCMDL DS
*
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
Exit-specific parameters
Return codes
XPI calls

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
Exit-specific parameters
DS
A
DS
A
DS
A
A
DS
A
DS
A
A
A
A
A
A
A
Invoked once, on entry to DFHCSDUP.
None.
UERCNORM (X'00')
Continue processing.
UERCERR
Irrecoverable error. This causes DFHCSDUP to terminate with a
return code of '8'.
Must not be used.
Invoked multiple times, at the point where DFHCSDUP would otherwise
read commands from SYSIN.
Chapter 34. User programs for the system definition utility program (DFHCSDUP)
ADDRESS OF EXIT NUMBER
ADDRESS OF GLOBAL AREA
ADDRESS OF GLOBAL AREA LENGTH
ADDRESS OF CURRENT RETURN-CODE
ADDRESS OF TCA
ADDRESS OF CSA
ADDRESS OF SAVE AREA USED BY HOST
ADDRESS OF KERNEL STACK ENTRY
ADDRESS OF STORAGE OF XPI PARMS
ADDRESS OF TRACE FLAG
ADDRESS OF UTILITY COMMAND
ADDRESS OF LENGTH OF UTILITY
COMMAND
825

Advertisement

Table of Contents
loading

Table of Contents