IBM SC34-6814-04 Server User Manual


 
PC_ADDRA
is the address of the 16-byte channel name, as specified on the CHANNEL
parameter.
Modifying fields in the command parameter structure: Some fields that are
passed to program control are used as input to the request, some are used as
output fields, and some are used for both input and output. The method your user
exit program uses to modify a field depends on the usage of the field.
Modifying input fields: The correct method of modifying an input field is to create a
new copy of it, and to change the address in the command parameter list to point to
your new data.
Note: You must never modify an input field by altering the data that is pointed to by
the command parameter list. To do so would corrupt storage belonging to the
application program and could cause a failure when the program attempted
to reuse the field.
Modifying output fields: The technique described in “Modifying input fields” is not
suitable for modifying output fields. (The results would be returned to the new area
instead of the application’s area, and would be invisible to the application.)
An output field is modified by altering the data that is pointed to by the
command-level parameter list. In the case of an output field you can modify the
application’s data in place, because the application is expecting the field to be
modified anyway.
Modifying the EID: It is not possible to modify the EID to make major changes to
requests. It is not possible, for example, to change a LINK request to a different
type of Program Control request.
However, you can make minor changes to requests, such as to turn on the
existence bit for SYSID so that the request can be changed into one that is shipped
to a remote system.
The list that follows shows the bits in the EID that can be modified. Any attempt to
modify any other part of the EID is ignored.
PC_BITS1
X'40' The existence bit for the COMMAREA
X'20' The existence bit for LENGTH
X'10' The existence bit for INPUTMSG
X'08' The existence bit for INPUTMSGLEN
X'04' The existence bit for DATALENGTH
X'02' The existence bit for SYSID
X'01' The existence bit for TRANSID.
PC_BITS2
X'40' The existence bit for CHANNEL.
PC_EIDOPT5
Not used for a PC link request.
184 Customization Guide