Compaq ACMS for OpenVMS
Remote Systems Management Guide


Previous Contents Index

10.12 ACMSMGR SET EXC

Makes modifications to running ACMS applications.


Format

ACMSMGR SET EXC [/qualifiers]

Command Qualifier Default
/APPL=application-name None
/AUDIT_STATE=keyword None
/MAX_SERVERS=value None
/MAX_TASKS=value None
/NODE=node-name Translation of logical ACMS$MGMT_SERVER_NODE
/SP_MON_INTERVAL=value None
/TRANSACTION_TIMEOUT=value None
/USER=user-name Translation of logical ACMS$MGMT_USER


Privileges Required

ACMS$MGMT_OPER

Parameters

None.

Qualifiers

/APPL=application-name

The name of the application to be modified.

/AUDIT_STATE=[ENABLED, DISABLED]

This qualifier is equivalent to the ACMSOPER command ACMS/MODIFY APPLICATION /APPL=AUDIT (or /APPL=NOAUDIT if the value is DISABLED).

/MAX_SERVERS=value

This qualifier updates the MAX_SERVERS limit in the running application. Updates are lost when the application is restarted.

/MAX_TASKS=value

This qualifier updates the MAX_TASKS limit in the running application. Updates are lost when the application is restarted.

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

/SP_MON_INTERVAL=value

This qualifier updates the SP_MON_INTERVAL field in the running application. Updates are lost when the application is restarted.

/TRANSACTION_TIME=value

This qualifier updates the TRANSACTION_TIMEOUT default value in the running application. Updates are lost when the application is restarted.

/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 is equivalent to the ACMSOPER command ACMS/MOD APPLICATION. Any changes made to the running system are lost when the application is restarted.

Example


$  ACMSMGR SET EXC/APPL=VR_APPL/SP_MON_INTERVAL=10/MAX_TASKS=50
      

This command modifies the running application VR_APPL.

10.13 ACMSMGR SET INTERFACE

Allows Remote Manager interfaces to be started or stopped.

Format

ACMSMGR SET INTERFACE [/qualifiers]

Command Qualifier Default
/INTERFACE=[RPC,SNMP] Qualifier is required.
/NODE=node-name Translation of logical ACMS$MGMT_SERVER_NODE
/STATE=[ENABLED,DISABLED] DISABLED
/USER=user-name Translation of logical ACMS$MGMT_USER


Privileges Required

ACMS$MGMT_WRITE

Parameters

None.

Qualifiers

/INTERFACE=[RPC, SNMP]

This required qualifier specifies which interface to modify. Only SNMP is supported.

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

/STATE=[ENABLED, DISABLED]

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

/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 allows interfaces to be stopped or started. However, an interface cannot disable itself. Since the ACMSMGR utility uses the RPC interface, it cannot be used to disable the RPC interface.To disable the RPC interface, either use the ACMSCFG utility and restart the Remote Manager, or use the SNMP interface.

The SNMP interface can be both enabled and disabled using this command. It may take several seconds for this command to complete if the SNMP interface is in a non-interruptible state when the command is issued


Example


$  ACMSMGR 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. Authorization is either performed for the user specified by the logical ACMS$MGMT_USER, or is based on an ACMS proxy on the target node if the logical is not defined.

10.14 ACMSMGR SET PARAMETER

Allows Remote Manager parameters to be modified.

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
/NODE=node-name Translation of logical ACMS$MGMT_SERVER_NODE
/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=value 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
/USER=user-name Translation of logical ACMS$MGMT_USER
/WKSP_COLL_INTERVAL=value None


Privileges Required

ACMS$MGMT_WRITE

Parameters

None.

Qualifiers

/parameter=value

All qualifiers except NODE and USER correspond directly to fields in the Parameter table. See Section 8.8.1 for a description of each field.

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

/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

Some parameter changes take effect immediately; others take effect only when the Remote Manager is restarted, and only if they are written to the ACMSCFG file (using the ACMSCFG SET PARAMETER command). Table 8-7 shows which parameters are dynamic and which are not.

For parameters that are not dynamic, you must restart the appropriate facility for the change to take effect. For example, to modify the SNMP_SELECT_TIME_OUT parameter, you must stop and restart the SNMP interface.

See Table 8-7 for a description of each parameter.


Example


$  ACMSMGR SET PARAMETER /MGR_AUDIT_LEVEL=E /NODE=SPARKS /USER=VANPEENEN
ACMS Remote Management Option -- Command line utility 
Call to modify parameters on server sparks was executed 
%ACMSMGMT-S-SUCCESS, Operation completed 
      

This command modifies the dynamic parameter MGR_AUDIT_LEVEL on node SPARKS and specifies that authorization be performed for user VANPEENEN.

10.15 ACMSMGR SET QTI

Makes modifications related to the Queued Task Initiator (QTI).

Format

ACMSMGR SET QTI [/qualifiers]

Command Qualifier Default
/ACTIVE /STORED
/MAX_THREADS=value None
/NODE=node-name Translation of logical ACMS$MGMT_SERVER_NODE
/POLLING_TIMER=value None
/QTI_PRIORITY=value None
/QTI_USERNAME=user-name None
/RETRY_TIMER None
/STORED /STORED
/SUB_TIMEOUT None
/USER=user-name Translation of logical ACMS$MGMT_USER


Privileges Required

ACMS$MGMT_OPER

Parameters

None.

Qualifiers

/ACTIVE

This qualifier causes dynamic ACMSGEN field values to be updated from the current ACMSGEN file. The /ACTIVE qualifier can be specified with the /STORED qualifier. If neither is specified, the default is /STORED. If /ACTIVE is specified alone, no updates are written to the file.

/MAX_THREADS=value

