HOME | UP | PREV | NEXT | PDF PAGE | PDF BOOK | SEARCH | GLOSSARY | CONTENTS
Entire System Server Version 3.1.2

Operator Commands

This documentation describes the operator commands that can be entered on the operator console to control and display Entire System Server activities.

This section covers the following topics:

• Command Syntax
• Command Descriptions

Command Syntax

The following command format is required to communicate with the Entire System Server via the operator console. Note that parameters in UPPERCASE must be typed as is. Parameters in italics must be substituted with a valid value.

OS/390:

F taskname, command parameter

where:

VSE/ESA:

MSG pt
  replid command parameter

where:

BS2000/OSD:

/INTR tsn,command parameter

where:

Command Descriptions

Syntax Conventions

In the syntax diagrams that follow, a parameter enclosed in curly braces {} are optional, 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.

ADAEND

No more processing takes place. Existing calls to the Entire System Server are allowed to finish, but new calls are rejected. Processing ends after the last call has finished.

If the startup parameter SHUTDOWN-MAX-DELAY is specified as non-zero, the Entire System Server tries to stop any available ESM monitor (EOM, EOR, ...) and waits for the monitors to shut down. New calls are not rejected until SHUTDOWN-MAX-DELAY time is elapsed. If all ESM monitors are stopped in the meantime, the deferred shutdown is not needed any longer and ADAEND will be executed.

CANCEL

Cancels the specified user in the Entire System Server address space.

Examples:

• To cancel the user ITSME from the Entire System Server subtask XCOM148, enter the following command in the operator console:
  
  

  CANCEL USER=ITSME

  cancels all active sessions with the Entire System Server for user ITSME.

• The following command cancels the one specific session for a user:
  
  

  CANCEL ID=nnnn

  where nnnn is the corresponding Entire System Server ID retrievable using the view NATPROC-USERS, or via the operator command:

  USERS userid

• To cancel all users originating from job name ESYSTART, enter the following command:
  
  

  CANCEL JOB=ESYSTART

SERVER-DYN

Activates or deactivates dynamic server support.

SERVER-MIN

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

SERVER-MAX

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

SERVERS

Displays information about current server load.

SHUTDOWN

The operator command SHUTDOWN is now supported to stop the monitors of Entire System Management products (ESM).

Using the above syntax, you can shutdown the monitors of Entire Operations (EOR), Entire Output Management (NOM), Entire Event Management (NCM) or all running monitors at a time (ALL or *).

START

"START ALL" (re)starts the initial SAT task to run ESM monitors.
Command is rejected if the SAT environment is still active.

Issue command "SHUTDOWN ALL" to stop SAT environment.

TAPES

Display tape units allocated to the Entire System Server.

TAPEFREE

Free tape units allocated to the Entire System Server.

Example:

• The following command frees the tape allocated to DDNAME MYTAPE:
  
  

  TAPEFREE MYTAPE

• The following command frees all tapes allocated to the Entire System Server session:
  
  

  TAPEFREE ALL

USERS

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*

VSAM

Display open VSAM files.

VSAMFREE

Free VSAM files.

Example:

• The following command frees VSAM file allocated to DDNAME MYFILE:
  
  

  VSAMFREE MYFILE

• The following command frees all VSAM files allocated to the Entire System Server session:
  
  

  VSAMFREE ALL

XCANCEL

Processing stops immediately and a dump is created. Existing calls to the Entire System Server are not allowed to finish.

XCQES

The number of Command Queue Elements currently active is displayed. The highest number of currently active CQES is also shown.

XHALT

New calls to the Entire System Server are temporarily rejected. Processing is resumed with the XSTART operator command (see below).

XPARM

A set of startup parameters such as node number, maximum number of command queue elements and attached buffers are displayed as console messages.

XSTART

Processing of calls to the Entire System Server, interrupted with the XHALT command, is resumed.

XSTAT

Entire System Server statistics are displayed as console messages.

XSTOP

Processing stops immediately. Existing calls to the Entire System Server are not allowed to finish.

XUSER

The current number of users is displayed as a console message, and the highest number is displayed.

				Copyright © Software AG 2002
				All rights reserved