# Compaq ACMS for OpenVMS
Remote Systems Management Guide

Previous | Contents | Index

# 11.8 ACMSMGR HELP

Displays help information about the ACMS Remote Manager Client (ACMSMGR) and its commands.

## Format

> ### ACMSMGR HELP

## Privileges Required

> None.

## Parameters

> None.

## Qualifiers

> ###

> None.

## Notes

> Online help is available for each ACMSMGR command. Each help topic summarizes the valid syntax, abbreviations, parameters, and qualifiers for a particular command and also inidicates all default and required values.

> For a comprehensive list of ACMS utilities that offer online help or for further instructions on how to invoke help, see ACMS Help.

## Examples

#1
    $  ACMSMGR HELP

> This command invokes online help for the ACMSMGR utility and displays a list of available topics.

# 11.9 ACMSMGR LOGIN

Logs in to a server on one or more nodes.

## Format

> ### ACMSMGR LOGIN [/qualifiers]

> Command Qualifier | Default
> --- | ---
> /NODE=node-name | Translation of logical ACMS$MGMT_SERVER_NODE
> /PASSWORD=password | None
> /USER=user-name | Translation of logical ACMS$MGMT_USER

## Privileges Required

> ACMS$MGMT_READ

## Parameters

> None.

## Qualifiers

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

> ### /PASSWORD=password

> This qualifier specifies the password of the OpenVMS account on the server node to log in as. It is sent encrypted to the server node for verification.

> If the /PASSWORD parameter is not specified, the ACMSMGR will prompt the user for a password. Login will not be attempted without a password.

> ### /USER=user-name

> This qualifier specifies the name of the OpenVMS account on the server node on which to log in.

> 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 prompts the user for a user name. Login cannot be attempted without a user name.

## Notes

> In order to access any remote management functions, a valid login is required if proxy access is not enabled or if proxy accounts have not been set up.

> A credentials file is created for each node logged in to. Credentials files are specific for a user, process, and node. In addition, a separate credentials file is created for each combination of user name and node. Subsequent ACMSMGR commands pass the authentication information in the appropriate credentials file to the Remote Manager server, which then performs function authorization. Users determine which credentials are used either by using the /USER qualifier or by defining the ACMS$MGMT_USER logical.

> For example, suppose user BOB on node CLIENT logs in to node SERV1 as ACMS_ADMIN. Also, suppose user BOB on node CLIENT logs in to node SERV2 as ACMS_USER. BOB will have two active logins (two credentials files). He can specify which one to use by either defining the logical ACMS$MGMT_USER, or specifying a user name using the /USER qualifier.

> Logins are valid for the duration of the login_credentials_lifetime parameter (specified using the ACMSMGR SET PARAMETER command).

> See Section 4.4 for a complete discussion of how logins are processed and how credentials files are handled.

## Examples

#1
    $  ACMSMGR LOGIN /NODE=SPARKS /USER=VANPEENEN /PASSWORD=12345678

> This command logs in user VANPEENEN to node SPARKS.

#2
    $  ACMSMGR LOGIN /NODE=SPARKS,NELSON /USER=VANPEENEN /PASSWORD=12345678

> This command logs in user VANPEENEN to nodes SPARKS and NELSON.

#3
    $  ACMSMGR LOGIN /USER=VANPEENEN

> This command logs in user VANPEENEN to the node specified by the logical name ACMS$MGMT_SERVER_NODE. The ACMSMGR utility will prompt the user for the password.

#4
    $  ACMSMGR LOGIN

> This command logs in the user defined by the logical name ACMS$MGMT_USER to the node specified by the logical name ACMS$MGMT_SERVER_NODE. If the logical name ACMS$MGMT_USER is not defined, the ACMSMGR utility will prompt for the user name. The ACMSMGR utility also will prompt for the password.

# 11.10 ACMSMGR LOGOUT

Logs out a user from a server on one or more nodes.

## Format

> ### ACMSMGR LOGOUT [/qualifiers]

> Command Qualifier | Default
> --- | ---
> /NODE=node-name | Translation of logical ACMS$MGMT_SERVER_NODE
> /USER=user-name | Translation of logical ACMS$MGMT_USER

## Privileges Required

> ACMS$MGMT_READ

## Parameters

> None.

## Qualifiers

> ### /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 from which to log out.

> 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 prompts the user for a user name. Logout cannot be performed without a user name.

## Notes

> Once logout is complete, subsequent ACMSMGR commands for a user, process, and node will fail authorization checks.

## Examples

#1
    $  ACMSMGR LOGOUT /NODE=SPARKS /USER=VANPEENEN

> This command logs out user VANPEENEN from node SPARKS.

