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.


dfha335.html | Timestamp icon Last updated: Monday, 5 June 2017