Compaq ACMS for OpenVMS
Remote Systems Management Guide


Previous Contents Index

9.7 ACMSCFG SET INTERFACE

Allows Remote Manager interfaces to be enabled or disabled in the configuration file.


Format

ACMSCFG SET INTERFACE [/qualifiers]

Command Qualifier Default
/INTERFACE=interface None
/STATE=keyword DISABLED


Privileges Required

None.

Parameters

None.

Qualifiers

/INTERFACE=interface

This required qualifier determines which interface to modify. Valid values are:

/STATE=[DISABLED, ENABLED]

This qualifier determines the operation to perform. If the value supplied is ENABLED, the interface will be started (if it is not already running). If the value supplied is DISABLED, the interface will be stopped.

Notes

The ACMSMGR uses the RPC interface. Stopping an interface disables communication to the Remote Manager through that interface. Stopping the RPC interface on a given node prevents ACMSMGR from communicating with the Remote Manager on that node.

Examples

#1

$  ACMSCFG SET INTERFACE/INTERFACE=SNMP/STATE=DISABLED
ACMS Remote Management Option -- Command line utility 
Call to modify interface on server sparks was executed 
%ACMSMGMT-S-SUCCESS, Operation completed 
      

This command stops the SNMP interface on the node specified by the logical name ACMS$MGMT_SERVER_NODE.

9.8 ACMSCFG SET PARAMETER

Allows Remote Manager parameters to be updated in the configuration file.

Format

ACMSMGR SET PARAMETER [/qualifiers]

Command Qualifier Default
/DCL_AUDIT_LEVEL=value None
/DCL_MGR_PRIORITY=value None
/DCL_STACKSIZE=value None
/EVENT_LOG_PRIORITY=value None
/LOG_STACKSIZE=value None
/LOGIN_CREDS_LIFETIME=value None
/MAX_LOGINS=value None
/MAX_RPC_RETURN_RECS=value None
/MGR_AUDIT_LEVEL=value None
/MSG_PROC_AUDIT_LEVEL=value None
/MSG_PROC_PRIORITY=value None
/MSG_PROC_STACKSIZE=value None
/MSS_COLL_INTERVAL=value None
/PROC_MON_AUDIT_LEVEL=value None
/PROC_MON_INTERVAL=value None
/PROC_MON_PRIORITY=value None
/PROC_MON_STACKSIZE=value None
/PROXY_CREDS_LIFETIME=value None
/RPC_AUDIT_LEVEL=value None
/RPC_PRIORITY=value None
/RPC_STACKSIZE=value None
/SECURITY_AUDIT_LEVEL=value None
/SNMP_AGENT_TIME_OUT None
/SNMP_ARE_YOU_THERE=value None
/SNMP_AUDIT_LEVEL=value None
/SNMP_PRIORITY=value None
/SNMP_SEL_TIME_OUT=value None
/SNMP_STACKSIZE=value None
/TIMER_AUDIT_LEVEL=value None
/TIMER_INTERVAL=value None
/TIMER_PRIORITY=value None
/TIMER_STACKSIZE=value None
/TOTAL_ENTITY_SLOTS=value None
/TRACE_MSG_WAIT_TIME=value None
/TRACE_START_WAIT_TIME=value None
/TRAP_AUDIT_LEVEL=value None
/TRAP_PRIORITY=value None
/TRAP_STACKSIZE=value None
/WKSP_COLL_INTERVAL=value None


Privileges Required

None.

Parameters

None.

Qualifiers

/[parameter]=value

All qualifiers correspond directly to fields in the Parameter table. See Section 8.8.1 for descriptions of each field.

Notes

See Section 8.8 for a description of each parameter.

Example


$  ACMSCFG SET PARAMETER /MGR_AUDIT_LEVEL=E
      

This command modifies the dynamic parameter field mgr_audit_level.

9.9 ACMSCFG SET TRAP

Updates records in the Trap table in the configuration file.

Format

ACMSCFG SET TRAP [/qualifiers]

Command Qualifier Default
/ENTITY=keyword None
/NAME=[*,entity-name] * (all)
/PARAMETER=keyword EXISTS
/SEVERITY=[I,W,E,F] None
/TRAP_MIN=value None
/TRAP_MAX=value None


Privileges Required

None.

Parameters

None.

Qualifiers

/ENTITY=[*, ACC, CP, EXC, MGR, QTI, TSC]

This required qualifier determines the entity or entities for which a trap should be set.

/NAME=[*,entity-name]

This qualifier specifies particular instances of an entity. Specify the value of the name field for the record you wish to modify.

