Using EQQUSINW

You use EQQUSINW to generate a workstation status event for a particular workstation that specifies a user-defined destination. Workstation status events can be generated for active, failed, or offline conditions.

Invocation requirements

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

EQQUSINW parameters

The calling program must pass all these parameters to the subroutine. Any parameter except STATUS and WSNAME can be left blank. Initialize RC to zero in the call; it is set by EQQUSINW in the return.

 DUMMY     DS   CL8    (Reserved parameter, value ignored)
 WSNAME    DS   CL4    (Workstation name must be specified)
 STATUS    DS   CL1    (Workstation status)
 STARTOPS  DS   CL1    (Action for started operations or blank)
 REROUTE   DS   CL1    (Reroute indicator or blank)
 ALTWS     DS   CL4    (Alternate workstation name or blank)
 SUBSYS    DS   CL4    (Name of the tracker subsystem or blank)
 RC        DS   F      (EQQUSINW return code)

DUMMY

A parameter reserved for future use. Any value supplied is ignored by the subroutine.

WSNAME

The workstation name.

STATUS

The status you want reported for the workstation, where:

A

Active

O

Offline

F

Failed.

STARTOPS

When the workstation status is set to offline or failed, you can specify what Tivoli Workload Scheduler for z/OS should do with operations that are currently in started status on the destination, or workstation, where:

R

Restart operations automatically on the alternate workstation.

L

Leave the operations in started status.

E

Set all started operations to ended-in-error.

REROUTE

When the workstation status is set to offline or failed, you can specify R for operations to be rerouted to the alternate workstation or L for no rerouting; that is, you want to leave the operations at the inactive workstation.

ALTWS

When the workstation status is set to offline or failed, you can specify the alternate workstation where reroute operations should be started.

SUBSYS

The name of the tracker subsystem that this event should be reported to. If SUBSYS is blank, the event is broadcast to all tracker subsystems defined on the z/OS system where EQQUSINW is invoked.

RC

Is set by EQQUSINW 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 EQQUSINW, and no event has been reported to Tivoli Workload Scheduler for z/OS.