The UEPCLPS exit-specific parameter
The UEPCLPS exit-specific parameter is the address of the command-level parameter structure, and is included in exits XPCREQ and XPCREQC.
The command-level parameter structure contains 11 addresses, PC_ADDR0 through PC_ADDRA. It is defined in the DSECT PC_ADDR_LIST, which you should copy into your exit program by including the statement COPY DFHPCEDS.
The command-level parameter list is made up as follows:
- PC_ADDR0
- is the address of a 7-byte area called the EXEC interface descriptor
(EID), which is made up as follows:
- PC_GROUP
- PC_FUNCT
- PC_BITS1
- PC_BITS2
- PC_EIDOPT4
- PC_EIDOPT5
- PC_EIDOPT6
- PC_GROUP
- Always X'0E', indicating that this is a program control request.
- PC_FUNCT
- One byte which defines the type of request, which for XPCREQ and XPCREQC is always X'02', indicating a LINK request.
- PC_BITS1
- Existence bits that define which keywords that contain values
were specified. To obtain the value associated with a keyword, you
need to use the appropriate address from the command-level parameter
list. Before using this address you must check the associated existence
bit to ensure that the address is valid. If the existence bit is set
off, the keyword was not specified in the request and the address
should not be used. The symbolic and hexadecimal values of the existence
bits are as follows:
- PC_EXIST1 (X'80 ')
- Set if the request contains the keyword PROGRAM. If set, PC_ADDR1 is meaningful. (This bit should always be set for a LINK request.)
- PC_EXIST2 (X'40 ')
- Set if the request specifies the COMMAREA parameter. If set, PC_ADDR2 is meaningful.
- PC_EXIST3 (X'20 ')
- Set if the request specifies the LENGTH parameter. If set, PC_ADDR3 is meaningful.
- PC_EXIST4 (X'10 ')
- Set if the request specifies the INPUTMSG parameter. If set, PC_ADDR4 is meaningful.
- PC_EXIST5 (X'08 ')
- Set if the request specifies the INPUTMSGLEN parameter. If set, PC_ADDR5 is meaningful.
- PC_EXIST6 (X'04 ')
- Set if the request specifies the DATALENGTH parameter. If set, PC_ADDR6 is meaningful.
- PC_EXIST7 (X'02 ')
- Set if the request specifies the SYSID parameter. If set, PC_ADDR7 is meaningful.
- PC_EXIST8 (X'01 ')
- Set if the request specifies the TRANSID parameter. If set, PC_ADDR8 is meaningful.
- PC_BITS2
- One byte containing one of the following values:
- PC_EXIST9 (X'80')
- Not used.
- PC_EXISTA (X'40')
- Set if the request specifies the CHANNEL parameter. If set, PC_ADDRA is meaningful.
- PC_EIDOPT4
- Not used by program control.
- PC_EIDOPT5
- Not used by program control.
- PC_EIDOPT6
- Indicates whether the request specifies the SYNCONRETURN option. If it does, X'80' is set.
- PC_ADDR1
- is the address of an 8-byte area containing the program name from the PROGRAM parameter.
- PC_ADDR2
- is the address of the COMMAREA data.
- PC_ADDR3
- is the address of a 2-byte area containing the length of the COMMAREA, as a half-word binary value.
- PC_ADDR4
- is the address of the INPUTMSG data.
- PC_ADDR5
- is the address of a 2-byte area containing the length of the INPUTMSG, as a half-word binary value.
- PC_ADDR6
- is the address of a 2-byte area containing the length specified on the DATALENGTH parameter, defining how much data is to be sent from the COMMAREA. The length is held as a half-word binary value.
- PC_ADDR7
- is the address of the 4-byte name of the remote system the LINK request is to be shipped to, as specified on the SYSID parameter.
- PC_ADDR8
- is the address of the 4-byte name of the mirror transaction to be attached in the remote system, as specified on the TRANSID parameter.
- PC_ADDR9
- is not used.
- PC_ADDRA
- is the address of the 16-byte channel name, as specified on the CHANNEL parameter.