/PARAMETER=[EVENT_SEVERITY, EXISTS]

The field that should be monitored. Valid values are:

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

A severity to be associated with the trap. Severity codes are embedded in the trap message and must be parsed by the trap receiver. Severities are informational (I), warning (W), error (E), and fatal (F).

/TRAP_MIN=value

This qualifier specifies the minimum allowable value for the parameter being monitored. A trap is generated if the parameter value is less than the minimum value. See Table 8-11 for a list of valid values.

/TRAP_MAX=value

This qualifier specifies the maximum allowable value for the parameter being monitored. A trap is generated if the parameter value is greater than the maximum value. See Table 8-11 for a list of valid values.

Notes

When updating trap records, the combination of entity, name, and parameter must exactly match a record in the trap table.

See Section 8.12.2 for a discussion about setting appropriate trap minimums and maximums. See Section 8.12.3 for a description of the trap message generated.


Examples

#1

$  ACMSCFG SET TRAP /ENTITY=QTI/PARAMETER=EXISTS/TRAP_MAX=0
      

This command causes an SNMP trap to be generated whenever the QTI process is started if the SNMP interface is running.

9.10 ACMSCFG SHOW COLLECTION

Displays Collection table data from the configuration file.

Format

ACMSCFG SHOW COLLECTION


Privileges Required

None.

Parameters

None.

Qualifiers

None.

Notes

See Section 8.3 for a discussion of each field displayed. See Section 4.1 for a discussion of collections.


Examples

#1

$  ACMSCFG SHOW COLLECTION
Entity                                    Entity   Coll     Collection 
Name                                      Type     Class    State 
---------------------------------------------------------------------- 
 *                                         *        id       enabled 
 *                                         *        config   enabled 
      

This command shows the current contents of the Collection table as stored in the configuration file.

9.11 ACMSCFG SHOW CONTROL

Displays the control record from the configuration file.

Format

ACMSCFG SHOW CONTROL


Privileges Required

None.

Parameters

None.

Qualifiers

None.

Notes

The control record is used by the Remote Manager and cannot be modified or deleted. The ACMSCFG SHOW CONTROL command displays the following fields:

Examples

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

9.12 ACMSCFG SHOW INTERFACE

Displays the Remote Manager interface from the configuration file.

Format

ACMSCFG SHOW INTERFACE


Privileges Required

None.

Parameters

None.

Qualifiers

None.

Notes

The Remote Manager supports two interfaces: RPC and SNMP. This command displays the enabled states of each interface.

See Section 8.6 for a discussion of each field displayed.


Examples

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

9.13 ACMSCFG SHOW PARAMETER

Displays Remote Manager parameter information from the configuration file.

Format

ACMSCFG SHOW PARAMETER


Privileges Required

None.

Parameters

None.

Qualifiers

None.

Notes

See Section 8.8 for a description of each parameter.

Examples

#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) 
 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) 
 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) 
 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) 
 wksp_coll_interval      10      10      1     863999999    seconds (D) 
      

This command shows the current contents of the Parameter table in the configuration file.

9.14 ACMSCFG SHOW TRAP

Displays SNMP trap configurations from the configuration file.

Format

ACMSCFG SHOW TRAP


Privileges Required

None.

Parameters

None.

Qualifiers

None.

Notes

SNMP traps are generated only if the SNMP interface is started.

See Section 8.12 for a description of each field displayed.


Examples

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


Chapter 10
ACMSMGR Commands

This chapter provides reference information about the commands for the ACMSMGR utility.

10.1 ACMSMGR Overview

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 3 for a description of how to use ACMSMGR to manage the Remote Manager.

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

10.1.2 Command Objects and Qualifiers

The objects and qualifiers for the ACMSMGR commands are summarized in Table 10-1.

