Modifying fields in the command-level parameter structure by exits XTSEREQ and XTSEREQC
Some fields that are passed to temporary storage 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.
Input and output fields
- Input fields
-
The following are always input fields:
- QUEUE|QNAME
- FROM
- SYSID
- Output fields
-
The following are always output fields:
- INTO
- NUMITEMS
- SET
- Fields used for both input and output
-
LENGTH is an input field on a WRITEQ request, and an output field on a READQ request that specifies SET. It is both an input and an output field on a READQ request that specifies INTO.
ITEM is an input field on a READQ request, and on a WRITEQ request that specifies REWRITE. It is both an input and an output field on a WRITEQ request that does not specify REWRITE.
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-level parameter list to point to your new data.
Do not modify an input field by altering the data that is pointed to by the command-level parameter list. To do so would corrupt storage belonging to the application program and would 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.