APPOBJ - object section
This section identifies the event type you want to report to IBM Z Workload Scheduler. The EQQUSIN buffer must contain an object section. It can contain more than one object section, but all object sections must be in contiguous storage; that is, they must follow one another. The part of the buffer containing object sections is pointed to by the APP_OBJ_TRIPLET in the fixed section. APPOBJ itself points to APPSEL, APPFLD, and APPDAT sections.
The object section has this format:
| Offsets | Type | Len | Name | Description | |
|---|---|---|---|---|---|
| Dec | Hex | ||||
|
0 |
(0) |
STRUCTURE |
84 |
APPOBJ |
OBJECT SECTION |
|
0 |
(0) |
24 |
APPOBJ_ID |
OBJECT IDENTIFIER |
|
|
0 |
(0) |
CHARACTER |
16 |
APPOBJ_NAME |
OBJECT NAME |
|
16 |
(10) |
CHARACTER |
8 |
APPOBJ_KEY_TYPE |
KEY TYPE |
|
24 |
(18) |
12 |
APPOBJ_FLD_TRIPLET |
FIELD SECTION TRIPLET | |
|
24 |
(18) |
SIGNED |
4 |
APPOBJ_FLD_OFF |
OFFSET TO FIRST FIELD SECTION |
|
28 |
(1C) |
SIGNED |
4 |
APPOBJ_FLD_LEN |
LENGTH OF ALL FIELD SECTIONS |
|
32 |
(20) |
SIGNED |
4 |
APPOBJ_FLD_NBR |
NUMBER OF FIELD SECTIONS |
|
36 |
(24) |
12 |
APPOBJ_SEL_TRIPLET |
SELECTION SECTION TRIPLET | |
|
36 |
(24) |
SIGNED |
4 |
APPOBJ_SEL_OFF |
OFFSET TO FIRST SELECTION SECTION |
| 40 | (28) | SIGNED | 4 | APPOBJ_SEL_LEN | LENGTH OF A SINGLE SELECTION SECTION |
| 44 | (2C) | SIGNED | 4 | APPOBJ_SEL_NBR | NUMBER OF SELECTION SECTIONS |
| 48 | (30) | 12 | APPOBJ_DAT_TRIPLET | DATA SECTION TRIPLET | |
| 48 | (30) | SIGNED | 4 | APPOBJ_DAT_OFF | OFFSET TO FIRST DATA SECTION |
| 52 | (34) | SIGNED | 4 | APPOBJ_DAT_LEN | LENGTH OF ALL DATA SECTIONS |
| 56 | (38) | SIGNED | 4 | APPOBJ_DAT_NBR | NUMBER OF DATA SECTIONS |
| 60 | (3C) | CHARACTER | 8 | APPOBJ_TYPE | DIALOG DATA TYPE (CREATE for EQQUSIN) |
| 68 | (44) | SIGNED | 4 | APPOBJ_RET | OBJECT LEVEL RETURN CODE |
| 72 | (48) | SIGNED | 4 | APPOBJ_RSN | OBJECT LEVEL REASON CODE |
| 76 | (4C) | CHARACTER | 8 | APPOBJ_AUTH | RACF® AUTHORITY (READ or UPDATE) |
- APPOBJ_NAME
- Is the event type you want to report
to IBM Z Workload Scheduler.
You
can specify these object names:
- CP_OPER_EVENT
- Current® plan operation status. This is equivalent to the OPSTAT TSO command.
- CP_OPINFO_EVENT
- Current® plan operation user data. This is equivalent to the OPINFO TSO command.
- CP_SR_EVENT
- Current® plan special resource. This is equivalent to the SRSTAT TSO command.
- BACKUP_EVENT
- Backup request. This is equivalent to the BACKUP TSO command.
- CP_WS_EVENT
- Current® plan workstation. This is equivalent to the WSSTAT TSO command.
- APPOBJ_KEY_TYPE
- Is the key type, which must be SAME for EQQUSIN. If you set this field to blanks (X'40'), SAME is used by default.
- APPOBJ_FLD_TRIPLET
- Contains the offset to the first APPFLD section, the length of each section, and the number of sections. Set these fields to binary zeros (X'00') when the object is BACKUP_EVENT.
- APPOBJ_SEL_TRIPLET
- Contains the offset to the first APPSEL section, the length of a single section, and the number of sections.
- APPOBJ_DAT_TRIPLET
- Contains the offset to the first APPDAT section, the length of all sections, and the number of sections. Set these fields to binary zeros (X'00') when the object is BACKUP_EVENT.
- APPOBJ_TYPE
- Is the request type. Only CREATE is valid for EQQUSIN. If you set this field to blanks (X'40'), you must specify CREATE in the APP_TYPE field of the fixed section.
- APPOBJ_RET
- In the call to EQQUSIN, set this field to binary zeros (X'00'). No return code is generated in the object section for a CREATE request.
- APPOBJ_RSN
- In the call to EQQUSIN, set this field to binary zeros (X'00'). No reason code is generated in the object section for a CREATE request.
- APPOBJ_AUTH
- Set this field to blanks (X'40') in the call to EQQUSIN. It is not updated for a CREATE request.