The UEPCLPS exit-specific parameter

The UEPCLPS exit-specific parameter is passed to both XFCAREQ and XFCAREQC and contains the address of the command-level parameter structure.

The command-level parameter list contains 64 addresses, FCIS_ADDR0 through FCIS_ADDR63. 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:

FCIS_GROUP
FCIS_FUNCT
FCIS_EIDOPT2
FCIS_EIDOPT3
FCIS_EIDOPT4
FCIS_BITS1
FCIS_BITS2
FCIS_BITS3
FCIS_BITS4
FCIS_BITS5
FCIS_BITS6
FCIS_BITS7
FCIS_BITS8

FCIS_GROUP

Always X'4C', indicating that this is a file control SPI request.

FCIS_FUNCT

One byte that defines the type of request:

X'02': INQUIRE FILE
X'04': SET FILE.

FCIS_EIDOPT2

Not used by file control.

FCIS_EIDOPT3

Not used by file control.

FCIS_EIDOPT4

Not used by file control.

FCIS_BITS1

Existence bits which specify which arguments were specified. To obtain the argument associated with a keyword, you need to obtain the appropriate address from the command-level parameter structure. Before using this address you must check the associated existence bit. If the existence bit is set off, the argument was not specified in the request and the address should not be used.

X'80': Set if the request contains an argument for the FILE keyword. If set, FCIS_ADDR1 is meaningful.
X'40': Set if the request contains an argument for the DSNAME keyword. If set, FCIS_ADDR2 is meaningful.
X'20': Set if the request contains an argument for the FWDRECSTATUS keyword. If set, FCIS_ADDR3 is meaningful.
X'10': Set if the request contains an argument for the STRINGS keyword. If set, FCIS_ADDR4 is meaningful.
X'08': Set if the request contains an argument for the BASEDSNAME keyword. If set, FCIS_ADDR5 is meaningful.
X'04': Set if the request contains an argument for the LSRPOOLID keyword. If set, FCIS_ADDR6 is meaningful.
X'02': Set if the request contains an argument for the READ keyword. If set, FCIS_ADDR7 is meaningful.
X'01': Set if the request contains an argument for the UPDATE keyword. If set, FCIS_ADDR8 is meaningful.

FCIS_BITS2

Existence bits which specify which arguments were specified. The comments for FCIS_BITS1 also apply to FCIS_BITS2.

X'80': Set if the request contains an argument for the BROWSE keyword. If set, FCIS_ADDR9 is meaningful.
X'40': Set if the request contains an argument for the ADD keyword. If set, FCIS_ADDR10 is meaningful.
X'20': Set if the request contains an argument for the DELETE keyword. If set, FCIS_ADDR11 is meaningful.
X'10': Set if the request contains an argument for the DISPOSITION keyword. If set, FCIS_ADDR12 is meaningful.
X'08': Set if the request contains an argument for the EMPTYSTATUS keyword. If set, FCIS_ADDR13 is meaningful.
X'04': Set if the request contains an argument for the OPENSTATUS keyword. If set, FCIS_ADDR14 is meaningful.
X'02': Set if the request contains an argument for the ENABLESTATUS keyword. If set, FCIS_ADDR15 is meaningful.
X'01': Set if the request contains an argument for the RECOVSTATUS keyword. If set, FCIS_ADDR16 is meaningful.

FCIS_BITS3

Existence bits which specify which arguments were specified. The comments for FCIS_BITS1 also apply to FCIS_BITS3.

X'80': Set if the request contains an argument for the ACCESSMETHOD keyword. If set, FCIS_ADDR17 is meaningful.
X'40': Set if the request contains an argument for the TYPE keyword. If set, FCIS_ADDR18 is meaningful.
X'20': Set if the request contains an argument for the OBJECT keyword. If set, FCIS_ADDR19 is meaningful.
X'10': Set if the request contains an argument for the REMOTESYSTEM keyword. If set, FCIS_ADDR20 is meaningful.
X'08': Set if the request contains an argument for the REMOTENAME keyword. If set, FCIS_ADDR21 is meaningful.
X'04': Set if the request contains an argument for the RECORDFORMAT keyword. If set, FCIS_ADDR22 is meaningful.
X'02': Set if the request contains an argument for the BLOCKFORMAT keyword. If set, FCIS_ADDR23 is meaningful.
X'01': Set if the request contains an argument for the KEYLENGTH keyword. If set, FCIS_ADDR24 is meaningful.

FCIS_BITS4

