Compaq ACMS for OpenVMS
Remote Systems Management Guide


Previous Contents Index

This command displays summary run-time information for all servers on node VLCROW. Authorization is performed for the user specified by the logical name ACMS$MGMT_USER, or by proxy if the logical is not defined.

11.39 ACMSMGR SHOW TRAP

Displays SNMP trap configurations for one or more nodes.

Format

ACMSMGR SHOW TRAP [/qualifiers]

Command Qualifier Default
/INTERVAL=interval Command is executed once.
/NODE=node-name Translation of logical ACMS$MGMT_SERVER_NODE
/OUT=file-name None
/USER=user-name Translation of logical ACMS$MGMT_USER

Privileges Required

ACMS$MGMT_READ

Parameters

None.

Qualifiers

/INTERVAL=interval

This qualifier causes the command to be reissued automatically at a specified interval (in seconds). Use either Ctrl/C or Ctrl/Y to interrupt the command. If this qualifier is not specified, the command is executed only once.

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

/OUT=file-name

This qualifier causes output to be written to the specified file. If this qualifier is not specified, output is displayed to the terminal (SYS$OUTPUT).

/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 displays Remote Manager SNMP trap configuration information. SNMP traps are generated only if the SNMP interface is started. Changes to this table take effect immediately after they are processed.

See Section 9.13 for a description of each field displayed.


Example


$  ACMSMGR SHOW TRAP
 
ACMS Remote Management -- Command line utility 
 
ACMS V4.4-0  Trap Table Display                  Time: 18-APR-2001 13:59:38.69 
 
Node   Entity  Entity Name Parameter Min Max Sev Alarms Alarm Time 
------ ------- ----------- --------- --- --- --- ------ ----------------------- 
VLCROW *       *           exists    1   -1  i   0      17-NOV-1858 00:00:00.00 
 
      

This command displays SNMP traps that have been configured 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 by proxy if the logical is not defined.

11.40 ACMSMGR SHOW TSC

Displays information about TSCs on one or more remote nodes.

Format

ACMSMGR SHOW TSC [/qualifiers]

Command Qualifier Default
/ACTIVE See Notes.
/ALL Current data only.
/[BRIEF,FULL]
/[class-name] * (all)
/INTERVAL=interval Command is executed once.
/NODE=node-name Translation of logical ACMS$MGMT_SERVER_NODE
/OUT=file-name None
/STORED See Notes.
/USER=user-name Translation of logical ACMS$MGMT_USER

Privileges Required

ACMS$MGMT_READ

Parameters

None.

Qualifiers

/ACTIVE

When specified with the /BRIEF qualifier, this qualifier causes active ACMSGEN field values to be displayed. /ACTIVE is effective only when used with the /CONFIG qualifier. If /BRIEF is not specified, or if /FULL is specified, this qualifier has no effect (both active and stored values are displayed).

/ALL

This qualifier displays all available TSC data, including data for processes that are no longer running. When TSC processes are stopped, the TSC table row they were occupying is marked for reuse. If the row has not been reused, the data remains available for display. This qualifier allows that data to be displayed. Inactive rows are flagged with an asterisk (*) in the output.

To inhibit the display of old data, do not specify this qualifier. By default, only data for currently running processes is displayed.

/[BRIEF,FULL]

This qualifier causes either summary (/BRIEF) or detailed (/FULL) information to be displayed. If no class qualifier (/CONFIG, /ERROR, /ID, /POOL, or /RUNTIME) is specified, this qualifier is ignored and all details are displayed (equivalent to /FULL). Available OpenVMS process quota and SYSGEN parameter information is only displayed when /FULL is specified.

/[CONFIG,ERROR,ID,POOL,RUNTIME]

This qualifier causes data for only the specified class to be displayed. If this qualifier is omitted, the default is to display information for all classes.

/INTERVAL=interval

This qualifier causes the command to be reissued automatically at a specified interval (in seconds). Use either Ctrl/C or Ctrl/Y to interrupt the command. If this qualifier is not specified, the command is executed only once.

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

/OUT=file-name

This qualifier causes output to be written to the specified file. If this qualifier is not specified, output is displayed to the terminal (SYS$OUTPUT).

/STORED

When specified with the /BRIEF qualifier, this qualifier causes field values from the ACMSGEN file (not those active in memory) to be displayed. The /STORED qualifier is effective only when used with the /CONFIG qualifier. If /BRIEF is not specified, or if /FULL is specified, this qualifier has no effect (both active and stored values are displayed).

/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 displays information about the TSCs on the target nodes. The /BRIEF and /FULL qualifiers control the format of information to be displayed. To display OpenVMS process quota and SYSGEN parameter information, use the /FULL qualifier.

/ACTIVE is the default when the CONFIG class is being displayed.

See Section 9.14 for a discussion of each field displayed.

