Compaq ACMS for OpenVMS
Remote Systems Management Guide


Previous Contents Index

10.30 ACMSMGR SHOW SERVER

Displays information about one or more ACMS application server types on one or more nodes.


Format

ACMSMGR SHOW SERVER [/qualifiers]

Command Qualifier Default
/ALL Current data only
/APPL=application-name * (all)
/[BRIEF,FULL] /FULL if no class qualifier (/CONFIG, /ID,
or /RUNTIME) is specified. Otherwise, /BRIEF.
/[CONFIG,ID,RUNTIME] * (all)
/INTERVAL=interval Command is executed once.
/NODE=node-name Translation of logical ACMS$MGMT_SERVER_NODE
/OUT=file-name None
/SERVER=server-name * (all)
/USER=user-name Translation of logical ACMS$MGMT_USER


Privileges Required

ACMS$MGMT_READ

Parameters

None.

Qualifiers

/ALL

This qualifier displays all available application data, including data for applications that are no longer running. When applications are stopped, the EXC 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.

/APPL=application-name

Use this qualifer to specify a particular ACMS application to display. Wildcard matching is performed on the name provided.

/[BRIEF,FULL]

This qualifier causes either summary (/BRIEF) or detailed (/FULL) information to be displayed. If no class qualifier (/CONFIG, /ID, or /RUNTIME) is specified, this qualifier is ignored and all details are displayed (equivalent to /FULL).

/[CONFIG,ID,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 node name. To execute the command on more than one node, you can specify the node names in a comma-separated list. The ACMSMGR utility attempts to perform the operation sequentially on each node in the list.

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

/SERVER=server-name

This qualifier specifies a particular ACMS application server to display. Wildcard matching is performed on the name provided.

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

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 3.4.1.2 for a discussion of proxy access.


Notes

This command displays information about ACMS application servers on the target node. The /BRIEF and /FULL qualifiers control the format of information to be displayed.

See Section 8.10 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 server. The Collect State field indicates whether or not information is being collected for that class.


Example


$  ACMSMGR SHOW SERVER /NODE=VLCROW /RUNTIME
 
ACMS Remote Management -- Command line utility 
 
ACMS V4.3-0  SER Table Display                   Time: 25-AUG-1999 13:59:33.60 
 
       Collect Application                      Current Waiting Server Server 
        State  Name        Server Name          Servers Tasks   Starts Failures 
------ ------- ----------- -------------------- ------- -----   ------ -------- 
VLCROW enabled LDT_APPL_A  TESTSRV01            2       0       2      0       
VLCROW enabled LDT_APPL_A  TESTSRV1D            0       0       3419   0       
VLCROW enabled LDT_APPL_A  TESTSRV2D            1       0       19     0       
VLCROW enabled LDT_APPL_A  TESTSRV3D            1       0       1      0       
VLCROW enabled LDT_APPL_A  TESTSRV05            0       0       0      0       
VLCROW enabled LDT_APPL_A  TLOAD001S            4       0       6      0       
VLCROW enabled LDT_APPL_A  TLOAD002S            1       0       1      0       
VLCROW enabled LDT_APPL_A  DBMSLSRV1            1       0       1      0       
VLCROW enabled LDT_APPL_A  DBMSLSRV2            1       0       1      0       
VLCROW enabled LDT_APPL_A  RDBLSRV1             1       0       44     0       
VLCROW enabled LDT_APPL_A  RMSRSERVR            1       0       33     0       
VLCROW enabled LDT_APPL_A  TCT_LDT_PROC_SERVER  1       0       1      0       
VLCROW enabled LDT_APPL_A  TCT_LDT_CHAIN_SERVER 1       0       1      0       
VLCROW enabled LDT_APPL_A  TCT_LDT_DCL_SERVER   0       0       0      0       
VLCROW enabled LDT_APPL_A  RI_DCL_SERVER        2       0       9      0       
VLCROW enabled LDT_APPL_A  RI_V3016_FMS_SERVER  1       0       1      0       
VLCROW enabled LDT_APPL_A  RI_V3016_RI_SERVER   1       0       1      0       
VLCROW enabled LDT_APPL_A  VF_V3111_SERVER      0       0       0      0       
VLCROW enabled LDT_APPL_A  LDT_CS_V3111_SERVER  3       0       3      0       
VLCROW enabled LDT_APPL_A  TESTV32_RMS_SERVER   8       0       28     0       
VLCROW enabled LDT_APPL_A  TESTV32_RDB_SERVER   8       0       375    0       
VLCROW enabled LDT_APPL_A  TESTV32_DBMS_SERVER  8       0       47     0       
VLCROW enabled LDT_APPL_A  TESTV32_SQL_SERVER   8       0       405    0       
VLCROW enabled LDT_APPL_A  TESTV32_RM_SERVER    4       0       4      0       
VLCROW enabled LDT_APPL_A  GEN_INPUT_SERVER     4       0       24     0       
VLCROW enabled LDT_APPL_A  NOOP_SERVER          4       0       4      0       
VLCROW enabled LDT_APPL_A  UNUSED_VF_V32        0       0       0      0       
VLCROW enabled LDT_APPL_A  V_SERVER_W_DCL       1       0       1      0       
VLCROW enabled LDT_APPL_A  I_SERVER_W_DCL       1       0       1      0       
VLCROW enabled LDT_APPL_A  DETASK_SERVER        2       0       3      0       
      

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.

10.31 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 node name. To execute the command on more than one node, you can specify the node names in a comma-separated list. The ACMSMGR utility attempts to perform the operation sequentially on each node in the list.

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 10.6).

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 3.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 8.12 for a description of each field displayed.