Table 10-1 ACMSMGR Command Objects and Qualifiers
Objects Qualifiers
ADD Command
COLLECTION /CLASS, /COLL_STATE, /ENTITY, /NAME, /NODE, /USER
TRAP /ENTITY, /NAME, /NODE, /PARAMETER, /SEVERITY, /TRAP_MIN, /TRAP_MAX, /USER
DELETE Command
COLLECTION /CLASS, /ENTITY, /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
LOG /NODE, /USER
SET Command
ACC /ACC_PRIORITY, /ACC_USERNAME, /ACTIVE, /AUDIT_STATE, /MAX_APPL, /MSS_MAXOBJ, /MSS_MAXBUF, /MSS_NET_RETRY_TIMER, /MSS_POOLSIZE, /MSS_PROCESS_POOL, /NODE, /NODE_NAME, /STORED, /TWS_POOLSIZE, /TWSC_POOLSIZE, /USER, /USERNAME_DEFAULT, /WS_POOLSIZE, /WSC_POOLSIZE
COLLECTION /CLASS, /COLL_STATE, /ENTITY, /NAME, /NODE, /USER
EXC /APPL, /AUDIT_STATE, /MAX_SERVERS, /MAX_TASKS, /NODE, /SP_MON_INTERVAL, /TRANSACTION_TIMEOUT, /USERNAME
INTERFACE /INTERFACE, /NODE, /STATE, /USER
PARAMETER /DCL_AUDIT_LEVEL, /DCL_MGR_PRIORITY, /DCL_STACKSIZE, /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, /SNMP_AGENT_TIME_OUT, /SNMP_ARE_YOU_THERE, /SNMP_AUDIT_LEVEL, /SNMP_PRIORITY, /SNMP_SEL_TIME_OUT, /SNMP_STACKSIZE, /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, /USERNAME, WKSP_COLL_INTERVAL
QTI /ACTIVE, /MAX_THREADS, /NODE, / POLLING_TIMER, /QTI_PRIORITY, /QTI_USERNAME, /RETRY_TIMER, /STORED, /SUB_TIMEOUT, /USERNAME
SERVER /APPL, /CREATION_DELAY, /CREATION_INTERVAL, /DELETION_DELAY, /DELETION_INTERVAL, /MAX_INSTANCE, /MIN_INSTANCE, /NODE, /SERVER, /SP_DUMP_FLAG, /USERNAME
TRAP /ENTITY, /NAME, /NODE, /PARAMETER, /SEVERITY, /TRAP_MIN, /TRAP_MAX, /USER
TSC /ACTIVE, /CP_USERNAME, /CP_PRIORITY, /CP_SLOTS, /MAX_LOGINS, /MAX_TTS_CP, /MIN_CPIS, /NODE, /PERM_CPS, /STORED, /TSC_PRIORITY, /TSC_USERNAME, /USERNAME
SHOW Command
ACC /ACTIVE, /BRIEF, /CONFIG, /FULL, /ID, /INTERVAL, /NODE, /OUT, /POOL, /RUNTIME, /STORED, /USER
COLLECTION /FULL, /INTERVAL, /NODE, /OUT, /USER
CP /ALL, /BRIEF, /FULL, /ID, /INTERVAL, /NODE, /OUT, /POOL, /RUNTIME, /USER
EXC /ALL, /APPLICATION, /BRIEF, /CONFIG, /FULL, /ID, /INTERVAL, /NODE, /OUT, /POOL, /RUNTIME, /USER
GROUP /ALL, /APPL, /BRIEF, /FULL, /GROUP, /ID, /INTERVAL, /NODE, /OUT, /POOL, /USER
INTERFACE /INTERVAL, /NODE, /OUT, /USER
LOG /BEFORE, /FACILITY, /FILE, /INTERVAL, /LOCAL, /NODE, /OUT, /SEVERITY, /SINCE, /USER
MANAGER /BRIEF, /FULL, /INTERVAL, /NODE, /OUT, /USER
PARAMETER /INTERVAL, /NODE, /OUT, /USER
PROCESS /ALL, /BRIEF, /FULL, /INTERVAL, /NODE, /OUT, /USER
QTI /ACTIVE, /ALL, /BRIEF, /CONFIG, /FULL, /ID, /INTERVAL, /NODE, /OUT, /POOL, /RUNTIME, /STORED, /USER
SERVER /ALL, /APPL, /BRIEF, /CONFIG, /FULL, /ID, /INTERVAL, /NODE, /OUT, /RUNTIME, /SERVER, /USER
TRAP /INTERVAL, /NODE, /OUT, /USER
TSC /ACTIVE, /ALL, /BRIEF, /CONFIG, /FULL, /ID, /INTERVAL, /NODE, /OUT, /POOL, /RUNTIME, /STORED, /USER
USER /FULL, /INTERVAL, /NODE, /OUT, /USER
START Command
EXC /APPL, /NODE, /USER
QTI /NODE, /USER
SYS /NOAUDIT, /NODE, /NOQTI, /NOTERMINALS, /USER
TERMINALS /NODE, /USER
TRACE_MONITOR /NODE, /USER
STOP Command
EXC /APPL, /CANCEL, /NODE, /USER
MANAGER /NODE, /USER
QTI /NODE, /USER
SYS /CANCEL, /NODE, /USER
TERMINALS /NODE, /USER
TRACE_MONITOR /NODE, /USER


Previous Next Contents Index