Note that some information may not be current, depending on whether the class to which the data belongs has been enabled for the TSC. The Config Class field indicates whether or not information is being collected for that class.


Examples

#1

$  ACMSMGR SHOW TSC /NODE=VLCROW /CONFIG
 
ACMS Remote Management -- Command line utility 
 
ACMS V4.4-0  TSC Table Display                    Time: 18-APR-2001 13:59:43.00 
 
             A  Config    Run                  CP    Max    Max TTS Perm   Min  
   Node      S   Class    State    User Name   Slots Logins Per CP   CPs  CPIs 
------------ -- -------- -------- ------------ ----- ------ ------- ----- ----- 
VLCROW       A  enabled  started  LT$TSC_V31   20    400    20      4     0    
      

This command displays summary Configuration class information for the TSC on node VLCROW. Authorization is performed for the user specified by the logical name ACMS$MGMT_USER, or by proxy if the logical is not defined. Since the /FULL qualifier was not supplied, only summary information is displayed.

#2

$  ACMSMGR SHOW TSC /NODE=VLCROW
 
ACMS Remote Management -- Command line utility 
 
ACMS V4.4-0  TSC Table Display                    Time: 18-APR-2001 13:59:40.62 
 
=============================================================================== 
 
Node   IDENTIFICATION                                                    
------ ------------------------------------------------------------------ 
VLCROW ID Class Collection State          enabled 
       Process Name                       ACMS01TSC001000 
       PID                                37C00251 
       User Name                          LT$TSC_V31  
       Start Time                         18-APR-2001 14:49:18.98 
       End Time                           (null) 
 
Node   CONFIGURATION                      Active          Stored       
------ ---------------------------------- --------------- ------------- 
VLCROW Config Class Collection State      enabled 
       TSC Running State                  started 
       TSC Username                       LT$TSC_V31      LT$TSC_V31  
       TSC Base Priority                  4               4       
       CP Username                        LT$CP_V40       LT$CP_V40   
       CP Base Priority                   4               4       
       CP Slots                           20              20      
       Max Logins (D)                     400             400     
       Max TTS per CP (D)                 20              20      
       Permanent CPs (D)                  4               4       
       Min CP slots (D)                   0               0       
       Working Set Default                65008           65001 
       Working Set Extent                 322992          90000 
       Working Set Quota                  65536           65536 
       AST Limit                          1999            1999 
       Byte Limit                         1775409         1777777 
       Direct I/O Limit                   15000           15000 
       Buffered I/O Limit                 10000           10000 
       Enqueue Limit                      10000           10000 
       Page File Quota                    500000          500000 
       Timer Queue Limit                  500             500 
 
Node   RUNTIME                                                         
------ ---------------------------------------------------------------- 
VLCROW Runtime Class Collection State     enabled 
 
       Gauges                           Current   Max     Limit   Max Time 
       -------------------------------- --------- ------- ------- ----------------------- 
       Logins                             2         4       60      18-APR-2001 15:49:55.13 
       CP Slots Used                      4         4       4       18-APR-2001 18:21:19.78 
       Terminals per CP (avg)             1         1       20      14-APR-2001 15:50:19.34 
 
       Process Quotas                Current     Max          Limit       Max Time 
       ----------------------------- ---------   --------    ------- ----------------------- 
       Working Set Size              65008       65008        322992  18-APR-2001 18:21:19.78 
       AST Limit                         4 ( 0%)     5 ( 0%)    1999  11-APR-2001 15:50:19.34 
       Byte Limit                        0 ( 0%)     0 ( 0%) 1775409  18-APR-2001 18:21:19.78 
       Direct I/O Limit                  0 ( 0%)     0 ( 0%)   15000  18-APR-2001 18:21:19.78 
       Buffered I/O Limit                2 ( 0%)     2 ( 0%)   10000  18-APR-2001 18:21:19.78 
       Enqueue Limit                     0 ( 0%)     0 ( 0%)   10000  18-APR-2001 18:21:19.78 
       File Limit                        1 ( 0%)     1 ( 0%)    1001  18-APR-2001 18:21:19.78 
       Page File Quota                6704 ( 1%)  6704 ( 1%)  500000  18-APR-2001 18:21:19.78 
       Timer Queue Limit                 3 ( 0%)     3 ( 0%)     500  11-APR-2001 09:14:55.49 
       Channel Count                    15          15 
 
Node   POOL                                                            
------ ---------------------------------------------------------------- 
VLCROW Pool Class Collection State        enabled 
 
       Process Pool                              Pct   Time      
       ----------------------------------------- ----- ----------------------- 
       Pool Size                          262144   
       Current Free (bytes)               259760 (99%)   
       Minimum Free (bytes)               259760 (99%) 19-APR-2001 13:59:32.98 
       Largest Current Free Block (bytes) 65536    
       Minimum Largest Free Block (bytes) 65536        19-APR-2001 13:59:32.98 
       Allocation Failures                0       
       Garbage Collections                0       
 
