Previous | Contents | Index |
Allows Remote Manager interfaces to be enabled or disabled in the configuration file.
ACMSCFG SET INTERFACE [/qualifiers]
Command Qualifier Default /INTERFACE=interface None /STATE=keyword DISABLED
None.
None.
/INTERFACE=interface
This required qualifier determines which interface to modify. Valid values are:
- RPC
- SNMP
/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.
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.
#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.
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
None.
None.
/[parameter]=value
All qualifiers correspond directly to fields in the Parameter table. See Section 8.8.1 for descriptions of each field.
See Section 8.8 for a description of each parameter.
$ 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.
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
None.
None.
/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:
- EVENT_SEVERITY
This parameter is used for monitoring internal Remote Manager events. The Remote Manager logs internal events in the Remote Manager log. (See Section 3.7 and Section 10.25 for discussions of the Remote Manager log.) Traps can be generated based on the severity levels of these events.- EXISTS
This parameter is used for monitoring process existence. Traps are generated if the associated entity type and name either starts or stops./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.
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.
#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.
ACMSCFG SHOW COLLECTION
None.
None.
None.
See Section 8.3 for a discussion of each field displayed. See Section 4.1 for a discussion of collections.
#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.
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.
9.12 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 8.6 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.
9.13 ACMSCFG SHOW PARAMETER
Displays Remote Manager parameter information from the configuration
file.
ACMSCFG SHOW PARAMETER
None.
None.
None.
See Section 8.8 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) 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.
ACMSCFG SHOW TRAP
None.
None.
None.
SNMP traps are generated only if the SNMP interface is started.See Section 8.12 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.
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.
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 |