#2
    $  ACMSMGR LOGOUT /NODE=SPARKS,NELSON /USER=VANPEENEN /PASSWORD=12345

> This command logs out user VANPEENEN from nodes SPARKS and NELSON.

#3
    $  ACMSMGR LOGOUT /USER=VANPEENEN

> This command logs out user VANPEENEN from the node specified by the logical name ACMS$MGMT_SERVER_NODE.

#4
    $  ACMSMGR LOGOUT

> This command logs out the user defined by the logical name ACMS$MGMT_USER from the node specified by the logical name ACMS$MGMT_SERVER_NODE. If the logical name ACMS$MGMT_USER is not defined, the ACMSMGR utility will prompt for the user name.

# 11.11 ACMSMGR REPLACE SERVER

Replaces a running server in a running ACMS application.

## Format

> ### ACMSMGR REPLACE SERVER [/qualifiers]

> Command Qualifier | Default
> --- | ---
> /APPLICATION=[*,application-name] | * (all)
> /NODE=node-name | Translation of logical ACMS$MGMT_SERVER_NODE
> /SERVER=[*,server-name] | * (all)
> /USER=user-name | Translation of logical ACMS$MGMT_USER

## Privileges Required

> ACMS$MGMT_OPER

## Parameters

> None.

## Qualifiers

> ### /APPLICATION=[*, application-name]

> This qualifier specifies the name of the application. If this qualifier is not specified, the command is executed for all applications on the target node.

> ### /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. If this qualifier is not specified, the command is executed for all servers on the target node in the target application.

> ### /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/REPLACE SERVER. The command is executed synchronously.

## Example

    $  ACMSMGR REPLACE SERVER /APPL=VR_APPL/SERV=VR_READ_SERVER/NODE=SPARKS

> This command replaces the VR_READ_SERVER in the VR_APPL application on node SPARKS.

# 11.12 ACMSMGR RESET ERROR++

Resets (closes) the Remote Manager error log file and creates (opens) a new version.

## Format

> ### ACMSMGR RESET ERROR [/qualifiers]

> Command Qualifier | Default
> --- | ---
> /NODE=node-name | Translation of logical ACMS$MGMT_SERVER_NODE
> /USER=user-name | Translation of logical ACMS$MGMT_USER

## Privileges Required

> ACMS$MGMT_WRITE

## Parameters

> None.

## Qualifiers

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

> This command closes the current version of the ACMSMGR error log file and opens a new version.

## Example

    $  ACMSMGR RESET ERROR /NODE=SPARKS /USER=VANPEENEN

> This command resets the Remote Manager error log on node SPARKS.

Note #### ++ This command (and its qualifiers) is only for use with systems running ACMS Version 4.4 or higher.

# 11.13 ACMSMGR RESET LOG

Resets (closes) the Remote Manager log file and creates (opens) a new version.

## Format

> ### ACMSMGR RESET LOG [/qualifiers]

> Command Qualifier | Default
> --- | ---
> /NODE=node-name | Translation of logical ACMS$MGMT_SERVER_NODE
> /USER=user-name | Translation of logical ACMS$MGMT_USER

## Privileges Required

> ACMS$MGMT_WRITE

## Parameters

> None.

## Qualifiers

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

> This command closes the current version of the ACMSMGR log file and opens a new version.

## Example

    $  ACMSMGR RESET LOG /NODE=SPARKS /USER=VANPEENEN

> This command resets the Remote Manager log on node SPARKS.

# 11.14 ACMSMGR SAVE FILTER++

Saves the current records in the Error Filter table to a file.

## Format

> ### ACMSMGR SAVE FILTER [/qualifiers]

> Command Qualifier | Default
> --- | ---
> /FILE=file-name | Qualifier is required.
> /NODE=node-name | Translation of logical ACMS$MGMT_SERVER_NODE
> /USER=user-name | Translation of logical ACMS$MGMT_USER

## Privileges Required

> ACMS$MGMT_WRITE

## Parameters

> None.

## Qualifiers

> ### /FILE=file-name

> This required qualifier specifies a full OpenVMS file specification (node::device:[directory]file-name.ext) that indicates where the error filter information is to be written. Partial specifications and logical names are not valid.

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

> This command provides the ability to write the current set of error filter records to an external file. The /FILE qualifier is required and must reference a valid, complete OpenVMS file specification. Logicals and partial names are not recognized.

> See Section 5.5 for information on working with error logs and error filtering.

## Example

    $  ACMSMGR SAVE FILTER/FILE=VLCROW::DISK1$:[SYSTEM.FILTER]ERROR_FILTER.TXT/NODE=SPARKS

> This command saves the error filter records for node SPARKS to the DISK1$:[SYSTEM.FILTER]ERROR_FILTER.TXT on node VLCROW.

