The command-level parameter structure – IBM SC33-1683-02 User Manual

Page 118

Advertising
background image

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. To help you set values for
EIBRCODE, EIBRESP, and EIBRESP2, the values used by file control for SPI
requests are specified in DSECT DFHFAUED.

Note: Take care 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.

You can examine the EID to determine the type of request and the keywords
specified. You can examine the other parameters in the list to determine the values
of the keywords. You can 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:

v

For INQUIRE FILE, see Table 5 on page 92.

v

For SET FILE, see Table 6 on page 93.

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 53 addresses, FC_ADDR0 through
FC_ADDR52. 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:

FC_ADDR0

is the address of an 13-byte area called the EID which is made up as follows:

FC_GROUP

FC_FUNCT

FC_BITS1

FC_BITS2

FC_EIDOPT4

FC_EIDOPT5

FC_EIDOPT6

FC_BITS3

FC_BITS4

FC_BITS5

FC_BITS6

FC_BITS7

File control EXEC interface SPI exits XFCAREQ and XFCAREQC

86

CICS TS for OS/390: CICS Customization Guide

Advertising