# 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:
> - Server Node: The node from which the information was obtained.
> - Client Id: A unique identifier for each client.
> - Username: The name of the local (server node) account to which the user is logged in. This is the user name that is being used for authorization.
> - Proxy: A flag indicating whether the user is logged in using an ACMS proxy. A value of zero (0) indicates that the login is not proxy based; a value of 1 indicates that the login is proxy based.
> - Login Node: The node from which the client logged in. This node may not be the same as the server node.

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

> - Credentials expiration: The date and time at which the user's credentials will expire.
> - UIC: The UIC of the account from which the login was initiated.
> - Proxy UIC: The UIC of the account on the server node that is used for authorization.

## 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