APPOBJ - object section
This section identifies the event type you want to report to HCL Workload Automation for Z. 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 HCL Workload Automation for Z.
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.