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:

• Command Syntax

• Command Descriptions

---

Command Syntax

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.

Command Descriptions

Syntax Conventions

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.

• ABS
• ADAEND
• CANCEL
• ESAEND
• FILES
• SERVER-DYN
• SERVER-MIN
• SERVER-MAX
• SERVERS
• TCP
• TRACE
• USERS

ABS

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.

Sample Output:

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.

ADAEND

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.

CANCEL

Command	Parameter
CANCEL	USER=userid ID=sessionid

Cancels the specified user in the Entire Systems Management Adapter session(s).

Examples:

• 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

ESAEND

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

FILES

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.

Example:

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

SERVER-DYN

Command	Parameter
SERVER-DYN	YES
	NO

Activates or deactivates dynamic server support.

SERVER-MIN

Command	Parameter
SERVER-MIN	nn

Sets the SERVER-MIN parameter to the specified value. nn must be less than SERVER-MAX.

SERVER-MAX

Command	Parameter
SERVER-MAX	nn

Sets the SERVER-MAX parameter to the specified value. nn must be more than SERVER-MIN.

SERVERS

Command	Parameter
SERVERS

Displays information about current server load.

TCP

Command	Parameter
TCP

Displays all TCP/IP connections to Entire Systems Management Adapter.

Example:

/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

TRACE

Command	Parameter
TRACE	YES
	NO

Activates or deactivates trace if Entire Systems Management Adapter was started with TRACE=PREP or TRACE=YES.

USERS

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.

Example:

• The following command displays user ITSME:

  USERS ITSME

• The following command displays all users whose IDs begin with SAG:

  USERS SAG*