Existence bits which specify which arguments were specified. The comments for FCIS_BITS1 also apply to FCIS_BITS4.

X'80': Set if the request contains an argument for the KEYPOSITION keyword. If set, FCIS_ADDR25 is meaningful.
X'40': Set if the request contains an argument for the RECORDSIZE keyword. If set, FCIS_ADDR26 is meaningful.
X'20': Set if the request contains an argument for the RELTYPE keyword. If set, FCIS_ADDR27 is meaningful.
X'10': Set if the request contains an argument for the EXCLUSIVE keyword. If set, FCIS_ADDR28 is meaningful.
X'08': Set if the request contains an argument for the BLOCKKEYLEN keyword. If set, FCIS_ADDR29 is meaningful.
X'04': Set if the request contains an argument for the BLOCKSIZE keyword. If set, FCIS_ADDR30 is meaningful.
X'02': Not used by file control.
X'01': Not used by file control.

FCIS_BITS5

Existence bits which specify which arguments were specified. The comments for FCIS_BITS1 also apply to FCIS_BITS5.

X'80': Set if the request contains an argument for the TABLE keyword. If set, FCIS_ADDR33 is meaningful.
X'40': Set if the request contains an argument for the MAXNUMRECS keyword. If set, FCIS_ADDR34 is meaningful.
X'20': Set if the request contains an argument for the READINTEG keyword. If set, FCIS_ADDR35 is meaningful.
X'10': Set if the request contains an argument for the RLSACCESS keyword. If set, FCIS_ADDR36 is meaningful.
X'08': Set if the request contains an argument for the DEFINESOURCE keyword. If set, FCIS_ADDR37 is meaningful.
X'04': Set if the request contains an argument for the INSTALLAGT keyword. If set, FCIS_ADDR38 is meaningful.
X'02': Set if the request contains an argument for the INSTALLUSR keyword. If set, FCIS_ADDR39 is meaningful.
X'01': Set if the request contains an argument for the CHANGEAGENT keyword. If set, FCIS_ADDR40 is meaningful.

FCIS_BITS6

Specifies whether certain keywords were specified on the File control SPI command.

X'80': Set if the request contains the START keyword.
X'40': Set if the request contains the NEXT keyword.
X'20': Set if the request contains the END keyword.
X'10': Set if the request contains the WAIT keyword.
X'08': Set if the request contains the NOWAIT keyword.
X'04': Set if the request contains the FORCE keyword.
X'02': Set if the request contains the ENABLED keyword.
X'01': Set if the request contains the DISABLED keyword.

FCIS_BITS7

Specifies whether certain keywords were specified on the File control SPI command. Also contains the existence bit for JOURNALNUM.

X'80': Set if the request contains the OPEN keyword.
X'40': Set if the request contains the CLOSED keyword.
X'20': Set if the request contains the EMPTY keyword.
X'10': Set if the request contains an argument for the JOURNALNUM keyword. If set, FCIS_ADDR52 is meaningful.
X'08': Set if the request contains the LOADTYPE keyword.
X'04': Set if the request contains the POOL keyword.
X'02': Set if the request contains the TABLENAME keyword.
X'01': Set if the request contains the UPDATEMODEL keyword.

FCIS_BITS8

X'80': Set if the request contains the REMOTETABLE keyword.
X'40': Not used by file control.
X'20': Set if the request contains an argument for the CHANGEUSRID keyword. If set, FCIS_ADDR59 is meaningful.
X'10': Set if the request contains an argument for the CHANGEAGREL keyword. If set, FCIS_ADDR60 is meaningful.
X'08': Set if the request contains an argument for the DEFINETIME keyword. If set, FCIS_ADDR61 is meaningful.
X'04': Set if the request contains an argument for the CHANGETIME keyword. If set, FCIS_ADDR62 is meaningful.
X'02': Set if the request contains an argument for the INSTALLTIME keyword. If set, FCIS_ADDR63 is meaningful.
X'01': Not used by file control.

FCIS_ADDR1

is the address of an 8-byte area containing the name from FILE.

FCIS_ADDR2

is the address of a 44-byte area containing the name from DSNAME.

FCIS_ADDR3

is the address of a 4-byte area containing the CVDA from FWDRECOVSTATUS.

FCIS_ADDR4

is the address of a 4-byte area containing the data from STRINGS.

FCIS_ADDR5

is the address of a 44-byte area containing the name from BASEDSNAME.

FCIS_ADDR6

