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.