| Previous | Contents | Index |
Displays the control record from the configuration file.
ACMSCFG SHOW CONTROL
None.
None.
None.
The control record is used by the Remote Manager and cannot be modified or deleted. The ACMSCFG SHOW CONTROL command displays the following fields:
- Interface count --- Number of interface records in the file.
- Collection count --- Number of collection records in the file.
- Timer count --- Number of timer records in the file.
- Trap count --- Number of trap records in the file.
- Parameter count --- Number of parameter records in the file.
- Version --- Internal file version identifier.
| #1 |
|---|
$ ACMSCFG SHOW CONTROL
Record Counts
Record type Count
------------ -------
Interface 2
Collection 2
Timer 1
Trap 1
Parameter 1
Version 6
|
This command shows the current contents of the control record in the configuration file.
10.13 ACMSCFG SHOW INTERFACE
Displays the Remote Manager interface from the configuration file.
ACMSCFG SHOW INTERFACE
None.
None.
None.
The Remote Manager supports two interfaces: RPC and SNMP. This command displays the enabled states of each interface.See Section 9.7 for a discussion of each field displayed.
| #1 |
|---|
$ ACMSCFG SHOW INTERFACE
Interface Enable
Type State
--------------------------------------------------------
rpc enabled
snmp enabled
|
This command shows the current contents of the Interfaces table in the configuration file. As shown, both interfaces are started when the Remote Manager is started.
10.14 ACMSCFG SHOW PARAMETER
Displays Remote Manager parameter information from the configuration
file.
ACMSCFG SHOW PARAMETER
None.
None.
None.
See Section 9.9 for a description of each parameter.
| #1 |
|---|
$ ACMSCFG SHOW PARAMETER
Management Parameters
Parameter Value Default Min Max (D)ynamic
------------------------------------------------------------------------
dcl_audit_level E E 0 F (D)
dcl_mgr_priority 5 5 1 10
dcl_stacksize 300 300 1 2147483647 k (Vax), 8k (Alpha)
error_interval 10 10 1 863999999 seconds (D)
event_log_priority 5 5 1 10
log_stacksize 300 300 1 2147483647 K (Vax), 8k (Alpha)
login_creds_lifetime 60 60 1 14399999 minutes (D)
max_logins 20 20 1 2147483647 (D)
max_rpc_return_recs 20 20 1 2147483647
mgr_audit_level E E 0 F (D)
msg_proc_audit_level E E 0 F (D)
msg_proc_priority 5 5 1 10
msg_proc_stacksize 300 300 1 2147483647 k (Vax), 8k (Alpha)
mss_coll_interval 10 10 1 863999999 seconds (D)
proc_mon_audit_level E E 0 F (D)
proc_mon_interval 30 30 1 14399999 seconds (D)
proc_mon_priority 5 5 1 10
proc_mon_stacksize 300 300 1 2147483647 K (Vax), 8k (Alpha)
proxy_creds_lifetime 60 60 1 14399999 minutes (D)
rpc_audit_level E E 0 F (D)
rpc_priority 5 5 1 10
rpc_stacksize 300 300 1 2147483647 k (Vax), 8k (Alpha)
security_audit_level E E 0 F (D)
snap_audit_level E E 0 F (D)
snap_priority 5 5 1 10
snap_stacksize 30 30 1 2147483647 k (Vax), 8k (Alpha)
snmp_agent_time_out 10 10 1 863999999 seconds
snmp_are_you_there 300 300 2 863999999 seconds
snmp_audit_level E E 0 F (D)
snmp_priority 5 5 1 10
snmp_sel_time_out 5 5 1 863999999 seconds
snmp_stacksize 300 300 1 2147483647 k (Vax), 8k (Alpha)
tcp_enabled 1 1 0 1 [0,1] 1=enabled
timer_audit_level E E 0 F (D)
timer_interval 30 30 1 863999999 seconds (D)
timer_priority 5 5 1 10
timer_stacksize 300 300 1 2147483647 k (Vax), 8k (Alpha)
total_entity_slots 20 20 1 2147483647
trace_msg_wait_time 5 5 1 14399999 seconds (D)
trace_start_wait_time 5 5 1 14399999 seconds (D)
trap_audit_level E E 0 F (D)
trap_priority 5 5 1 10
trap_stacksize 300 300 1 2147483647 k (Vax), 8k (Alpha)
udp_enabled 1 1 0 1 [0,1] 1=enabled
vms_coll_interval 10 10 0 863999999 seconds (D)
wksp_coll_interval 10 10 1 863999999 seconds (D)
|
This command shows the current contents of the Parameter table in the configuration file.
10.15 ACMSCFG SHOW TRAP
Displays SNMP trap configurations from the configuration file.
ACMSCFG SHOW TRAP
None.
None.
None.
SNMP traps are generated only if the SNMP interface is started.See Section 9.13 for a description of each field displayed.
| #1 |
|---|
$ ACMSCFG SHOW TRAP
Entity Entity
Type Name Parameter Min Max Severity
------- ----------------------- ---------------- ------- -------- --------
* * exists 1 -1 i
|
This command shows the current contents of the Trap table in the configuration file. As shown, a single trap has been configured to send an informational trap when any ACMS process is stopped. This is the default configuration.
This chapter provides reference information about the commands for the ACMSMGR utility.
The ACMSMGR utility is used to perform operations on running ACMS systems.
You can use the ACMSMGR utility to perform the following functions:
The ACMSMGR utility uses the ACMS management interface, which is based on ONC RPC. Commands can be executed remotely from any node in the network, and many commands can be executed against more than one node.
See Chapter 4 for a description of how to use ACMSMGR to manage the
Remote Manager.
11.1.1 Command Format
The format for ACMSMGR commands is as follows:
ACMSMGR verb object qualifiers |
The following verbs are supported:
Each verb has an associated object and set of qualifiers.
11.1.2 Command Objects and Qualifiers
The objects and qualifiers for the ACMSMGR commands are summarized in Table 11-1.
| Objects | Qualifiers |
|---|---|
| ADD Command | |
| COLLECTION | /CLASS, /COLL_STATE, /ENTITY, /NAME, /NODE, /STORAGE_END_TIME, /STORAGE_INTERVAL, /STORAGE_LOCATION, /STORAGE_START_TIME, /STORAGE_STATE, /USER |
| FILTER | /CODE, /FILE, /NAME, /NODE, /USER |
| TRAP | /ENTITY, /NAME, /NODE, /PARAMETER, /SEVERITY, /TRAP_MIN, /TRAP_MAX, /USER |
| DELETE Command | |
| COLLECTION | /CLASS, /ENTITY, /NAME, /NODE, /USER |
| FILTER | /CODE, /NAME, /NODE, /USER |
| TRAP | /ENTITY, /NAME, /NODE, /PARAMETER, /USER |
| HELP Command | |
| None | None |
| LOGIN Command | |
| None | /NODE, /PASSWORD, /USER |
| LOGOUT Command | |
| None | /NODE, /USER |
| REPLACE Command | |
| SERVER | /APPLICATION, /NODE, /SERVER, /USER |
| RESET Command | |
| ERROR | /NODE, /USER |
| LOG | /NODE, /USER |
| SAVE Command | |
| FILTER | /FILE, /NODE, /USER |
| SET Command | |
| ACC | /ACC_PRIORITY, /ACC_USERNAME, /ACTIVE, /ASTLM, /AUDIT_STATE, /BIOLM, /BYTLM, /CHANNELCNT, /DIOLM, /ENQLM, /FILLM, /GBLPAGES, /GBLPAGFIL, /GBLSECTIONS, /LOG, /MAX_APPL, /MSS_MAXBUF, /MSS_MAXOBJ, /MSS_NET_RETRY_TIMER, /MSS_POOLSIZE, /MSS_PROCESS_POOL, /NODE, /NODE_NAME, /PGFLQUOTA, /STORED, /TQELM, /TWS_POOLSIZE, /TWSC_POOLSIZE, /USER, /USERNAME_DEFAULT, /WS_POOLSIZE, /WSC_POOLSIZE, /WSDEFAULT, /WSEXTENT, /WSQUOTA |
| COLLECTION | /CLASS, /COLL_STATE, /ENTITY, /NAME, /NODE, /STORAGE_END_TIME, /STORAGE_INTERVAL, /STORAGE_LOCATION, /STORAGE_START_TIME, /STORAGE_STATE, /USER |
| CP | /ASTLM, /BIOLM, /BYTLM, /DIOLM, /ENQLM, /FILLM, /LOG /PGFLQUOTA, /TQELM, /WSEXTENT, /WSDEFAULT, /WSQUOTA |
| EXC | /ACTIVE, /APPLICATION, /ASTLM, /AUDIT_STATE, /BIOLM, /BYTLM, /DIOLM, /ENQLM, /FILLM, /LOG, /MAX_SERVERS, /MAX_TASKS, /NODE, /PGFLQUOTA, /SP_MON_INTERVAL, /STORED, /TQELM, /TRANSACTION_TIMEOUT, /USERNAME, /WSEXTENT, /WSDEFAULT, /WSQUOTA |
| INTERFACE | /INTERFACE, /NODE, /STATE, /USER |
| PARAMETER | /DCL_AUDIT_LEVEL, /DCL_MGR_PRIORITY, /DCL_STACKSIZE, /ERROR_INTERVAL /EVENT_LOG_PRIORITY, /LOG_STACKSIZE, /LOGIN_CREDS_LIFETIME, /MAX_LOGINS, /MAX_RPC_RETURN_RECS, /MGR_AUDIT_LEVEL, /MSG_PROC_AUDIT_LEVEL, /MSG_PROC_PRIORITY, /MSG_PROC_STACKSIZE, /MSS_COLL_INTERVAL, /NODE, /PROC_MON_AUDIT_LEVEL, /PROC_MON_INTERVAL, /PROC_MON_PRIORITY, /PROC_MON_STACKSIZE, /PROXY_CREDS_LIFETIME, /RPC_AUDIT_LEVEL, /RPC_PRIORITY, /RPC_STACKSIZE, /SECURITY_AUDIT_LEVEL, /SNAP_AUDIT_LEVEL, /SNAP_PRIORITY, /SNAP_STACKSIZE, /SNMP_AGENT_TIME_OUT, /SNMP_ARE_YOU_THERE, /SNMP_AUDIT_LEVEL, /SNMP_PRIORITY, /SNMP_SEL_TIME_OUT, /SNMP_STACKSIZE, /TCP_ENABLED, /TIMER_AUDIT_LEVEL, /TIMER_INTERVAL, /TIMER_PRIORITY, /TIMER_STACKSIZE, /TOTAL_ENTITY_SLOTS, /TRACE_MSG_WAIT_TIME, /TRACE_START_WAIT_TIME, /TRAP_AUDIT_LEVEL, /TRAP_PRIORITY, /TRAP_STACKSIZE, /UDP_ENABLED, /USER, /VMS_COLL_INTERVAL, WKSP_COLL_INTERVAL |
| QTI | /ACTIVE, /ASTLM, /BIOLM, /BYTLM, /DIOLM, /ENQLM, /FILLM, /LOG, /NODE, /PGFLQUOTA, /POLLING_TIMER, /QTI_PRIORITY, /QTI_USERNAME, /RETRY_TIMER, /STORED, /SUB_TIMEOUT, /TQELM, /WSEXTENT, /WSDEFAULT, /WSQUOTA, /USER |
| SERVER | /APPLICATION, /CREATION_DELAY, /CREATION_INTERVAL, /DELETION_DELAY, /DELETION_INTERVAL, /LOG, /MAX_INSTANCE, /MIN_INSTANCE, /NODE, /SERVER, /SP_DUMP_FLAG, /USER |
| TRAP | /ENTITY, /NAME, /NODE, /PARAMETER, /SEVERITY, /TRAP_MIN, /TRAP_MAX, /USER |
| TSC | /ACTIVE, /ASTLM, /BIOLM, /BYTLM, /CP_PRIORITY, /CP_SLOTS, /CP_USERNAME, /DIOLM, /ENQLM, /FILLM, /LOG, /MAX_LOGINS, /MAX_TTS_CP, /MIN_CPIS, /NODE, /PERM_CPS, /PGFLQUOTA, /STORED, /TQELM, /TSC_PRIORITY, /TSC_USERNAME, /USER, /WSEXTENT, /WSDEFAULT, /WSQUOTA |
| SHOW Command | |
| ACC | /ACTIVE, /BRIEF, /CONFIG, /ERROR, /FULL, /ID, /INTERVAL, /NODE, /OUT, /POOL, /RUNTIME, /STORED, /USER |
| COLLECTION | /BRIEF, /FULL, /INTERVAL, /NODE, /OUT, /USER |
| CP | /ACTIVE, /ALL, /BRIEF, /CONFIG, /ERROR, /FULL, /ID, /INTERVAL, /NODE, /OUT, /POOL, /PROCESS_NAME, /RUNTIME, /STORED, /USER |
| ERROR | /BEFORE, /FILENAME, /INTERVAL, /LOCAL, /NODE, /OUT, /SEVERITY, /SINCE, /USER |
| EXC | /ACTIVE, /ALL, /APPLICATION, /BRIEF, /CONFIG, /ERROR, /FULL, /ID, /INTERVAL, /NODE, /OUT, /POOL, /RUNTIME, /STORED, /USER |
| FILTER | /NODE, /USER |
| GROUP | /APPLICATION, /BRIEF, /FULL, /GROUP, /ID, /INTERVAL, /NODE, /OUT, /POOL, /USER |
| INTERFACE | /INTERVAL, /NODE, /OUT, /USER |
| LOG | /BEFORE, /FACILITY, /FILENAME, /INTERVAL, /LOCAL, /NODE, /OUT, /SEVERITY, /SINCE, /USER |
| MANAGER | /INTERVAL, /NODE, /OUT, /USER |
| PARAMETER | /INTERVAL, /NODE, /OUT, /USER |
| PROCESS | /ALL, /BRIEF, /FULL, /INTERVAL, /NODE, /OUT, /USER |
| QTI | /ACTIVE, /ALL, /BRIEF, /CONFIG, /ERROR, /FULL, /ID, /INTERVAL, /NODE, /OUT, /POOL, /RUNTIME, /STORED, /USER |
| SERVER | /APPLICATION, /BRIEF, /CONFIG, /FULL, /ID, /INTERVAL, /NODE, /OUT, /RUNTIME, /SERVER, /USER |
| TRAP | /INTERVAL, /NODE, /OUT, /USER |
| TSC | /ACTIVE, /ALL, /BRIEF, /CONFIG, /ERROR, /FULL, /ID, /INTERVAL, /NODE, /OUT, /POOL, /RUNTIME, /STORED, /USER |
| USER | /BRIEF, /FULL, /INTERVAL, /NODE, /OUT, /USER |
| VERSION | None. |
| START Command | |
| EXC | /APPLICATION, /NODE, /USER |
| QTI | /NODE, /USER |
| SYS | /NOAUDIT, /NODE, /QTI, /NOTERMINALS, /USER |
| TERMINALS | /NODE, /USER |
| TRACE_MONITOR | /NODE, /USER |
| STOP Command | |
| EXC | /APPLICATION, /CANCEL, /NODE, /USER |
| MANAGER | /NODE, /USER |
| QTI | /NODE, /USER |
| SYS | /CANCEL, /NODE, /USER |
| TERMINALS | /NODE, /USER |
| TRACE_MONITOR | /NODE, /USER |
11.2 ACMSMGR ADD COLLECTION
Adds records to the Collection table.
ACMSMGR ADD COLLECTION [/qualifiers]
Command Qualifier Default /CLASS=class-name * (all) /COLL_STATE=keyword DISABLED /ENTITY=keyword Qualifier is required /NAME=[*,entity-name] * (all) /NODE=node-name Translation of logical ACMS$MGMT_SERVER_NODE /STORAGE_END_TIME=[NEVER, NEVER; run until DISABLED time]++/ /STORAGE_INTERVAL=value++ 300 /STORAGE_LOCATION=file-name++ Translation of logical ACMS$MGMT_SNAPSHOT /STORAGE_START_TIME=[NOW, NOW; start as soon as ENABLED time]++/ /STORAGE_STATE=keyword++ DISABLED /USER=user-name Translation of logical ACMS$MGMT_USER
ACMS$MGMT_WRITE
None.
/CLASS=[*, ERROR, POOL, RUNTIME]
This qualifier specifies the class to be enabled or disabled. The default is * (all). See Section 5.1.1 for a description of each class type./COLL_STATE=[ENABLED, DISABLED]
This qualifier specifies the state of the collection. The default is DISABLED. When a SHOW entity command is issued, data for those classes that have their collection state set to ENABLED is displayed. Note that while the collection state is DISABLED, the data displayed for an entity may not be accurate. Data cannot be written to the data snapshot file when this qualifier is DISABLED, even when the storage state is ENABLED./ENTITY=[*, ACC, CP, EXC, GROUP, QTI, SERVER, TSC]
This required qualifier specifies the entity for which collection should be enabled or disabled./NAME=[*, entity-name]
This qualifier specifies particular instances of an entity. Wildcards (*) are allowed in names.For ACC, CP, QTI, and TSC entity types, the entity name is the process name. For the EXC entity type, the entity name is the name of the application (for example, VR_APPL).
Server and task group names can be specified as compound names made up of an application name and a server or task group name, separated by a period (for example, VR_APPL.VR_READ_SERVER). Either part of server or task group names can be a wildcard (for example, *.VR_READ_SERVER or VR_APPL.*). If only one part of a server or task group name is specified, it is assumed to be the application name, and the server or task group name is wildcarded. For example, VR_APPL is equivalent to VR_APPL.*.
The default is all (*), which is equivalent to *.* for a compound name.
/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.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.
/STORAGE_END_TIME=[NEVER, time]
This qualifier specifies a time after which the collection data should no longer be written to the snapshot file. 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 default keyword of NEVER is applied, which equates to the OpenVMS zero date of 17-NOV-1858 00:00:00.00. With a value of NEVER, collection data continues to be written to the snapshot file until the storage state is set to DISABLED./STORAGE_INTERVAL=value
This qualifier controls the frequency (in seconds) at which data snapshots are performed. The default value is 300 seconds.The storage interval value should be a multiple of the timer interval parameter (SET PARAMETER/TIMER_INTERVAL). The timer interval value determines the minimum elapsed time for many Remote Manager parameters, including the storage interval setting. The relationship of these values determine how often data snapshots are performed, for example:
- If the timer interval value is greater, its value is used by default. For instance, if the timer interval is 10 and the storage interval is 5, snapshots will be written at 10 second intervals.
- If the storage interval value is greater and is a multiple of the timer interval, the storage interval value is used. For example, if the timer interval is 10 and the storage interval is 30, snapshots will be written at 30 second intervals.
- If the storage interval value is greater and is not a multiple of the timer interval, the next multiple of the timer interval value is used. For example, if the timer interval is 10 and the storage interval is 15, snapshots will be written at 20 second intervals.
/STORAGE_LOCATION=file-name
This qualifier specifies an OpenVMS file specification to which collection data is to be written. The format of file-name is a valid OpenVMS pathname or logical (such as DISK$1:[SYSTEM.SNAPSHOTS] or SYS$SYSTEM:SNAPSHOTS.DAT).If the /STORAGE_LOCATION qualifier is not specified, the ACMSMGR utility checks for the presence of the logical name ACMS$MGMT_SNAPSHOT. If the logical is defined, the value of the logical is used by default. If a directory is not provided as part of the specification, the file is written to the default directory of the account under which the Remote Manager process is running.
Multiple collections can share a single snapshot file or be stored in separate files. For continuity, Compaq recommends that EXC, Server, and Task Group collection information be written to the same snapshot file.
/STORAGE_START_TIME=[NOW, time]
This qualifier specifies a time after which the collection data should be written to the snapshot file. 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 default keyword of NOW is applied, which equates to the OpenVMS zero date of 17-NOV-1858 00:00:00.00. With a value of NOW, collection data is written to the snapshot file immediately, or as soon as the storage state is set to ENABLED./STORAGE_STATE=[ENABLED, DISABLED]
This qualifier specifies the state of the data snapshots. If this qualifier is not specified, data snapshots are disabled by default. To fully enable data snapshots, both the storage state and the collection state (/COLL_STATE) must be set to ENABLED./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.
When adding new collection records, the combination of class, entity, and name must be unique.It is not possible to add records for the ID and CONFIG class. By default, all ACMS processes collect ID and CONFIG class data.
Note
++ Only for use on systems running ACMS Version 4.4 or higher.
Previous Next Contents Index