# Compaq ACMS for OpenVMS
Remote Systems Management Guide

Previous | Contents | Index

# 11.51 ACMSMGR STOP SYSTEM

Stops an ACMS run-time system on one or more remote nodes.

## Format

> ### ACMSMGR STOP SYSTEM [/qualifiers]

> Command Qualifier | Default
> --- | ---
> /CANCEL | Wait for executing tasks to complete.
> /NODE=node-name | Translation of logical ACMS$MGMT_SERVER_NODE
> /USER=user-name | Translation of logical ACMS$MGMT_USER

## Privileges Required

> ACMS$MGMT_OPER

## Parameters

> None.

## Qualifiers

> ### /CANCEL

> This qualifier stops the ACMS run-time system without waiting for currently executing tasks to complete. If not specified, any tasks currently executing are allowed to complete before the application is stopped.

> ### /NODE=node-name

> This qualifier specifies a fully- or partially-qualified TCP/IP host name. This name must match the current DECnet host name. IP addresses and host names (or aliases) that exceed six characters or include mixed case are not allowed. For more information on TCP/IP host names and defining aliases, see Section 2.2.1.

> If the /NODE qualifier is not specified, the ACMSMGR utility checks for the presence of the logical name ACMS$MGMT_SERVER_NODE. If the logical is defined, the value of the logical is used by default.

> In order for the command to execute, either the /NODE qualifier must be provided on the command line, or the ACMS$MGMT_SERVER_NODE logical must be defined.

> ### /USER=user-name

> This qualifier specifies the name of the OpenVMS account on the server node to be used for authorization. If this qualifier is specified, an explicit login must already have been completed successfully (see Section 11.9).

> If the /USER qualifier is not specified, the ACMSMGR utility checks for the presence of the logical name ACMS$MGMT_USER. If the logical is defined, the value of the logical is used by default.

> If the /USER qualifier is not specified and the ACMS$MGMT_USER logical is not defined, the ACMSMGR utility attempts proxy access. See Section 4.4.1.2 for a discussion of proxy access.

## Notes

> This command is equivalent to the ACMSOPER command ACMS/STOP SYSTEM. This command is executed synchronously. If the command completes successfully, the application has been stopped on the target nodes. If not, error messages are displayed.

## Example

    $  ACMSMGR STOP SYS/NODE=SPARKS/CANCEL

> This command stops the ACMS run-time system on node SPARKS. All currently executing tasks, servers, and users are canceled.

# 11.52 ACMSMGR STOP TERMINALS

Stops the TSC and any related CPs on one or more remote nodes.

## Format

> ### ACMSMGR STOP TERMINALS [/qualifiers]

> Command Qualifier | Default
> --- | ---
> /NODE=node-name | Translation of logical ACMS$MGMT_SERVER_NODE
> /USER=user-name | Translation of logical ACMS$MGMT_USER

## Privileges Required

> ACMS$MGMT_OPER

## Parameters

> None.

## Qualifiers

> ### /NODE=node-name

> This qualifier specifies a fully- or partially-qualified TCP/IP host name. This name must match the current DECnet host name. IP addresses and host names (or aliases) that exceed six characters or include mixed case are not allowed. For more information on TCP/IP host names and defining aliases, see Section 2.2.1.

> If the /NODE qualifier is not specified, the ACMSMGR utility checks for the presence of the logical name ACMS$MGMT_SERVER_NODE. If the logical is defined, the value of the logical is used by default.

> In order for the command to execute, either the /NODE qualifier must be provided on the command line, or the ACMS$MGMT_SERVER_NODE logical must be defined.

> ### /USER=user-name

> This qualifier specifies the name of the OpenVMS account on the server node to be used for authorization. If this qualifier is specified, an explicit login must already have been completed successfully (see Section 11.9).

> If the /USER qualifier is not specified, the ACMSMGR utility checks for the presence of the logical name ACMS$MGMT_USER. If the logical is defined, the value of the logical is used by default.

> If the /USER qualifier is not specified and the ACMS$MGMT_USER logical is not defined, the ACMSMGR utility attempts proxy access. See Section 4.4.1.2 for a discussion of proxy access.

## Notes

> This command is equivalent to the ACMSOPER command ACMS/STOP TERMINALS. This command is executed synchronously. If the command completes successfully, the terminal subsystem has been stopped on the target nodes. If not, error messages are displayed.

## Example

    $  ACMSMGR STOP TERMINALS/NODE=SPARKS/CANCEL

> This command stops the ACMS terminal subsystem on node SPARKS.

# 11.53 ACMSMGR STOP TRACE_MONITOR

