Compaq ACMS for OpenVMS
Remote Systems Management Guide


Previous Contents Index

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

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

11.20 ACMSMGR SET PARAMETER

Allows Remote Manager parameters to be modified.

Format

ACMSMGR SET PARAMETER [/qualifiers]

Command Qualifier Default
/DCL_AUDIT_LEVEL=value See /parameter.
/DCL_MGR_PRIORITY=value See /parameter.
/DCL_STACKSIZE=value See /parameter.
/ERROR_INTERVAL=value++ See /parameter.
/EVENT_LOG_PRIORITY=value See /parameter.
/LOG_STACKSIZE=value See /parameter.
/LOGIN_CREDS_LIFETIME=value See /parameter.
/MAX_LOGINS=value See /parameter.
/MAX_RPC_RETURN_RECS=value See /parameter.
/MGR_AUDIT_LEVEL=value See /parameter.
/MSG_PROC_AUDIT_LEVEL=value See /parameter.
/MSG_PROC_PRIORITY=value See /parameter.
/MSG_PROC_STACKSIZE=value See /parameter.
/MSS_COLL_INTERVAL=value See /parameter.
/NODE=node-name Translation of logical ACMS$MGMT_SERVER_NODE
/PROC_MON_AUDIT_LEVEL=value See /parameter.
/PROC_MON_INTERVAL=value See /parameter.
/PROC_MON_PRIORITY=value See /parameter.
/PROC_MON_STACKSIZE=value See /parameter.
/PROXY_CREDS_LIFETIME=value See /parameter.
/RPC_AUDIT_LEVEL=value See /parameter.
/RPC_PRIORITY=value See /parameter.
/RPC_STACKSIZE=value See /parameter.
/SECURITY_AUDIT_LEVEL=value See /parameter.
/SNAP_AUDIT_LEVEL=value++ See /parameter.
/SNAP_PRIORITY=value++ See /parameter.
/SNAP_STACKSIZE=value++ See /parameter.
/SNMP_AGENT_TIME_OUT=value See /parameter.
/SNMP_ARE_YOU_THERE=value See /parameter.
/SNMP_AUDIT_LEVEL=value See /parameter.
/SNMP_PRIORITY=value See /parameter.
/SNMP_SEL_TIME_OUT=value See /parameter.
/SNMP_STACKSIZE=value See /parameter.
/TCP_ENABLED++ See /parameter.
/TIMER_AUDIT_LEVEL=value See /parameter.
/TIMER_INTERVAL=value See /parameter.
/TIMER_PRIORITY=value See /parameter.
/TIMER_STACKSIZE=value See /parameter.
/TOTAL_ENTITY_SLOTS=value See /parameter.
/TRACE_MSG_WAIT_TIME=value See /parameter.
/TRACE_START_WAIT_TIME=value See /parameter.
/TRAP_AUDIT_LEVEL=value See /parameter.
/TRAP_PRIORITY=value See /parameter.
/TRAP_STACKSIZE=value See /parameter.
/UDP_ENABLED++ See /parameter.
/USER=user-name Translation of logical ACMS$MGMT_USER
/VMS_COLL_INTERVAL=value++ See /parameter.
/WKSP_COLL_INTERVAL=value See /parameter.

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 9.9.1 for a description of each field. For a listing of the current default, minimum, and maximum values, use the SHOW PARAMETER command.

/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

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 9-8 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 9-8 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.

Note

++ Only for use on systems running ACMS Version 4.4 or higher.

11.21 ACMSMGR SET QTI

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


Format

ACMSMGR SET QTI [/qualifiers]

Command Qualifier Default
/ACTIVE /STORED
/ASTLM=value++ None. See /process-quota.
/BIOLM=value++ None. See /process-quota.
/BYTLM=value++ None. See /process-quota.
/DIOLM=value++ None. See /process-quota.
/ENQLM=value++ None. See /process-quota.
/FILLM=value++ None. See /process-quota.
/LOG None
/NODE=node-name Translation of logical ACMS$MGMT_SERVER_NODE
/PGFLQUOTA=value++ None. See /process-quota.
/POLLING_TIMER=value None
/QTI_PRIORITY=value None
/QTI_USERNAME=user-name None
/RETRY_TIMER None
/STORED /STORED
/SUB_TIMEOUT None
/TQELM=value++ None. See /process-quota.
/USER=user-name Translation of logical ACMS$MGMT_USER
/WSDEFAULT=value++ None. See /process-quota.
/WSEXTENT=value++ None. See /process-quota.
/WSQUOTA=value++ None. See /process-quota.

Privileges Required

ACMS$MGMT_OPER

Parameters

None.

Qualifiers

/process-quota=value

These qualifiers correspond to and update the related process quota fields in the system user authorization (SYSUAF) record for the user specified by QTI_USERNAME. Updated quota values apply to the next process that is created.

Because these qualifiers control the nondynamic values for the related process quota fields, the /ACTIVE qualifier cannot be specified. The /STORED qualifier causes the specified values to be stored in the current SYSUAF.DAT file.

For information on using AUTHORIZE to modify process quotas, see the OpenVMS System Manager's Manual. For more information about the individual quotas and their values, see OpenVMS System Management Utilities Reference Manual: A--L or access the online help for AUTHORIZE.

/ACTIVE

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

/LOG

This qualifier causes status information for the current SET transaction to be displayed to the terminal (SYS$OUTPUT). This qualifier is useful when setting multiple values; a separate status message is displayed for each value that is set.

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

/POLLING_TIMER=node-name

This qualifier 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 qualifier corresponds to and updates the ACMSGEN field QTI_PRIORITY. Because this is a nondynamic ACMSGEN field, the /ACTIVE qualifier cannot be specified with this qualifier. The /STORED qualifier causes the specified value to be stored in the current ACMSGEN file.

/QTI_USERNAME=user-name

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

/RETRY_TIMER=value

This qualifier 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 field updates to be written and saved in the current ACMSGEN file. The /STORED qualifier cannot be specified on the same command as the /ACTIVE qualifier. If neither is specified, the default is /STORED.

/SUB_TIMEOUT=value

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

#2

$  ACMSMGR SET QTI /NODE=SPARKS/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.

Note

++ Only for use on systems running ACMS Version 4.4 or higher.

11.22 ACMSMGR SET SERVER

Makes modifications to servers running in ACMS applications.


Format

ACMSMGR SET SERVER [/qualifiers]

Command Qualifier Default
/APPLICATION=[*,application-name] * (all)
/CREATION_DELAY=value None
/CREATION_INTERVAL=value None
/DELETION_DELAY=value None
/DELETION_INTERVAL=value None
/LOG 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_OPER

Parameters

None.

Qualifiers

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

/LOG

This qualifier causes status information for the current SET transaction to be displayed to the terminal (SYS$OUTPUT). This qualifier is useful when setting multiple values; a separate status message is displayed for each value that is set.

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

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