values into the application program’s EXEC interface block (EIB) after the
completion of XFCAREQC or if you specify a return code of UERCBYP in
XFCAREQ.
Youmust set valid file control responses. You must set all three of EIBRCODE,
EIBRESP,and EIBRESP2 to a consistent set of values, such as would be set by
file control to describe a valid completion. CICS does not check the consistency of
the values you set. If EIBRCODE is set to a non-zero value and EIBRESP is set to
zero, CICS overrides EIBRESP with a non-zero value. Tohelp you set values for
EIBRCODE, EIBRESP,and EIBRESP2, the values used by file control for SPI
requests are specified in DSECT DFHFAUED.
Note: Takecare when using recursive commands. For example, you must avoid
entering a loop when issuing a file control SPI request from the XFCAREQ
exit. Use of the recursion counter UEPRECUR is recommended.
The command-level parameter structure
The command-level parameter structure consists of a series of addresses. The first
address points to the EXEC interface descriptor (EID), which consists of a bit string
that describes the type of request and identifies each keyword specified with the
request. The remaining addresses point to pieces of data associated with the
request.
Youcan examine the EID to determine the type of request and the keywords
specified. Youcan examine the other parameters in the list to determine the values
of the keywords. Youcan also modify values of keywords specified on the request.
Note: The relationship between arguments, keywords, data types, and input/output
types on the file control SPI commands is summarized in the following
tables:
vFor INQUIRE FILE, see Table5 on page 107.
vFor SET FILE, see Table6 on page 108.
The UEPCLPS exit-specific parameter:
The UEPCLPS exit-specific parameter is passed to both XFCAREQ and
XFCAREQC. It is the address of the command-level parameter structure. The
command-level parameter list contains 59 addresses, FCIS_ADDR0 through
FCIS_ADDR58. These are described in DSECT DFHFAUED,which you should
copy into your program by including the statement COPY DFHFAUED.
The command-level parameter list is made up as follows:
FCIS_ADDR0
is the address of an 13-byte area called the EID which is made up as follows:
vFCIS_GROUP
vFCIS_FUNCT
vFCIS_EIDOPT2
vFCIS_EIDOPT3
vFCIS_EIDOPT4
vFCIS_BITS1
vFCIS_BITS2
vFCIS_BITS3
Chapter1. Global user exit programs 101
|
|
|
|
|