APPFLD - Field section
For PUT and CREATE requests, each field section identifies a field in the selected object that you want to update; for example, the status of an operation in the current plan. APPFLD is not used for a CREATE request when the object name is BACKUP_EVENT, or for DEL requests.
For the GET request, you can use APPFLD sections to limit the data that is returned to particular object fields. You need supply only the APPFLD_NAME in a send buffer. HCL Workload Automation for Z updates the APPFLD_LEN and APPFLD_TYPE fields before the buffer is returned. If you do not specify APPFLD for a GET request, the buffer returned contains all fields in the selected instances of the object.
Field sections are pointed to by the APPOBJ_FLD_TRIPLET in the object section. You can specify more than one APPFLD for each APPOBJ, but all field sections for a particular APPOBJ must be in contiguous storage.
The field section has this format:
Offsets | |||||
---|---|---|---|---|---|
Dec | Hex | Type | Len | Name | Description |
0 |
(0) |
STRUCTURE |
24 |
APPFLD |
FIELD SECTION ADDRESS OF |
0 |
(0) |
CHARACTER |
16 |
APPFLD_NAME |
FIELD NAME |
16 |
(10) |
SIGNED |
4 |
APPFLD_LEN |
FIELD LENGTH |
20 |
(14) |
CHARACTER |
4 |
APPFLD_TYPE |
*FIELD DATA TYPE |
Note: Descriptions
prefixed with an asterisk (*) indicate fields that HCL Workload Automation for Z updates. |
- APPFLD_NAME
- The name of the field. For a description of the fields that you can specify for each object type, see Selecting object fields to update or retrieve.
- APPFLD_LEN
- The length of the field and is used in identifying the value in APPDAT for this field. For a GET request, or when the object is BACKUP_EVENT, set this field to binary zeros (X'00').
- APPFLD_TYPE
- The data type and is updated by HCL Workload Automation for Z before the buffer is returned. Set this field to blanks (X'40') in a send buffer.