Operator Commands
This section provides a list of commands that can be entered by the operator to display various sets of information from the ISPW started tasks.
CM z/OS Console Commands
CM supports console commands that display information about connected clients, internal information, and enable/disable detailed tracing. The commands are executed using the z/OS MODIFY command. The MODIFY command can be abbreviated, F:
F cmproc,command parameter
where cmproc is the name of the CM started task.
There are four commands, D (display), DROP (drop a cross system session), SNAP (snap information to the TRACE DD), and TRACEALL (enable/disable detailed tracing).
Display Commands
There are three variations of the Display command.
You can display the status of Remote Servers:
One line will be displayed for every Remote Server connected to the CM.
The following is a sample display:
RS is the name of the Remote Server
CI is the name of the ISPW CI the Remote Server is connected to
V is the software version of the Remote Server
ST is the status of the Remote Server, and can be ACTV (active) or DISC (disconnected) or PCON (pending connect)
IQ is the number of requests CM has received from the Remote Server
OQ is the number of requests CM has sent to the Remote Server
You can display information about the 64-bit buffer pools used to store response messages as they are collected before being returned to the user. The buffers are called cells, are created in groups called extents, and there are 1024 buffers per extent:
D CELLS
The following is a sample display:
You can display information about virtual storage usage in the CM address space:
D VSM
The following is a sample display:
24-Bit: used= 964K free= 8228K
DROP Command
In certain error situations, it is possible for communications between CM and CI or CT to stop working properly. CM can think that CI or CT is still connected but it is not. Restarting the CI or CT will sometimes resolve the issue, but it might not, resulting in the following error message being issued:
where <system> is the internal name of the CI or CT.
Restarting CM will resolve the problem, but a restart might not be possible.
The DROP command will tell CM that the CI or CT is not actually connected, allowing the CI or CT to successfully connect.
DROP name
where name is the internal name of the problem CI or CT. The internal name of a CI is specified on the CI startup parameter WZCINAME. The internal name of a CT is specified on the CT startup parameter WZCTNAME.
The following is a sample of the resulting messages:
If no inbound session exists, then message WCM00210W would be issued instead of WZM00209I.
If no outbound session exists, then message WCM00212W would be issued instead of WCM00211I.
SNAP Commands
The SNAP commands write information to the TRACE DD of the CM address space. They should only be issued on the recommendation of a BMC Customer Support representative.
There are six variations of the command:
SNAP ACT trace information about active processes
SNAP BPT trace usage information about the various buffer pools
SNAP CELLS trace details about the 64-bit buffer pools
SNAP ENQ trace information about all internal enqueues
SNAP MODMAP trace information about all load modules in the CM address space (name, address, size)
SNAP VSM trace information about CM virtual storage usage
TRACEALL Commands
The TRACEALL command enables and disables very detailed tracing of activity in CM. It should only be issued on the recommendation of a BMC Customer Support representative because very large volumes of information can be traced in a short period of time. The data is written to the TRACE DD of the CM address space.
There are two variations of the command:
TRACEALL ON enable tracing
TRACEALL OFF disable tracing
CI z/OS Console Commands
CI supports console commands that display internal information about connected clients, internal information, and enable/disable detailed tracing. The commands are executed using the z/OS MODIFY command. The MODIFY command can be abbreviated, F:
F ciproc,command parameter
where ciproc is the name of the CI started task.
There are three commands, D (display), SNAP (snap information to the TRACE DD), and TRACEALL (enable/disable detailed tracing).
Display Commands
There are three variations of the Display command.
You can display the status of Remote Servers:
One line will be displayed for every Remote Server connected to the CI.
The following is a sample display:
RS is the name of the Remote Server
SY is the type of operating system the Remote Server is running on. It can be WNT (Microsoft Windows), AIX (IBM AIX), SUN (Oracle Solaris), HPX (HP-UX / Hewlett Packard Unix) or LNX (Linux).
V is the software version of the Remote Server.
ST is the status of the remote server, and can be ACTV (active) or DISC (disconnected) or PCON (pending connect)
IQ is the number of requests CI has received from the Remote Server
OQ is the number of requests CI has sent to the Remote Server
You can display information about virtual storage usage in the CI address space:
D VSM
The following is a sample display:
SNAP Commands
The SNAP commands write information to the TRACE DD of the CI address space. They should only be issued on the recommendation of a BMC Customer Support representative.
There are six variations of the command:
SNAP ACT trace information about active processes
SNAP BPT trace information about the various buffer pools
SNAP ENQ trace information about all internal enqueues
SNAP MODMAP trace information about all load modules in the CI address space (name, address, size)
SNAP REF trace all the ISPW reference data stored in the dataspace
SNAP VSM trace information about CI virtual storage usage
TRACEALL Commands
The TRACEALL command enables and disables very detailed tracing of activity in CI. It should only be issued on the recommendation of a BMC Customer Support representative because very large volumes of information can be traced in a short period of time. The data is written to the TRACE DD of the CI address space.
There are two variations of the command:
TRACEALL ON enable tracing
TRACEALL OFF disable tracing
CT z/OS Console Commands
CT supports console commands that display internal information about request activity, internal information, and enable/disable detailed tracing. The commands are executed using the z/OS MODIFY command. The MODIFY command can be abbreviated, F:
F ctproc,command parameter
where ctproc is the name of the CT started task.
There are three commands, D (display), SNAP (snap information to the TRACE DD), and TRACEALL (enable/disable detailed tracing).
Display Commands
There are four variations of the command.
You can display all active and pending requests:
D REQUESTS (or D REQ or D Q)
Two or three lines will be displayed for every request.
The following is a sample display:
REQ is the type of request, and can be COPY (copy a dataset or member) or DELE (delete a member) or CDNA (compute DNA) or ALOD (allocate a dataset) or DELD (delete a dataset)
ST is the status of the request and can be RUNNING or QUEUED
U is the userid that triggered the request
FR displays the name of the source CT and the source dataset or file or warehouse key
TO displays the name of the target CT and the target dataset or file or warehouse key
In the sample, PDS means the dataset is a PDS or PDSE. This could also be WH for a warehouse member, SEQ for a sequential dataset, or HFS for a USS file.
You can display information about active access managers (tasks that access local datasets or communicate with a remote CT):
D MANAGERS (or D MGR or D M)
The following is a sample display:
In the sample, LCL-DSN means this access manager is working with a local dataset. Other possible values are:
LCL-WH if accessing a local warehouse member
RMT-SRVR if accessing a dataset on behalf of another CT
RMT-CLNT if connected to another CT and that CT is accessing the dataset
LCL-HFS if accessing a local USS file
LCL-VSAM if accessing a local VSAM file
ST is the status of the access manager, and can be RUNNING or STARTING or READY or ERROR or STOPPING or STOPPED or OPENPIPE
You can display information about virtual storage usage in the CT address space:
D VSM
The following is a sample display:
You can display the status of all warehouses:
D WAREHOUSES (or D WH or D W)
The following is a sample display:
WH is the name of the warehouse
DSN is the dsname of the active warehouse dataset. If the warehouse has not been accessed since the CT was started, the dsname will show as NO ACTIVE DATASET.
SNAP Commands
The SNAP commands write information to the TRACE DD of the CT address space. They should only be issued on the recommendation of a BMC Customer Support representative.
There are five variations of the command:
SNAP ACT trace information about active processes
SNAP BPT trace information about the different buffer pools
SNAP ENQ trace information about all internal enqueues
SNAP MODMAP trace information about all load modules in the CT address space (name, address, size)
SNAP VSM trace information about CT virtual storage usage
TRACEALL Commands
The TRACEALL command enables and disables very detailed tracing of activity in CT. It should only be issued on the recommendation of a BMC Customer Support representative because very large volumes of information can be traced in a short period of time. The data is written to the TRACE DD of the CT address space.
There are two variations of the command:
TRACEALL ON enable tracing
TRACEALL OFF disable tracing