Stops the ACMS$TRACE_MON process on the target node.

## Format

> ### ACMSMGR STOP TRACE_MONITOR [/qualifiers]

> Command Qualifier | Default
> --- | ---
> /NODE=node-name | Translation of logical ACMS$MGMT_SERVER_NODE
> /USER=user-name | Translation of logical ACMS$MGMT_USER

## Privileges Required

> ACMS$MGMT_OPER

## Parameters

> None.

## Qualifiers

> ### /NODE=node-name

> This qualifier specifies a fully- or partially-qualified TCP/IP host name. This name must match the current DECnet host name. IP addresses and host names (or aliases) that exceed six characters or include mixed case are not allowed. For more information on TCP/IP host names and defining aliases, see Section 2.2.1.

> If the /NODE qualifier is not specified, the ACMSMGR utility checks for the presence of the logical name ACMS$MGMT_SERVER_NODE. If the logical is defined, the value of the logical is used by default.

> In order for the command to execute, either the /NODE qualifier must be provided on the command line, or the ACMS$MGMT_SERVER_NODE logical must be defined.

> ### /USER=user-name

> This qualifier specifies the name of the OpenVMS account on the server node to be used for authorization. If this qualifier is specified, an explicit login must already have been completed successfully (see Section 11.9).

> If the /USER qualifier is not specified, the ACMSMGR utility checks for the presence of the logical name ACMS$MGMT_USER. If the logical is defined, the value of the logical is used by default.

> If the /USER qualifier is not specified and the ACMS$MGMT_USER logical is not defined, the ACMSMGR utility attempts proxy access. See Section 4.4.1.2 for a discussion of proxy access.

## Notes

> This command requests the Remote Manager to stop the ACMS$TRACE_MON process on the target node. The ACMS$TRACE_MON process is an intermediate process used by the Remote Manager to communicate with ACMS run-time processes to enable and disable collections.

> In general, external entities do not require a startup or shutdown request of the trace monitor process. The Remote Manager starts the trace monitor during process initialization and stops it during process shutdown. Additionally, the Remote Manager starts the trace monitor anytime it is needed if it is not already started. Once started, the trace monitor continues running until the Remote Manager shuts down.

> After issuing the stop command to the trace monitor, the Remote Manager waits for a period of up to trace_start_wait_time (a Parameter table parameter that is dynamic and expressed in seconds). If the trace monitor fails to stop during that period, the ACMSMGR command returns an error.

## Example

    $  ACMSMGR STOP TRACE_MONITOR

> This command stops the ACMS$TRACE_MON process on the node specified by the logical name ACMS$MGMT_SERVER_NODE. Authorization is performed for the user specified by the logical name ACMS$MGMT_USER, or based on an ACMS proxy on the target node if the logical is not defined. If the process is successfully stopped, no messages are displayed.

# Chapter 12
ACMSSNAP Commands

This chapter provides reference information about ACMSSNAP utility commands. Note that this utility and its commands are designed to run locally on a Remote Manager Version 4.4 or higher system.

# 12.1 ACMSSNAP Overview

The ACMSSNAP utility is used to display information collected in an ACMS Remote Manager data snapshot file. ACMSSNAP runs locally and requires local access to data snapshot files. This means that although a data snapshot file may have been created on a remote node, that file must be directly accessible to the local process running the ACMSSNAP utility.

The ACMSSNAP utility only displays information from the data snapshot file. It does not modify the data in the file or make modifications to the ACMS run-time system.

See Section 5.2 for a description of how to to save collected management information in data snapshot files.

## 12.1.1 Command Format

The format for ACMSSNAP commands is as follows:

    ACMSSNAP> verb object qualifiers

The following verbs are supported:

- CLOSE
- EXIT
- HELP
- NEXT
- OPEN
- PREV
- QUIT
- RESET
- SHOW
- TRACE

Most verbs have associated objects and qualifiers. The following sections list the objects and any qualifiers for each ACMSSNAP command.

## 12.1.2 Command Objects and Qualifiers

The objects and qualifiers for the ACMSSNAP commands are summarized in Table 12-1.