This field corresponds to and updates the ACMSGEN field MAX_THREADS. Because this is a nondynamic ACMSGEN field, the /ACTIVE qualifier has no effect when used with this qualifier. The /STORED qualifier causes the specified value to be stored in the current ACMSGEN file.

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

/POLLING_TIMER=node-name

This field corresponds to and updates the ACMSGEN field QTI_POLLING_TIMER. Because this is a dynamic ACMSGEN field, the /ACTIVE qualifier causes the current value to be modified for the running system. The /STORED qualifier causes the specified value to be stored in the current ACMSGEN file.

QTI_PRIORITY=value

This field corresponds to and updates the ACMSGEN field QTI_PRIORITY. Because this is a nondynamic ACMSGEN field, the /ACTIVE qualifier has no effect when used with this qualifier. The /STORED qualifier causes the specified value to be stored in the current ACMSGEN file.

QTI_USERNAME=user-name

This field corresponds to and updates the ACMSGEN field QTI_USERNAME. Because this is a nondynamic ACMSGEN field, the /ACTIVE qualifier has no effect when used with this qualifier. The /STORED qualifier causes the specified value to be stored in the current ACMSGEN file.

/RETRY_TIMER=value

This field corresponds to and updates the ACMSGEN field QTI_RETRY_TIMER. Because this is a dynamic ACMSGEN field, the /ACTIVE qualifier causes the current value to be modified for the running system. The /STORED qualifier causes the specified value to be stored in the current ACMSGEN file.

/STORED

This qualifier causes ACMSGEN file updates to be written and saved in the current ACMSGEN file. The /STORED qualifier can be specified with the /ACTIVE qualifier. If neither is specified, the default is /STORED. If /ACTIVE is specified alone, no updates are written to the file.

/SUB_TIMEOUT=value

This field corresponds to and updates the ACMSGEN field QTI_SUB_TIMEOUT. Because this is a dynamic ACMSGEN field, the /ACTIVE qualifier causes the current value to be modified for the running system. The /STORED qualifier causes the specified value to be stored in the current ACMSGEN 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 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 allows you to remotely update either the running ACMS system or the current ACMSGEN file.

The /ACTIVE and /STORED qualifiers control how updates are posted to ACMSGEN. The /ACTIVE and /STORED qualifiers have no effect on the /AUDIT_STATE qualifier, which is processed independently of any ACMSGEN updates.


Examples

#1

$  ACMSMGR SET QTI /NODE=SPARKS/QTI_SUB_TIMEOUT=5000/ACTIVE/STORED
      

This command modifies the ACMSGEN field qti_sub_timeout on node SPARKS, updates the active system, and saves the change in the file.

#2

$  ACMSMGR SET QTI /NODE=SPARKS/QTI_SUB_TIMEOUT=5000/ACTIVE
      

This command modifies the ACMSGEN field qti_sub_timeout on node SPARKS and updates the active system only. The change is not saved in the ACMSGEN file.

#3

$  ACMSMGR SET ACC /NODE=SPARKS/QTI_SUB_TIMEOUT=5000/STORED
      

This command modifies the ACMSGEN field qti_sub_timeout on node SPARKS and saves the change in the ACMSGEN file. The active system is not updated.

10.16 ACMSMGR SET SERVER

Makes modifications to servers running in ACMS applications.

Format

ACMSMGR SET SERVER [/qualifiers]

Command Qualifier Default
/APPL=[*,application-name] * (all)
/CREATION_DELAY=value None
/CREATION_INTERVAL=value None
/DELETION_DELAY=value None
/DELETION_INTERVAL=value None
/MAX_INSTANCE=value None
/MIN_INSTANCE=value None
/NODE=node-name Translation of logical ACMS$MGMT_SERVER_NODE
/SERVER=[*,server-name] * (all)
/SP_DUMP_FLAG=
[ENABLED,DISABLED] None
/USER=user-name Translation of logical ACMS$MGMT_USER


Privileges Required

ACMS$MGMT_OPERATE

Parameters

None.

Qualifiers

/APPL=application-name

The name of the application to be modified. If this qualifier is not specified, modifications are applied to all applications.

/CREATION_DELAY=value

This qualifier updates the CREATION_DELAY for the specified server in the running application. Updates are lost when the application is restarted.

/CREATION_INTERVAL=value

This qualifier updates the CREATION_INTERVAL for the specified server in the running application. Updates are lost when the application is restarted.

/DELETION_DELAY=value

This qualifier updates the DELETION_DELAY for the specified server in the running application. Updates are lost when the application is restarted.

/DELETION_INTERVAL=value

This qualifier updates the DELETION_INTERVAL for the specified server in the running application. Updates are lost when the application is restarted.

/MAX_INSTANCE=value

This qualifier updates the MAX_INSTANCE limit for the specified server in the running application. Updates are lost when the application is restarted.

/MIN_INSTANCE=value

This qualifier updates the MIN_INSTANCE limit for the specified server in the running application. Updates are lost when the application is restarted.

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

/SERVER=server-name

This qualifier specifies the name of the server to be modified. If this qualifier is not specified, all servers in the application are modified.

/SP_DUMP_FLAG=value

This qualifier updates the SP_DUMP_FLAG for the specified server in the running application. Updates are lost when the application is restarted.

/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 is equivalent to the ACMSOPER command ACMS/MOD APPLICATION/SERVER. Any changes made to the running system are lost when the application is restarted.

Example


$  ACMSMGR SET SERVER/APPL=VR_APPL/SERVER=VR_READ_SERVER/SP_DUMP_FLAG=ENABLED
      

This command modifies the SP_DUMP_FLAG field for the server VR_READ_SERVER running in the VR_APPL application.


Previous Next Contents Index