# 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