Using EQQUSINT

You use EQQUSINT to request Tivoli Workload Scheduler for z/OS to change the status of an operation at a workstation. The workstation can be any type except a workstation with the nonreporting attribute.

Invocation requirements

EQQUSINT has these invocation requirements:

Authorization

APF authorized, or supervisor state, or PSW key 0–7.

Dispatchable unit mode

Task mode.

Amode

24-bit, or ANY if APAR PQ74854 was applied.

ASC mode

Primary or access register (AR).

Interrupt status

Enabled for I/O and external interrupts.

Locks

No locks held.

Control parameters

All parameters must be addressable by the caller and in the primary address space.

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.

 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. These 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

Is the name of the workstation.

JOBNAME

Is the name of the job that an event is being reported for.

ADID

Is the name of the current application.

OPNUM

Is the 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

Is the input arrival date and time of the current occurrence.

OPDUR

Is the duration, in hours and minutes, of an operation that is reported as complete.

OPERR

Is the error code for an operation that is reported as ended-in-error.

FORM

Contains the printer form name for operations at printer workstations.

SCLASS

Contains the SYSOUT class for operations at printer workstations.

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 Tivoli Workload Scheduler for z/OS subsystems defined on the z/OS system where EQQUSINT is invoked.

EVTIME

Contains the time of the event that is being reported. If the field contains all binary zeros, Tivoli Workload Scheduler for z/OS uses the current time.

EVDATE

Contains the date of the event that is being reported. If the field contains all binary zeros, Tivoli Workload Scheduler for z/OS 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 these values:

0

Normal return. The event has been reported to Tivoli Workload Scheduler for z/OS.

8

Error return. There is an error in the information that was passed to EQQUSINT, and no event has been reported to Tivoli Workload Scheduler for z/OS.