| Previous | Contents | Index |
Stops an ACMS run-time system on one or more remote nodes.
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
ACMS$MGMT_OPER
None.
/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.
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.
$ 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.
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
ACMS$MGMT_OPER
None.
/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.
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.
$ 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.
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
ACMS$MGMT_OPER
None.
/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.
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.
$ 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.
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:
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.
| 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.
ACMSSNAP> CLOSE
None.
None.
None.
Only one snapshot file can be open at a time.
ACMSSNAP> CLOSE
|
This command closes the current data snapshot file.
12.3 ACMSSNAP EXIT
Ends the current ACMSSNAP session.
ACMSSNAP> EXIT
None.
None.
None.
This command ends the current ACMSSNAP session and returns control to DCL. It is equivalent to the QUIT command.
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.
ACMSSNAP> HELP
None.
None.
None.
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.
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.
ACMSSNAP> NEXT [number]
None.
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.
None.
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.
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.
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
None.
file-name
This required parameter specifies an OpenVMS file specification or logical that indicates the name and location of the data snapshot file.
/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).
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.
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.
ACMSSNAP> PREV [number]
None.
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.
None.
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.
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 |