Selecting an operation to change the status (CP_OPER_EVENT)
You can specify these fields to identify a current plan operation for which you want to change the status:
Field | Type | Size | Description |
---|---|---|---|
SUBSYSTEM_NAME | CHAR | 4 | Subsystem name |
WS_NAME | CHAR | 4 | Workstation name |
JOBNAME | CHAR | 8 | Job name |
APPL_ID | CHAR | 16 | Application ID |
OPER_NUM | BIN | 15 | Operation number |
APPL_IA_DATE | CHAR | 6 | Input arrival date (YYMMDD) |
APPL_IA_TIME | CHAR | 4 | Input arrival time (HHMM) |
FORM_NUMBER | CHAR | 8 | Form number |
CLASS | CHAR | 1 | SYSOUT class |
OPER_TOKEN | CHAR | 8 | Operation token |
- SUBSYSTEM_NAME
- The name of the tracker subsystem that the event should be reported to. If SUBSYSTEM_NAME is not specified or has the value MSTR, the event is broadcast using the subsystem interface (SSI) to all HCL Workload Automation for Z subsystems on the z/OS image where EQQUSIN is invoked.
- WS_NAME
- The name of the workstation.
- JOBNAME
- The name of the job that an event is being reported for.
- APPL_ID
- The name of the current application.
- OPER_NUM
- The number, in binary format, of the current operation. The number can have a decimal value from 1 to 255.
- APPL_IA_DATE
- The input arrival date of the current occurrence in the format YYMMDD.
- APPL_IA_TIME
- The input arrival time of the current occurrence in the format HHMM.
- FORM_NUMBER
- Contains the printer form number for operations at printer workstations.
- CLASS
- Contains the SYSOUT class for operations at printer workstations.
- OPER_TOKEN
- A hexadecimal value that uniquely identifies an operation. If
you stored the token set in the OPCTOKEN parameter of the operation-initiation
exit (EQQUX009), you can provide this token to EQQUSIN to uniquely
identify the operation. OPER_TOKEN is valid only for operations at
workstations that have a user-defined destination. Note: As the OPCTOKEN is defined as a full-word, the OPER_TOKEN should be typed in as follows:
FIRST WORD = X'00000000' SECOND WORD = OPCTOKEN FROM EXIT EQQUX009
- You must specify at least OPER_TOKEN, or WS_NAME with either JOBNAME or APPL_ID.
- If you do not provide enough information to uniquely identify
the operation, HCL Workload Automation for Z must
determine the most applicable operation to update. HCL Workload Automation for Z considers
only operations in status R, A, *, S, I, or E when selecting the operation. HCL Workload Automation for Z selects
the operation to update by investigating these characteristics in
the stated order:
- The operation has priority 9.
- Earliest latest start time.
- Priority 8-1.
- Input arrival time specified for the operation or the occurrence input arrival if the operation does not have input arrival specifically defined.
So from the operations that match the selection criteria, the operation with priority 9 is updated. If more than one operation has priority 9, the operation with the earliest latest start time is updated. If latest start is equal, the operation with the highest priority is updated. If priority is equal, the operation with the earliest input arrival time is updated. If input arrival is also equal, the update is performed on a first-in-first-out basis.