Compaq ACMS for OpenVMS
Remote Systems Management Guide


Previous Contents Index

11.30 ACMSMGR SHOW FILTER++

Displays the errors currently being filtered on one or more nodes.


Format

ACMSMGR SHOW FILTER [/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.


Notes

This command displays all system errors currently being filtered for the specified node or nodes.

See Section 5.5 for information on working with error logs and error filtering.


Example


$  ACMSMGR SHOW FILTER /NODE=VLCROW
ACMS Remote Management -- Command line utility 
 
ACMS V4.4-0  ACMS Error Filter Table Display      Time: 18-APR-2001 13:59:09.33 
 
 Node   Filtered Message Name (Code) 
------  ---------------------------------------------------------------------- 
VLCROW        ACMSACC-W-AUDSYSSTARTS (  FD8748) 
VLCROW        SYSTEM-W-TOOMUCHDATA (     298) 
VLCROW        SYSTEM-W-NOMOREREG (     AE8) 
      

This command displays the current errors being filtered for node VLCROW. When generated by an ACMS process on node VLCROW, these errors are not relayed to the Remote Manager.

Note

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

11.31 ACMSMGR SHOW GROUP

Displays information about one or more ACMS task groups on one or more nodes.


Format

ACMSMGR SHOW GROUP [/qualifiers]

Command Qualifier Default
/APPLICATION=application-name * (all)
/[BRIEF,FULL] /FULL if no class qualifier (/ID or /POOL)
is specified. Otherwise, /BRIEF.
/GROUP=group-name * (all)
/[ID,POOL] * (all)
/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

/APPLICATION=application-name

This qualifer specifies a particular ACMS application to display. Wildcard matching is performed on the name provided; use of asterisks (*) is allowed.

/[BRIEF,FULL]

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

/GROUP=group-name

This qualifier specifies a particular ACMS task group to display. Wildcard matching is performed on the name provided; use of asterisks (*) is allowed.

/[ID, POOL]

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

/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 ACMS application task groups on the target node. 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.

See Section 9.12 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 task group. The Pool Class field indicates whether or not information is being collected for that class.


Example


$  ACMSMGR SHOW GROUP/POOL
 
ACMS Remote Management -- Command line utility 
 
ACMS V4.4-0  Task Group Table Display           Time: 18-APR-2001 13:59:36.35 
 
         Pool     Application                  -TWS Pool Free-    -TWSC Pool Free- 
 Node    Class    Name         Task Group Name Current  Minimum   Current Mininum 
------  --------  -----------  --------------- -------- --------- ------- --------- 
VLCROW  enabled   LDT_APPL_A   TEST_GRP01      99 %     99 %      99 %     98 %      
VLCROW  enabled   LDT_APPL_A   TLOAD001_GRP    97 %     97 %      98 %     98 %     
VLCROW  enabled   LDT_APPL_A   DBMS_LOAD_GRP   99 %     99 %      99 %     99 %     
VLCROW  enabled   LDT_APPL_A   RDB_LOAD_GRP    99 %     99 %      99 %     98 %     
VLCROW  enabled   LDT_APPL_A   RMSR_GRP        99 %     99 %      99 %     98 %     
VLCROW  enabled   LDT_APPL_A   TCT_ LDT_GROUP  99 %     90 %      98 %     95 %     
VLCROW  enabled   LDT_APPL_A   AT_TT_GROUP     99 %     99 %      99 %     98 %     
VLCROW  enabled   LDT_APPL_A   RI_FMS          99 %     99 %      99 %     98 %     
VLCROW  enabled   LDT_APPL_A   RI_SMG          99 %     99 %      99 %     99 %     
VLCROW  enabled   LDT_APPL_A   VF_GROUP        99 %     99 %      99 %     98 %     
VLCROW  enabled   LDT_APPL_A   CS_GROUP        99 %     99 %      99 %     97 %     
VLCROW  enabled   LDT_APPL_A   DT_GROUP        96 %     95 %      92 %     89 %     
VLCROW  enabled   LDT_APPL_A   VF_V32_GROUP    99 %     99 %      98 %     97 %     
VLCROW  enabled   LDT_APPL_A   DCL_CLI_GROUP   99 %     99 %      99 %     98 %     
VLCROW  enabled   LDT_APPL_A   DETASK_GROUP    99 %     99 %      99 %     98 %     
      

This command displays summary POOL class information for all task groups in all applications 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.32 ACMSMGR SHOW INTERFACE

Displays Remote Manager interface (RPC or SNMP) information for a Remote Manager process on one or more nodes.

Format

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

The ACMS Remote Manager supports two interfaces: RPC and SNMP. This command displays the running and enabled states of each interface, along with some counter and status information. See Section 9.7 for a discussion of each field displayed.

Example


$  ACMSMGR SHOW INTERFACE /NODE=VLCROW,GOCROW /USER=JONES
 
ACMS Remote Management -- Command line utility 
 
ACMS V4.4-0  Interfaces Display                 Time: 18-APR-2001 13:59:15.51 
 
                 Enabled Running Get      Set      Alarms Time Last 
Node   Interface State   State   Requests Requests Sent   Alarm Sent 
------ --------- ------- ------- -------- -------- ------ ----------------------- 
vlcrow rpc       enabled started 987      0        0      17-NOV-1858 00:00:00.00  
vlcrow snmp      enabled started 0        0        0      17-NOV-1858 00:00:00.00  
gocrow rpc       enabled started 964      0        0      17-NOV-1858 00:00:00.00 
gocrow snmp      enabled started 0        0        0      17-NOV-1858 00:00:00.00 
      

This command displays information for the Remote Manager interfaces on nodes VLCROW and GOCROW. Authorization is performed for user JONES.

11.33 ACMSMGR SHOW LOG

Displays Remote Manager log entries for a server on one or more nodes.

Format

ACMSMGR SHOW LOG [/qualifiers]

Command Qualifier Default
/BEFORE=time End of file
/FACILITY=facility All
/FILENAME=file-name Translation of logical ACMS$MGMT_LOG
/INTERVAL=interval Command is executed once.
/LOCAL Remote
/NODE=node-name Translation of logical ACMS$MGMT_SERVER_NODE
/OUT=file-name None
/SEVERITY=[I,W,E,F] All
/SINCE=time Beginning of file
/USER=user-name Translation of logical ACMS$MGMT_USER

Privileges Required

ACMS$MGMT_READ

Parameters

None.

Qualifiers

/BEFORE=time

This qualifier causes only audit log entries with a timestamp less than or equal to the time specified by time to be returned and displayed. 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. If this qualifier is not specified, the search ends when the end of the audit file is reached.

/FACILITY=[DCL, LOG, MGR, MSG_PROC, PROCMON, RPC, SEC, SNAP, SNMP, TRAP]

This qualifier causes only audit log entries with matching facilities to be displayed. If this qualifier is not specified, all facilities are returned.

/FILENAME=file-name

This qualifier allows log records to be displayed from a file other than the current log file. Specify a fully or partially qualified file specification.

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

/LOCAL

This qualifier causes the ACMSMGR to open and read the audit log on the local node directly. You can use this qualifier if the Remote Manager process is not started. The /LOCAL qualifier overrides the /NODE qualifier and the ACMS$MGMT_SERVER_NODE logical.

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

/SEVERITY=[I, W, E, F]

This qualifier causes only audit log entries with matching severities to be displayed. Valid severities are informational (I), warning (W), error (E), and fatal (F). If this qualifier is not specified, all severities are returned.

/SINCE=time

This qualifier causes only audit log entries with a timestamp greater than or equal to the time specified by time to be returned and displayed. 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. If this qualifier is not specified, the search begins at the beginning of the audit file.

/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 audit file information. The format of the audit entries displayed is:

node  time: facility: severity: error-text 

In this format:


Examples

#1

$  ACMSMGR SHOW LOG /NODE=VLCROW /SINCE="20-MAR-2001 11:00" -
_$  /BEFORE="20-MAR-2001 12:00"
 
ACMS Remote Management -- Command line utility 
 
ACMS V4.4-0  Log Display                        Time: 18-APR-2001 13:59:17.45 
 
Node    Message 
vlcrow  20-MAR-2001 11:00:37.15 :      log: i : Log opened 
vlcrow  20-MAR-2001 11:02:29.43 : msg_proc: i : EXC shutdown. Attempting to 
          unmap application global section for ACMS01EXC001000 
vlcrow  20-MAR-2001 11:02:29.43 : msg_proc: i : Application global section 
          unmapped for ACMS01EXC001000 
vlcrow  20-MAR-2001 11:02:29.43 : msg_proc: i : EXC shutdown processing 
          complete for ACMS01EXC001000 
vlcrow  20-MAR-2001 11:02:35.18 : msg_proc: i : CP process shutdown message 
          received for ACMS01CP001000 
vlcrow  20-MAR-2001 11:02:38.40 : msg_proc: i : CP process shutdown message 
          received for ACMS01CP004000 
vlcrow  20-MAR-2001 11:02:38.40 : msg_proc: i : CP process shutdown message 
          received for ACMS01CP003000 
vlcrow  20-MAR-2001 11:02:38.40 : msg_proc: i : CP process shutdown message 
          received for ACMS01CP002000 
vlcrow  20-MAR-2001 11:02:39.23 : msg_proc: i : TSC process shutdown message 
          received for ACMS01TSC001000 
vlcrow  20-MAR-2001 11:02:41.93 : msg_proc: i : ACC process shutdown message 
          received for ACMS01ACC001000 
vlcrow  20-MAR-2001 11:02:42.05 :  procmon: w : ACC process is absent after 
          being present. 
vlcrow  20-MAR-2001 11:03:00.23 : msg_proc: i : ACC process startup message 
          received for ACMS01ACC001000 
vlcrow  20-MAR-2001 11:03:00.23 : msg_proc: e : Failure getting current 
          collection states. Ignoring process ACMS01ACC001000 
vlcrow  20-MAR-2001 11:03:03.93 : msg_proc: i : TSC process startup message 
          received for ACMS01TSC001000 
vlcrow  20-MAR-2001 11:03:10.03 : msg_proc: i : CP process startup message 
          received for ACMS01CP001000 
vlcrow  20-MAR-2001 11:03:10.04 : msg_proc: i : CP process startup message 
          received for ACMS01CP002000 
vlcrow  20-MAR-2001 11:03:10.04 : msg_proc: i : CP process startup message 
          received for ACMS01CP004000 
vlcrow  20-MAR-2001 11:03:10.05 : msg_proc: i : CP process startup message 
          received for ACMS01CP003000 
vlcrow  20-MAR-2001 11:03:31.87 : msg_proc: i : EXC startup. Attempting to map 
          application global section for ACMS01EXC001000 
vlcrow  20-MAR-2001 11:03:31.87 : msg_proc: i : EXC startup processing complete 
          for ACMS01EXC001000 
vlcrow  20-MAR-2001 11:03:51.28 :      sec: w : Operator access attempt by user 
          vlcrow.zko.dec.com::LT_SUT [305,3] for function ACMSMGMT_STOP 
vlcrow  20-MAR-2001 11:03:51.28 :      rpc: e : Call to mgmt_shutdown complete 
vlcrow  20-MAR-2001 11:03:51.28 :      rpc: f : svc_run returned! 
vlcrow  20-MAR-2001 11:03:51.48 :  procmon: f : Failure waiting on 
          mgmt$x_proc_mon_cond_var 
vlcrow  20-MAR-2001 11:03:51.50 :      mgr: w : Rejected request to stop RPC 
          interface when it is already stopped. 
vlcrow  20-MAR-2001 11:04:00.12 :      log: i : Log opened 
vlcrow  20-MAR-2001 11:04:02.08 :  procmon: e : Failure obtaining current 
          collection states. Bypassingqti 
vlcrow  20-MAR-2001 11:04:02.63 : msg_proc: i : Message proc thread 
          initializing 
vlcrow  20-MAR-2001 11:04:02.63 : msg_proc: i : Message proc thread starting 
vlcrow  20-MAR-2001 11:04:02.63 : msg_proc: i : Message proc thread executing 
vlcrow  20-MAR-2001 11:04:03.14 :      sec: e : Failure obtaining uaf info for 
          ACMS$SNMP    
vlcrow  20-MAR-2001 11:04:03.20 :      sec: e : %RMS-E-RNF, record not found 
vlcrow  20-MAR-2001 11:04:03.20 :      sec: e : Account verification failed for 
          ACMS$SNMP user 
 
vlcrow  20-MAR-2001 11:25:53.20 : msg_proc: i : CP process shutdown message 
          received for ACMS01CP001000 
vlcrow  20-MAR-2001 11:25:53.72 : msg_proc: i : CP process shutdown message 
          received for ACMS01CP003000 
vlcrow  20-MAR-2001 11:25:53.72 : msg_proc: i : CP process shutdown message 
          received for ACMS01CP002000 
vlcrow  20-MAR-2001 11:25:53.72 : msg_proc: i : CP process shutdown message 
          received for ACMS01CP004000 
vlcrow  20-MAR-2001 11:26:07.51 : msg_proc: i : CP process shutdown message 
          received for ACMS01CP002000 
vlcrow  20-MAR-2001 11:26:38.34 : msg_proc: i : TSC process shutdown message 
          received for ACMS01TSC001000 
      

This command displays entries from the Remote Manager log on node VLCROW. Only entries that were logged between 11:00 AM and 12:00 PM on March 20, 2001, are displayed. Authorization is performed for the user specified by the logical name ACMS$MGMT_USER, or by proxy if the logical is not defined.

#2

$  ACMSMGR SHOW LOG /SINCE=20-MAR /BEFORE=21-MAR
 
ACMS Remote Management -- Command line utility 
 
ACMS V4.4-0  Log Display                         Time: 18-APR-2001 13:59:20.12 
 
Node   Message 
local  20-MAR-2001 15:13:23.47 : msg_proc: i : CP process shutdown message 
         received for ACMS01CP001000 
local  20-MAR-2001 15:13:25.57 : msg_proc: i : CP process shutdown message 
         received for ACMS01CP004000 
local  20-MAR-2001 15:13:25.88 : msg_proc: i : CP process shutdown message 
         received for ACMS01CP002000 
local  20-MAR-2001 15:13:41.77 : msg_proc: i : CP process shutdown message 
         received for ACMS01CP003000 
local  20-MAR-2001 15:14:14.16 : msg_proc: i : CP process startup message 
         received for ACMS01CP001000 
local  20-MAR-2001 15:14:14.87 : msg_proc: i : CP process startup message 
         received for ACMS01CP002000 
local  20-MAR-2001 16:55:50.92 :      log: i : Log opened 
local  20-MAR-2001 16:55:53.44 : msg_proc: i : Message proc thread 
         initializing 
local  20-MAR-2001 16:55:53.44 : msg_proc: i : Message proc thread starting 
local  20-MAR-2001 16:55:53.44 : msg_proc: i : Message proc thread executing 
local  20-MAR-2001 16:55:54.49 :      sec: f : ACMS$SNMP user has been granted 
         no rights. 
local  20-MAR-2001 16:56:44.20 :      sec: w : User does not hold the proper 
         rights identifer -> vlcrow.zko.dec.com::LT_SUT [305,3] 
local  20-MAR-2001 16:56:44.20 :      rpc: w : Security check failed 
local  20-MAR-2001 17:02:35.17 :      sec: w : User does not hold the proper 
         rights identifer -> vlcrow.zko.dec.com::LT_SUT [305,3] 
local  20-MAR-2001 17:02:35.17 :      rpc: w : Security check failed 
local  20-MAR-2001 17:05:16.46 :      sec: w : User does not hold the proper 
         rights identifer -> vlcrow.zko.dec.com::LT_SUT [305,3] 
local  20-MAR-2001 17:05:16.46 :      rpc: w : Security check failed 
local  20-MAR-2001 17:05:20.53 :      sec: w : User does not hold the proper 
         rights identifer -> vlcrow.zko.dec.com::LT_SUT [305,3] 
local  20-MAR-2001 17:05:20.53 :      rpc: w : Security check failed 
local  20-MAR-2001 17:46:22.40 : msg_proc: i : ACC process startup message 
         received for ACMS01ACC001000 
local  20-MAR-2001 17:46:22.42 : msg_proc: e : Failure getting current 
         collection states. Ignoring process ACMS01ACC001000 
local  20-MAR-2001 17:46:22.85 :  procmon: e : Failure obtaining current 
         collection states. Bypassingtsc 
local  20-MAR-2001 17:46:22.85 :  procmon: e : Failure obtaining current 
         collection states. Bypassingqti 
local  20-MAR-2001 17:46:25.92 : msg_proc: i : TSC process startup message 
         received for ACMS01TSC001000 
      

This command displays entries from the Remote Manager log on node VLCROW. Only entries that were logged between March 20 and 21, 2001, are displayed. Authorization is performed for the user specified by the logical name ACMS$MGMT_USER, or by proxy if the logical is not defined.


Previous Next Contents Index