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.

EQQUSINO parameters
 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.
Note: 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 first 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:
  1. The operation has priority 9.
  2. Earliest latest start time.
  3. Priority 8-1.
  4. Input arrival time specified for the operation or the occurrence input arrival if the operation does not have input arrival specifically defined.
  5. 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.