Node   ERROR                                                            
------ ---------------------------------------------------------------- 
VLCROW Error Class Collection State       enabled 
       Error Count                        0 
       Last Error Message                 0 
       Time of Last Error                 (null)  
 
      

This command displays all Configuration class information for the TSC on node VLCROW. Authorization is performed for the user specified by the logical name ACMS$MGMT_USER, or by proxy if the logical is not defined. Since neither the /FULL nor the /BRIEF qualifier was supplied, and no specific class was selected, all TSC information is displayed.

11.41 ACMSMGR SHOW USER

Displays Remote Manager user information for a server on one or more nodes. Information about both proxy and nonproxy users is displayed.

Format

ACMSMGR SHOW USER [/qualifiers]

Command Qualifier Default
/[BRIEF,FULL] /BRIEF
/INTERVAL=interval Command is executed once.
/NODE=node-name Translation of logical ACMS$MGMT_SERVER_NODE
/OUT=file-name None
/USER=user-name Translation of logical ACMS$MGMT_USER

Privileges Required

ACMS$MGMT_READ

Parameters

None.

Qualifiers

/[BRIEF,FULL]

This qualifier causes detailed information about each user to be displayed. When the qualifier is omitted, only summary information is displayed.

/INTERVAL=interval

This qualifier causes the command to be reissued automatically at a specified interval (in seconds). Use either Ctrl/C or Ctrl/Y to interrupt the command. If this qualifier is not specified, the command is executed only once.

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

/OUT=file-name

This qualifier causes output to be written to the specified file. If this qualifier is not specified, output is displayed to the terminal (SYS$OUTPUT).

/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 displays information about each user currently logged in to the Remote Manager server. The following fields are displayed:

If the /FULL qualifier is specified, the following additional information is displayed:


Examples

#1

$  ACMSMGR SHOW USERS
 
ACMS Remote Management -- Command line utility 
 
ACMS V4.4-0  User Table Display                  Time: 18-APR-2001 13:59:45.09 
 
 Server       Client                      Login 
 Node         Id       Username     Proxy Node 
 ------------ -------- ------------ ----- ----------------------------- 
 gocrow       16       LT_SUT       1     gocrow.zko.dec.com 
 gocrow       17       LT_SUT       1     vlcrow.zko.dec.com 
 vlcrow       16       LT_SUT       1     vlcrow.zko.dec.com 
 vlcrow       20       LT_SUT       1     vlcrow.zko.dec.com 
      

This command displays summary information about users who have logged in to Remote Manager 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 by proxy if the logical is not defined. In this example, all users logged in using proxy (Proxy = 1).

#2

$  ACMSMGR SHOW USERS /FULL /NODE=VLCROW
 
ACMS Remote Management -- Command line utility 
 
ACMS V4.4-0  User Table Display                  Time: 18-APR-2001 13:59:47.07 
 
 Node         User Information 
------------- ----------------------------------------------------- 
 VLCROW       Client id              16 
              Username               LT_SUT      
              Login Node             vlcrow.zko.dec.com 
              Credentials expiration 18-APR-2002 13:59:47.07 
              Proxy Flag             1 
              UIC                    [208,40] 
              Proxy UIC              [197,3] 
 
 Node         User Information 
------------- ----------------------------------------------------- 
 VLCROW       Client id              18 
              Username               LT_SUT      
              Login Node             vlcrow.zko.dec.com 
              Credentials expiration 18-APR-2001 14:44:01.02 
              Proxy Flag             1 
              UIC                    [197,3] 
              Proxy UIC              [197,3] 
      

This command displays all information about users who have logged in to Remote Manager 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 by proxy if the logical is not defined. In this example, both users logged in using proxy (Proxy = 1).

11.42 ACMSMGR SHOW VERSION++

Displays the current version of ACMSMGR and its related software components.

Format

ACMSMGR SHOW VERSION [/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_READ

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.


Example


$  ACMSMGR SHOW VERSION /NODE=GOCROW
 
ACMS Remote Management -- Command line utility 
 
ACMS V4.4-0   ACMS Version Display        Time: 18-APR-2001 13:59:47.07 
 
 Node         Version Information 
------------- ----------------------------------------------------- 
 local        ACMSMGR Version                 ACMS V4.4-0 
 
 GOCROW       ACMS Version                    V4.4-0 
              MGMT Header Version             2 
              MGMT EXC Header Version         2 
              MGMT Config File Version        2 
  
      

This command displays the current version of the ACMSMGR installed locally as well as the location and version of the related software components.

Note

++ This command (and its qualifiers) is only for use with systems running ACMS Version 4.4 or higher.


Previous Next Contents Index