APPSEL - Selection section
This section identifies a particular field in an object. By specifying a field name and a comparison operator in APPSEL, you can limit the instances of the object that HCL Workload Automation for Z finds. APPSEL is pointed to by the APPOBJ_SEL_TRIPLET in its object section and must itself point to an APPVAL section where a selection value is specified. To identify one particular instance of an object, you might need to specify more than one APPSEL in the send buffer. The selection sections for a particular APPOBJ must be in contiguous storage.
If you do not specify APPSEL for a GET request, HCL Workload Automation for Z returns all instances of the object.
The selection section has this format:
Offsets | |||||
---|---|---|---|---|---|
Dec | Hex | Type | Len | Name | Description |
0 |
(0) |
STRUCTURE |
36 |
APPSEL |
SELECTION SECTION ADDRESS |
0 | (0) | CHARACTER | 16 | APPSEL_NAME | OBJECT FIELD NAME |
16 | (10) | CHARACTER | 2 | APPSEL_OPER | OPERATOR |
18 | (12) | CHARACTER | 10 | * | RESERVED |
28 | (1C) | SIGNED | 4 | APPSEL_VALUE_OFF | VALUE OFFSET |
32 | (20) | SIGNED | 4 | APPSEL_VALUE_LEN | VALUE LENGTH |
- APPSEL_NAME
- Is a field name in the object.
- APPSEL_OPER
- Is a comparison operator.
- *
- Offset 18 (X'12'). Set this reserved field to binary zeros (X'00').
- APPSEL_VALUE_OFF
- Is the offset to the APPVAL section.
- APPSEL_VALUE_LEN
- Is the length of the APPVAL section.
For more information, see Selecting object instances. Field names are described in API object fields.