WSSTAT

The WSSTAT instruction invokes the TSO command WSSTAT, which you can use to change the status of a workstation in the current plan. You can also establish or close the connection of a workstation to the network. The status information is communicated to the Z controller to indicate a workstation as active, off-line, or failed. When you use the WSSTAT instruction to report a workstation status of offline or failed, you can optionally define restart and routing options for the workload defined on the workstation. You can also change the domain manager of a workstation.

Table 1 shows the keywords that can be used.

Table 1. Keywords used in the Wsstat Instruction
Keyword Requirement Description
ALTWS() OptionalThe alternate workstation name. When the workstation status is set to offline or failed, you can specify the alternate workstation where reroutable operations are to be started.
CMD()Optional When you want to change the workstation status, you can specify one of the following for CMD():
L
Link
P
Stop
S
Start
U
Unlink
MANAGES() Optional When you want to modify the domain manager of a workstation, you can specify the new domain manager with MANAGES().
REROUTE()OptionalWhen the workstation status is set to offline or failed, you can specify one of the following for REROUTE():
R
To reroute operations to the alternate workstation
L
To leave the operations at the inactive workstation
STARTOPR() Optional When the workstation status is set to offline or failed, you can specify what the scheduler is to do with operations that are currently in started status at the workstation:
R
Restart operations automatically on the alternate workstation.
E
Set all started operations to ended-in-error status
L
Leave the operations in started status.
STATUS()RequiredThe status you want to report for the workstation:
A
Active
O
Offline
F
Failed
TRACE()OptionalEvent tracing indicator. When a nonzero positive number is specified, a trace entry is created for each event generated by the WSSTAT command. The trace record is written to the message log file identified by ddname EQQMLOG. The record identifies the name of each receiving subsystem. The default value 0 will not generate trace records.
WSNAME()RequiredThe name of the workstation to be updated.
Examples: 
WSSTAT WSNAME(AS4H) STATUS(O) START(R)

In this example, the status of workstation AS4H is set to offline. Started operations will be restarted on the alternate workstation.

WSSTAT WSNAME(AS4H) SUBSYS(OPCC) MANAGES(DOMAIN1)

In this example, the workstation AS4H changes its domain manager to DOMAIN1

The WSSTAT instruction returns one of the following return codes:
RESULT = 0
Workstation status modified
RESULT = 8
Invalid instruction