Table 12-1 ACMSSNAP Command Objects and Qualifiers
Objects | Qualifiers
--- | ---
CLOSE Command
None | None
EXIT Command
None | None
HELP Command
None | None
NEXT Command
[number] | None
OPEN Command
[file-name] | /AT, /CP_SLOTS, /MAX_APPL, /SUMMARY
PREV Command
[number] | None
QUIT Command
None | None
RESET Command
None | /ALL
SHOW Command
ACC | /AT, /BRIEF, /CONFIG, /FULL, /ID, /NEXT, /OUT, /POOL, /PREV, /RUNTIME
CP | /AT, /BRIEF, /CONFIG, /FULL, /ID, /NEXT, /OUT, /POOL, /PREV, /RUNTIME
EXC | /APPL, /AT, /BRIEF, /CONFIG, /FULL, /ID, /NEXT, /OUT, /POOL, /PREV, /RUNTIME
GROUP | /APPL, /AT, /BRIEF, /CONFIG, /FULL, /ID, /NEXT, /OUT, /POOL, /PREV, /RUNTIME
QTI | /AT, /BRIEF, /CONFIG, /FULL, /ID, /NEXT, /OUT, /POOL, /PREV, /RUNTIME
SERVER | /APPL, /AT, /BRIEF, /CONFIG, /FULL, /ID, /NEXT, /OUT, /POOL, /PREV, /RUNTIME
TSC | /AT, /BRIEF, /CONFIG, /FULL, /ID, /NEXT, /OUT, /POOL, /PREV, /RUNTIME
TRACE Command
None | None

# 12.2 ACMSSNAP CLOSE

Closes the current data snapshot file.

## Format

> ### ACMSSNAP> CLOSE

## Privileges Required

> None.

## Parameters

> None.

## Qualifiers

> ###

> None.

## Notes

> Only one snapshot file can be open at a time.

## Example

    ACMSSNAP>  CLOSE

> This command closes the current data snapshot file.

# 12.3 ACMSSNAP EXIT

Ends the current ACMSSNAP session.

## Format

> ### ACMSSNAP> EXIT

## Privileges Required

> None.

## Parameters

> None.

## Qualifiers

> ###

> None.

## Notes

> This command ends the current ACMSSNAP session and returns control to DCL. It is equivalent to the QUIT command.

## Example

    ACMSSNAP>  EXIT

> This command ends the current ACMSSNAP session.

# 12.4 ACMSSNAP HELP

Displays help information about the ACMS Remote Manager Data Snapshot Utility (ACMSSNAP) and its commands.

## Format

> ### ACMSSNAP> HELP

## Privileges Required

> None.

## Parameters

> None.

## Qualifiers

> ###

> None.

## Notes