Example


$  ACMSMGR SHOW TRAP
 
ACMS Remote Management -- Command line utility 
 
ACMS V4.3-0  Trap Table Display                  Time: 25-AUG-1999 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.

10.32 ACMSMGR SHOW TSC

Displays information about TSCs on one or more remote nodes.

Format

ACMSMGR SHOW TSC [/qualifiers]

Command Qualifier Default
/ACTIVE See Notes.
/[BRIEF,FULL]
/[CONFIG,ID,POOL,RUNTIME] * (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).

/[BRIEF,FULL]

This qualifier causes either summary (/BRIEF) or detailed (/FULL) information to be displayed. If no class qualifier (/CONFIG, /ID, /POOL, or /RUNTIME) is specified, this qualifier is ignored and all details are displayed (equivalent to /FULL).

/[CONFIG,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 node name. To execute the command on more than one node, you can specify the node names in a comma-separated list. The ACMSMGR utility attempts to perform the operation sequentially on each node in the list.

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 10.6).

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

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

See Section 8.13 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 Collect State 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.3-0  TSC Table Display                    Time: 25-AUG-1999 13:59:43.00 
 
             A  Collect    Run                  CP    Max   Max TTS Perm   Min  
   Node      S   State    State    Username    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.3-0  TSC Table Display                    Time: 25-AUG-1999 13:59:40.62 
 
=============================================================================== 
 
Node   IDENTIFICATION                                                    
------ ------------------------------------------------------------------ 
VLCROW Id Class Collection State          enabled 
       Process Name                       ACMS01TSC001000 
       PID                                37C00251 
       User Name                          LT$TSC_V31  
       Start Time                         24-AUG-1999 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       
 
Node   RUNTIME                                                         
------ ---------------------------------------------------------------- 
VLCROW Runtime Class Collection State     enabled 
       Current Users                      2 
 
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%) 25-AUG-1999 13:59:32.98 
 
       Largest Current Free Block (bytes) 65536    
       Minimum Largest Free Block (bytes) 65536        25-AUG-1999 13:59:32.98 
 
       Allocation Failures                0       
       Garbage Collections                0       
 
      

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.

10.33 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
/FULL Summary information (rather than full)
/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

/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 node name. To execute the command on more than one node, you can specify the node names in a comma-separated list. The ACMSMGR utility attempts to perform the operation sequentially on each node in the list.

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 10.6).

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 3.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.3-0  User Table Display                  Time: 25-AUG-1999 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.3-0  User Table Display                  Time: 25-AUG-1999 13:59:47.07 
 
 Node________ User_Information______ 
 VLCROW       Client id              16 
 VLCROW       Username               LT_SUT      
 VLCROW       Login Node             vlcrow.zko.dec.com 
 VLCROW       Credentials expiration 25-AUG-1999 13:41:06.07 
 VLCROW       Proxy Flag             1 
 VLCROW       UIC                    [208,40] 
 VLCROW       Proxy UIC              [197,3] 
 
 Node________ User_Information______ 
 VLCROW       Client id              18 
 VLCROW       Username               LT_SUT      
 VLCROW       Login Node             vlcrow.zko.dec.com 
 VLCROW       Credentials expiration 25-AUG-1999 14:44:01.02 
 VLCROW       Proxy Flag             1 
 VLCROW       UIC                    [197,3] 
 VLCROW       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).


Previous Next Contents Index