is the address of a 4-byte area containing the data from LSRPOOLID.

FCIS_ADDR7

is the address of a 4-byte area containing the CVDA from READ.

FCIS_ADDR8

is the address of a 4-byte area containing the CVDA from UPDATE.

FCIS_ADDR9

is the address of a 4-byte area containing the CVDA from BROWSE.

FCIS_ADDR10

is the address of a 4-byte area containing the CVDA from ADD.

FCIS_ADDR11

is the address of a 4-byte area containing the CVDA from DELETE.

FCIS_ADDR12

is the address of a 4-byte area containing the CVDA from DISPOSITION.

FCIS_ADDR13

is the address of a 4-byte area containing the CVDA from EMPTYSTATUS.

FCIS_ADDR14

is the address of a 4-byte area containing the CVDA from OPENSTATUS.

FCIS_ADDR15

is the address of a 4-byte area containing the CVDA from ENABLESTATUS.

FCIS_ADDR16

is the address of a 4-byte area containing the CVDA from RECOVSTATUS.

FCIS_ADDR17

is the address of a 4-byte area containing the CVDA from ACCESSMETHOD.

FCIS_ADDR18

is the address of a 4-byte area containing the CVDA from TYPE.

FCIS_ADDR19

is the address of a 4-byte area containing the CVDA from OBJECT.

FCIS_ADDR20

is the address of a 4-byte area containing the name from REMOTESYSTEM.

FCIS_ADDR21

is the address of an 8-byte area containing the name from REMOTENAME.

FCIS_ADDR22

is the address of a 4-byte area containing the CVDA from RECORDFORMAT.

FCIS_ADDR23

is the address of a 4-byte area containing the CVDA from BLOCKFORMAT.

FCIS_ADDR24

is the address of a 4-byte area containing the CVDA from KEYLENGTH.

FCIS_ADDR25

is the address of a 4-byte area containing the data from KEYPOSITION.

FCIS_ADDR26

is the address of a 4-byte area containing the data from RECORDSIZE.

FCIS_ADDR27

is the address of a 4-byte area containing the CVDA from RELTYPE.

FCIS_ADDR28

is the address of a 4-byte area containing the CVDA from EXCLUSIVE.

FCIS_ADDR29

is the address of a 4-byte area containing the data from BLOCKKEYLEN.

FCIS_ADDR30

is the address of a 4-byte area containing the data from BLOCKSIZE.

FCIS_ADDR31

is not used by file control.

FCIS_ADDR32

is the address of a 4-byte area containing the data from BUSY.

FCIS_ADDR33

is the address of a 4-byte area containing the CVDA from TABLE.

FCIS_ADDR34

is the address of a 4-byte area containing the data from MAXNUMRECS.

FCIS_ADDR35

is the address of a 4-byte area containing the CVDA from READINTEG.

FCIS_ADDR36

is the address of a 4-byte area containing the CVDA from RLSACCESS.

FCIS_ADDR37

is the address of a 8-byte area containing the data from DEFINESOURCE.

FCIS_ADDR38

is the address of a 4-byte area containing the CVDA from INSTALLAGENT.

FCIS_ADDR39

is the address of a 8-byte area containing the data from INSTALLUSRID.

FCIS_ADDR40

is the address of a 4-byte area containing the CVDA from CHANGEAGENT.

FCIS_ADDR41 to FCIS_ADDR51

are not used by file control.

FCIS_ADDR52

is the address of a 4-byte area containing the data from JOURNALNUM.

FCIS_ADDR53

is the address of a 4-byte area containing the data from LOADTYPE.

FCIS_ADDR54

is the address of a 4-byte area containing the data from CFDTPOOL.

FCIS_ADDR55

is the address of a 4-byte area containing the data from TABLENAME.

FCIS_ADDR56

is the address of a 4-byte area containing the data from UPDATEMODEL.

FCIS_ADDR57

is the address of a 4-byte area containing the data from REMOTETABLE.

FCIS_ADDR58

is the address of a 4-byte area containing the CVDA from RBATYPE.

FCIS_ADDR59

is the address of a 8-byte area containing the data from CHANGEUSRID.

FCIS_ADDR60

is the address of a 4-byte area containing the data from CHANGEAGREL.

FCIS_ADDR61

is the address of a 8-byte area containing the data from DEFINETIME.

FCIS_ADDR62

is the address of a 8-byte area containing the data from CHANGETIME.

FCIS_ADDR63

is the address of a 8-byte area containing the data from INSTALLTIME.