> Online help is available for each ACMSSNAP command. Each help topic summarizes the valid syntax, abbreviations, parameters, and qualifiers for a particular command and also in`dicates all default and required values.

> For a comprehensive list of ACMS utilities that offer online help or for further instructions on how to invoke help, see ACMS Help.

## Example

    ACMSSNAP>  HELP

> This command invokes online help for the ACMSSNAP utility and displays a list of available topics.

# 12.5 ACMSSNAP NEXT

Reads the next sequence of snapshot records.

## Format

> ### ACMSSNAP> NEXT [number]

## Privileges Required

> None.

## Parameters

> ### number

> A numeric value that indicates the number of records to be read. If a value is not specified, the default value of 1 record is used.

## Qualifiers

> ###

> None.

## Notes

> Use the NEXT command to move forward incrementally in a data snapshot file. When the NEXT command is issued, the ACMSSNAP utility reads the next record or series of records from the currently open snapshot file in chronological order. If a number is not specified with this command, NEXT moves forward one record at a time.

> Note that the NEXT and PREV commands are not intended to be the primary means of navigation through a data snapshot file. Use the ACMSSNAP SHOW/AT command to first identify an approximate timeframe for the ACMS activity that you want to view. Then use the NEXT or PREV command to move forward or backward incrementally from that timeframe.

> If tracing is turned on (TRACE command), header information is displayed for each record read.

> See Section 5.3.2.3 for more information on navigating through a data snapshot file with ACMSSNAP.

## Example

    ACMSSNAP>  NEXT 10

> This command reads the next 10 records in the data snapshot file. These records overlay any previous records for this entity and class.

# 12.6 ACMSSNAP OPEN

Opens the specified data snapshot file.

## Format

> ### ACMSSNAP> OPEN file-name [/qualifiers]

> Command Qualifier | Default
> --- | ---
> /AT=time | None
> /CP_SLOTS=value | The value of ACMS$MGMT_SNAP_CP_SLOTS,
> | or if not defined, 3.
> /MAX_APPLS=value | The value of ACMS$MGMT_SNAP_CP_SLOTS,
> | or if not defined, 10.
> /SUMMARY | None

## Privileges Required

> None.

## Parameters

> ### file-name

> This required parameter specifies an OpenVMS file specification or logical that indicates the name and location of the data snapshot file.

## Qualifiers

> ### /AT=time

> This qualifier moves through the open data snapshot file to the first record equal to or greater than the specified time. The format of time is DD-MMM-YY:hh:mm:ss.nn. Partial dates and times (for example, 10-OCT or 09:00) are supported.

> ### /CP_SLOTS=value

> This qualifier reserves space for CP records in a statically-sized internal table. CP records are stored in the table by process name. These records are not removed from the table until the snapshot file is closed. If there is insufficient space in the table, data for subsequent CP processes is discarded. (A warning message is issued if the CP table becomes full and TRACE is turned on). Specifying this qualifier overrides the value of the logical name ACMS$MGMT_SNAP_CP_SLOTS, if defined. The default value is 3.

> ### /MAX_APPLS=value

> This qualifier reserves space for EXC records in a statically-sized internal table. EXC records are stored in the table by application name. These records are not removed from the table until the snapshot file is closed. If there is insufficient space in the table, data for subsequent EXC processes is discarded. (A warning message is issued if the EXC table becomes full and TRACE is turned on). Specifying this qualifier overrides the value of the logical name ACMS$MGMT_SNAP_MAX_APPL, if defined. The default value is 10.

> ### /SUMMARY

> This qualifier scans the entire data snapshot file and displays a summary report that shows the total number of records written (per entity, class, and file) as well as the time when the first and last record was written (per entity).

## Notes

> Data snapshot files are RMS indexed files. You can open a snapshot file with the ACMSSNAP utility even if it is currently being written to by an ACMS Remote Manager process.

> For more information about opening and closing data snapshot files, see Section 5.3.2.2.

## Example

    ACMSSNAP>  OPEN ACMS$MGMT_SNAPSHOT /SUMMARY /CP_SLOTS=10 /MAX_APPL=5
    ACMS Remote Management -- Snapshot utility
     Compiling summary statics ...

     Entity   # Recs  First Record            Last Record             All  Id  Cfg Rt  Pool Error
     -------- ------  ----------------------  ----------------------  ---- --- --- --- ---- -----
     *        0                                                       0    0   0   0   0    0
     acc      42       7-JUN-2001 14:00:56.69 7-JUN-2001 14:21:32.19  42   0   0   0   0    0
     tsc      42       7-JUN-2001 14:00:56.69 7-JUN-2001 14:21:32.19  42   0   0   0   0    0
     qti      0                                                       0    0   0   0   0    0
     cp       184      7-JUN-2001 14:00:56.69 7-JUN-2001 14:21:32.19  184  0   0   0   0    0
     exc      204      7-JUN-2001 14:01:28.01 7-JUN-2001 14:21:32.19  204  0   0   0   0    0
     server   6496     7-JUN-2001 14:01:28.01 7-JUN-2001 14:21:32.19  6496 0   0   0   0    0
     group    3032     7-JUN-2001 14:01:28.01 7-JUN-2001 14:21:32.19  3032 0   0   0   0    0
     mgr      0                                                       0    0   0   0   0    0

     10000 Records Read

    MAX_APPL = 10 (use /MAX_APPL on OPEN or define ACMS$MGMT_SNAP_MAX_APPL to change)
    CP_SLOTS = 10 (use /CP_SLOTS on OPEN or define ACMS$MGMT_SNAP_CP_SLOTS to change)

> This command opens the data snapshot file referenced by the ACMS$MGMT_SNAPSHOT logical, scans all the records, and displays a summary report. The CP_SLOTS and MAX_APPLS values are explicitly set.

# 12.7 ACMSSNAP PREV

Scans the previous sequence of snapshot records.

## Format

> ### ACMSSNAP> PREV [number]

## Privileges Required

> None.

## Parameters

> ### number

> A numeric value that indicates the number of records to be read. If a value is not specified, the default value of 1 record is used.

## Qualifiers

> ###

> None.

## Notes

> Use the PREV command to move backward incrementally in a data snapshot file. When the PREV command is issued, the ACMSSNAP utility reads the previous record or series of records from the currently open snapshot file in reverse chronological order. If a number is not specified with this command, PREV moves backward one record at a time.

> Note that the NEXT and PREV commands are not intended to be the primary means of navigation through a data snapshot file. Use the SHOW/AT=date-time command to first identify an approximate timeframe for the ACMS activity that you want to view. Then use the NEXT or PREV command to move forward or backward incrementally from that timeframe.

> If tracing is turned on (TRACE command), header information is displayed for each record read.

> See Section 5.3.2.3 for more information on navigating through a data snapshot file with ACMSSNAP.

## Example

    ACMSSNAP>  PREV 10

> This command scans and reads the previous 10 data snapshot records. These records overlay any previous records for this entity and class.

Previous | Next | Contents | Index