This documentation describes the operator commands that can be entered on the operator console to control and display Entire Systems Management Adapter activities.
This document covers the following topics:
The following command format is required to communicate with the Entire Systems Management Adapter via the operator console. Note that parameters in uppercase must be typed as is. Parameters in italics must be substituted with a valid value.
/INTR tsn,command parameter
where:
tsn
|
is the task sequence number of the Entire Systems Management Adapter main task (with loaded module ESAMAIN, unless otherwise stated). |
command
|
is the operator command keyword. |
parameter
|
is a parameter that allows you to issue an operator command for selected items. |
In the syntax diagrams that follow, parameters in italics are variables that must be substituted with a real value, for example, a name. If more than one parameter appears, only one may be specified.
In the examples, only the command and parameter keywords are described. You must supply the other command operands as appropriate to the operating system.
Command | Parameter |
---|---|
ABS
|
Displays the total size, the number of bytes in use and the number of free bytes in the attached buffer pool on the console.
ESY4001I 00117 Operator command: ABS. ESA2182I 00117 Attached buffer usage. ESA2182I 00117 0000409600 bytes total. ESA2182I 00117 0000004096 bytes used. ESA2182I 00117 0000004096 bytes used HWM. ESA2182I 00117 0000405504 bytes free.
Command | Parameter |
---|---|
ADAEND
|
No more processing takes place. Existing calls to the Entire Systems Management Adapter are allowed to finish, but new calls are rejected. Processing ends after the last call has finished.
Command | Parameter |
---|---|
CANCEL
|
|
Cancels the specified user in the Entire Systems Management Adapter session(s).
To cancel the user ITSME
from the Entire
Systems Management Adapter subtask XCOM148
, enter the following
command in the operator console:
CANCEL USER=ITSME
This way you cancel all active sessions with the
Entire Systems Management Adapter for user ITSME
.
The following command cancels the one specific session for a user:
CANCEL ID=nnnn
where nnnn
is the
corresponding Entire Systems Management Adapter ID retrievable using the view
NATPROC-USERS
, or via the operator command:
USERS userid
Command | Parameter |
---|---|
ESAEND
|
No more processing takes place. Existing calls to the Entire Systems Management Adapter are allowed to finish, but new calls are rejected. Processing ends after the last call has finished
Command | Parameter |
---|---|
FILES
|
The FILES
command creates a list of
all open files per user in this server task. It is supported in the server
tasks (with loaded module ESASERV
), therefore the TSN of the
server task has to be used.
/INTR 9083,files " --> FROM USER TSOS" ESA4001I 00113 Operator typed in: FILES. ESA2173I 00113 USER ESY-ID ACT VIEW DSNAME. ESA2173I 00113 -------- ------ --- ---- ------------------------------------ ESA2173I 00113 DC1 0004 N 2 :NAT:$DC1.P.NRTvrs.3932. ESA2173I 00113 TSOS 0003 N 2 :CIS:$NETWORK.WCP.SRC.
If no files are open, the following message is displayed:
/INTR 9083,files " --> FROM USER TSOS" ESA4001I 00113 Operator typed in: FILES. ESA2174I 00113 Nothing found for this request.
Command | Parameter |
---|---|
SERVER-DYN
|
YES
|
NO
|
Activates or deactivates dynamic server support.
Command | Parameter |
---|---|
SERVER-MIN
|
nn
|
Sets the SERVER-MIN
parameter to the
specified value. nn
must be less than
SERVER-MAX
.
Command | Parameter |
---|---|
SERVER-MAX
|
nn
|
Sets the SERVER-MAX
parameter to the
specified value. nn must be more than
SERVER-MIN
.
Command | Parameter |
---|---|
SERVERS
|
Displays information about current server load.
Command | Parameter |
---|---|
TCP
|
Displays all TCP/IP connections to Entire Systems Management Adapter.
/INTR 8056,TCP "issued by user TSOS" ESY4001I 00117 Operator command: TCP. ESY2181I 00117 TCP/IP Connections. ESY2181I 00117 SD STATUS IDLE USER PEER ADDRESS ESY2181I 00117 ----- -------- ------ -------- ------------ ESY2181I 00117 1 ACTIVE 0 TSOS 10.22.132.98
Command | Parameter |
---|---|
TRACE
|
YES
|
NO
|
Activates or deactivates trace if Entire Systems Management
Adapter was started with TRACE=PREP
or TRACE=YES
.
Command | Parameter |
---|---|
USERS
|
userid
|
Displays the specified user ID as a message on the console. Without the userid parameter, a list of all users is displayed. You can also specify a prefix followed by an asterisk * to select those user IDs starting with that prefix.
The following command displays user ITSME
:
USERS ITSME
The following command displays all users whose IDs begin with SAG:
USERS SAG*