EQQUSINO parameters
The calling program must pass all these parameters to the subroutine. If the OPINFOSCOPE keyword is IP, which is the default, WSNAME is a required parameter. If OPINFOSCOPE is ALL, you must specify valid values for either the ADID or JOBNAME parameters. The other parameters can be blank (zero for OPNUM). Initialize RC to zero in the call; it is set by EQQUSINO in the return.
WSNAME DS CL4 (Workstation name)
JOBNAME DS CL8 (Job name)
ADID DS CL16 (Name of current application)
OPNUM DS H (Operation number or zero)
OCIA DS CL10 (Occ input arrival, YYMMDDHHMM, or blank)
FORM DS CL8 (SYSOUT form number or blank)
CLASS DS CL1 (Job or SYSOUT class or blank)
SUBSYS DS CL4 (Name of the tracker or blank)
USERDATA DS CL16 (User data to feed back to the operation)
RC DS F (EQQUSINO return code)
- WSNAME
- Is the name of the workstation defined for the operation.
- JOBNAME
- Is the job name defined for the operation you want to update.
- ADID
- Is the application ID that contains the operation.
- OPNUM
- Is the number, in hexadecimal format, of the current operation. You can specify X'0000' or a number in the range X'0001' to X'00FF' (decimal 1 to 255).
- OCIA
- Is the input arrival date and time of the current occurrence.
- FORM
- Contains the printer form name for operations at printer workstations.
- CLASS
- Contains the job class or SYSOUT class defined for the operation.
- SUBSYS
- Is the name of the tracker subsystem that this event should be reported to. If SUBSYS is blank, the event is broadcast to all HCL Workload Automation for Z subsystems defined on the z/OS system where EQQUSINO is invoked.
- USERDATA
- Is the 16-character user-data information that is to be updated for the specified operation.
- RC
- Is
set by EQQUSINO and can have one of these values:
- 0
- Normal return. The event has been reported to HCL Workload Automation for Z.
- 8
- Error return. There is an error in the information that was passed to EQQUSINO; no event has been reported to HCL Workload Automation for Z.
- 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.
- Longest in Ready status.
So if you define only the WSNAME parameter and HCL Workload Automation for Z determines that there is more than one operation in the current plan for that workstation, 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 no match has been found for operations in status R, A, *, S, I, or E, HCL Workload Automation for Z uses the value of the OPINFOSCOPE keyword of JTOPTS to determine if operations in status C and W are also considered. OPINFOSCOPE can have the value IP (in progress) or ALL. Operations in status C and W are considered only if the value is ALL. The operation with the earliest latest-start-time is selected.