Note #### ++ This command (and its qualifiers) is only for use with systems running ACMS Version 4.4 or higher.

# 11.15 ACMSMGR SET ACC

Makes modifications to the ACMS system.

## Format

> ### ACMSMGR SET ACC [/qualifiers]

> Command Qualifier | Default
> --- | ---
> /ACC_PRIORITY=value | None
> /ACC_USERNAME=user-name | None
> /ACTIVE | /STORED
> /ASTLM=value++ | None
> /AUDIT_STATE=keyword | None
> /BIOLM=value++ | None. See /process-quota.
> /BYTLM=value++ | None. See /process-quota.
> /CHANNELCNT=value++ + | None. See /system-parameter.
> /DIOLM=value++ | None. See /process-quota.
> /ENQLM=value++ | None. See /process-quota.
> /FILLM=value++ | None. See /process-quota.
> /GBLPAGES=value++ | None. See /system-parameter.
> /GBLPAGFIL=value++ | None. See /system-parameter.
> /GBLSECTIONS=value++ | None. See /system-parameter.
> /LOG | None
> /MAX_APPL=value | None
> /MSS_MAXBUF=value | None
> /MSS_MAXOBJ=value | None
> /MSS_NET_RETRY_TIMER=value | None
> /MSS_POOLSIZE=value | None
> /MSS_PROCESS_POOL=value | None
> /NODE=node-name | Translation of logical ACMS$MGMT_SERVER_NODE
> /NODE_NAME=node-name | None
> /PGFLQUOTA=value++ | None. See /process-quota.
> /STORED | /STORED
> /TQELM=value++ | None. See /process-quota.
> /TWS_POOLSIZE=value | None
> /TWSC_POOLSIZE=value | None
> /USER=user-name | Translation of logical ACMS$MGMT_USER
> /USERNAME_DEFAULT=user-name | None
> /WS_POOLSIZE=value | None
> /WSC_POOLSIZE=value | None
> /WSDEFAULT=value++ | None. See /process-quota.
> /WSEXTENT=value++ | None. See /process-quota.
> /WSQUOTA=value++ | None. See /process-quota.

## Privileges Required

> ACMS$MGMT_OPER
> ACMS$MGMT_SYSUPD (for system parameters)

## 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 ACC_USERNAME. Updated quota values apply to the next process that is created.

> Because these qualifiers control the nondynamic values for the related process quotas, the /ACTIVE qualifier cannot be specified. The /STORED qualifier is the default and 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.

> ### /system-parameter=value

> These qualifiers correspond to and update the related OpenVMS System Generation utility (SYSGEN) parameters. Updated parameter values apply to the next process that is created. The ACMS$MGMT_SYSUPD rights identifier is required to set these parameters.

> Because these qualifiers control the nondynamic values for the related syste parameters, the /ACTIVE qualifier cannot be specified. The /STORED qualifier is the default and causes the specified values to be stored in the current SYSGEN work area.

> For information on using SYSGEN, see the OpenVMS System Manager's Manual. For more information about the individual parameters and their values, see OpenVMS System Management Utilities Reference Manual: M--Z or access the online help for SYSGEN.

> ### /ACC_PRIORITY=value

> This qualifier corresponds to and updates the ACMSGEN field ACC_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.

> ### /ACC_USERNAME=user-name

> This qualifier corresponds to and updates the ACMSGEN field ACC_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.

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

> ### /AUDIT_STATE=[ENABLED, DISABLED]

> This qualifier is equivalent to the ACMSOPER command ACMS/SET SYSTEM/AUDIT (or /NOAUDIT if the value is DISABLED).

> ### /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_APPL=value

> This qualifier corresponds to and updates the ACMSGEN field MAX_APPL. 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.

> ### /MSS_MAXBUF=value

> This qualifer corresponds to and updates the ACMSGEN field MSS_MAXBUF. 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.

> ### /MSS_MAXOBJ=value

> This qualifier corresponds to and updates the ACMSGEN field MSS_MAXOBJ. 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.

> ### /MSS_NET_RETRY_TIMER=value

> This qualifier corresponds to and updates the ACMSGEN field MSS_NET_RETRY_TIMER. As 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.

> ### /MSS_POOLSIZE=value

> This qualifier corresponds to and updates the ACMSGEN field MSS_POOLSIZE. 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.

> ### /MSS_PROCESS_POOL=value

> This qualifier corresponds to and updates the ACMSGEN field MSS_PROCESS_POOL. 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.

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

> Note #### ++ Only for use on systems running ACMS Version 4.4 or higher. #### + This special parameter is used by Compaq and is subject to change. Do not change this parameter unless Compaq recommends that you do so.

> Previous | Next | Contents | Index