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:

Table 1. APPFLD-Field Section
Offsets
Dec	Hex	Type	Len	Name	Description
0	(0)	STRUCTURE	24	APPFLD	FIELD SECTION ADDRESS OF FIRST FIELD SECTION FOR THIS OBJECT: APPFLD_PTR= ADDR(APP) + APPOBJ_FLD_OFF
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.

In the field section:

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.