EQQUSINT parameters
The calling program must pass all these parameters to the subroutine. Initialize RETCODE to zero in the call; it is set by EQQUSINT in the return.
EQQUSINT parameters
TYPE DS CL1 (Event type)
WSNAME DS CL4 (Workstation name)
JOBNAME DS CL8 (Job name)
ADID DS CL16 (Name of current application)
OPNUM DS H (Operation number)
OCIA DS CL10 (Input arrival of current occurrence, YYMMDDHHMM)
OPDUR DS CL4 (Operation duration, HHMM)
OPERR DS CL4 (Error code)
FORM DS CL8 (SYSOUT form number)
SCLASS DS CL1 (SYSOUT class)
SUBSYS DS CL4 (Subsystem name)
EVTIME DS F (Event time, 100*secs)
EVDATE DS CL4 (Event date, 0nYYDDDF)
RETCODE DS F (EQQUSINT return code)
- TYPE
- Defines the reason that EQQUSINT is called. The following values are valid:
- C
- Set the status of the operation to complete.
- E
- Set the status of the operation to ended-in-error.
- I
- Set the status of the operation to interrupted.
- Q
- Set the extended status of a started operation to Q to indicate that the operation is queued awaiting execution.
- S
- Set the status of the operation to started.
- T
- Set the extended status of a started operation to S to indicate that the operation is executing.
- X
- Reset the current status for this operation.
- WSNAME
- Name of the workstation.
- JOBNAME
- Name of the job that an event is being reported for.
- ADID
- Name of the current application.
- OPNUM
- Number, in hexadecimal format, of the current operation. You can specify 0000 or a number in the range 0001 to 00FF (decimal 1 to 255).
- OCIA
- Input arrival date and time of the current occurrence.
- OPDUR
- Duration, in hours and minutes, of an operation that is reported as complete. The operation duration cannot be 0000. If you set it to 0000 (0 hours, 0 minutes), a default duration value of 1 minute is used instead.
- OPERR
- Error code for an operation that is reported as ended-in-error.
- FORM
- Printer form name for operations at printer workstations.
- SCLASS
- SYSOUT class for operations at printer workstations.
- SUBSYS
- 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 EQQUSINT is invoked.
- EVTIME
- Time of the event that is being reported. If the field contains all binary zeros, HCL Workload Automation for Z uses the current time.
- EVDATE
- Date of the event that is being reported. If the field contains all binary zeros, HCL Workload Automation for Z uses the current date. If n = 0, year is 19YY. If n = 1, year is 20YY.
- RETCODE
- Is set by EQQUSINT and can have one of the following 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 EQQUSINT, and no event has been reported to HCL Workload Automation for Z.
Note:
- You must specify valid values for the TYPE and WSNAME parameters and either the JOBNAME or ADID parameters. The remaining values can be initialized to zeros or blanks.
- OPDUR is processed only if TYPE has value C.
- OPERR is processed only if TYPE has value E.
- If you do not provide enough information to uniquely identify the operation and HCL Workload Automation for Z finds more than one operation that
matches the criteria you specified, HCL Workload Automation for Z determines the most applicable operation
to update. HCL Workload Automation for Z chooses the most
applicable operation 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.