# Compaq ACMS for OpenVMS
Remote Systems Management Guide

Previous | Contents | Index

# 11.43 ACMSMGR START EXC

Starts an ACMS application on one or more remote nodes.

## Format

> ### ACMSMGR START EXC [/qualifiers]

> Command Qualifier | Default
> --- | ---
> /APPLICATION=application-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_OPER

## Parameters

> None.

## Qualifiers

> ### /APPLICATION=application-name

> This required qualifier specifies a particular ACMS application to start. The full application name must be specified.

> ### /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 is equivalent to the ACMSOPER command ACMS/START APPL. This command is executed synchronously. If the command completes successfully, the application has been started on the target nodes. If not, error messages are displayed.

## Example

    $  ACMSMGR START EXC/APPL=VR_APPL/NODE=SPARKS

> This command starts the VR_APPL application on node SPARKS.

# 11.44 ACMSMGR START QTI

Starts an ACMS Queued Task Initiator (QTI) on one or more remote nodes.

## Format

> ### ACMSMGR START QTI [/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_OPER

## 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 is equivalent to the ACMSOPER command ACMS/START QTI. This command is executed synchronously. If the command completes successfully, the application has been started on the target nodes. If not, error messages are displayed.

## Example

    $  ACMSMGR START QTI/NODE=SPARKS

> This command starts the QTI on node SPARKS.

# 11.45 ACMSMGR START SYSTEM

Starts an ACMS run-time system on one or more remote nodes.

## Format

> ### ACMSMGR START SYSTEM [/qualifiers]

> Command Qualifier | Default
> --- | ---
> /NOAUDIT | Start system with auditing enabled.
> /NODE=node-name | Translation of logical ACMS$MGMT_SERVER_NODE
> /QTI | Start system without QTI running.
> /NOTERMINALS | Start system with TSC and CPs running.
> /USER=user-name | Translation of logical ACMS$MGMT_USER

## Privileges Required

> ACMS$MGMT_OPER

## Parameters

> None.

## Qualifiers

> ### /NOAUDIT

> This qualifier starts the system with auditing disabled. If this qualifier is not specified, the system is started with auditing enabled.

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

> ### /QTI

> This qualifier starts the system with QTI running. If this qualifier is not specified, the system is started with QTI in stopped state.

> ### /NOTERMINALS

> This qualifier starts the system without the TSC and CPs running. If this qualifier is not specified, the system is started with the TSC and CPs running.

> ### /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/START SYS. This command is executed synchronously. If the command completes successfully, the system has been started on the target nodes. If not, error messages are displayed.

> If no qualifiers are specified with this command, the equivalent ACMSOPER command is ACMS/START SYS/NOQTI/TERMINALS/AUDIT.

## Example

    $  ACMSMGR START SYSTEM/NODE=SPARKS/NOTERMINALS

> This command starts the ACMS run-time system on node SPARKS, without the QTI, TSC, or CPs running.

# 11.46 ACMSMGR START TERMINALS

Starts an ACMS TSC and any associated CPs on one or more remote nodes.

## Format

> ### ACMSMGR START TERMINALS [/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_OPER

## 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 is equivalent to the ACMSOPER command ACMS/START TERMINALS. This command is executed synchronously. If the command completes successfully, the application has been started on the target nodes. If not, error messages are displayed.

## Example

    $  ACMSMGR START TERMINALS/NODE=SPARKS

> This command starts the TSC on node SPARKS.

# 11.47 ACMSMGR START TRACE_MONITOR

This command requests the Remote Manager on the target nodes to start the ACMS$TRACE_MON process. The ACMS$TRACE_MON process is an intermediate process used by the Remote Manager to communicate with ACMS run-time processes to enable and disable collections.

## Format

> ### ACMSMGR START TRACE_MONITOR [/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_OPER

## 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 requests the Remote Manager to start the ACMS$TRACE_MON process on the target node. The ACMS$TRACE_MON process is an intermediate process used by the Remote Manager to communicate with ACMS run-time processes to enable and disable collections.

> In general, external entities do not require a startup or shutdown request of the trace monitor process. The Remote Manager starts the trace monitor during process initialization and stops it during process shutdown. Additionally, the Remote Manager starts the trace monitor anytime it is needed if it is not already started. Once started, the trace monitor continues running until the Remote Manager shuts down.

> After issuing the start command to the trace monitor, the Remote Manager waits for a period of up to trace_start_wait_time (a Parameter table parameter that is dynamic and expressed in seconds). If the trace monitor fails to start during that period, the ACMSMGR command returns an error.

## Example

    $  ACMSMGR START TRACE_MONITOR

> This command starts the ACMS$TRACE_MON process on the node specified by the logical name ACMS$MGMT_SERVER_NODE. Authorization is performed for the user specified by the logical name ACMS$MGMT_USER, or based on an ACMS proxy on the target node if the logical is not defined. If the process is successfully started, no messages are displayed.

# 11.48 ACMSMGR STOP EXC

Stops an ACMS application on one or more remote nodes.

## Format

> ### ACMSMGR STOP EXC [/qualifiers]

> Command Qualifier | Default
> --- | ---
> /APPLICATION=application-name | Qualifier is required.
> /CANCEL | Wait for executing tasks to complete.
> /NODE=node-name | Translation of logical ACMS$MGMT_SERVER_NODE
> /USER=user-name | Translation of logical ACMS$MGMT_USER

## Privileges Required

> ACMS$MGMT_OPER

## Parameters

> None.

## Qualifiers

> ### /APPLICATION=application-name

> This required qualifier specifies a particular ACMS application to start. The entire application name must be specified.

> ### /CANCEL

> This qualifier stops the application without waiting for currently executing tasks to complete. If this qualifier is omitted, any tasks currently executing are allowed to complete before the application is stopped.

> ### /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 is equivalent to the ACMSOPER command ACMS/STOP APPL. This command is executed synchronously. If the command completes successfully, the application has been stopped on the target nodes. If not, error messages are displayed.

## Example

    $  ACMSMGR STOP EXC/APPL=VR_APPL/NODE=SPARKS

> This command stops the VR_APPL application on node SPARKS.

# 11.49 ACMSMGR STOP MANAGER

Stops the Remote Manager on the target nodes.

## Format

> ### ACMSMGR STOP MANAGER [/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_OPER

## 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 requests an orderly shutdown of the Remote Manager process. This command may take several minutes to complete if any of the interfaces is in a noninterruptible state when the command is issued.

> If the command fails to complete successfully, an alternative means of stopping the Remote Manager is to use the DCL command STOP/ID.

> The Remote Manager can be restarted only by logging in to the target node and running the ACMS$MGMT_STARTUP command procedure.

## Example

    $  ACMSMGR STOP MANAGER

> This command stops the Remote Manager on the node specified by the logical name ACMS$MGMT_SERVER_NODE. Authorization is 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. If the server is successfully stopped, no messages are displayed.

# 11.50 ACMSMGR STOP QTI

Stops an ACMS Queued Task Initiator (QTI) on one or more remote nodes.

## Format

> ### ACMSMGR STOP QTI [/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_OPER

## 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 is equivalent to the ACMSOPER command ACMS/STOP QTI. This command is executed synchronously. If the command completes successfully, the QTI has been stopeed on the target nodes. If not, error messages are displayed.

## Example

    $  ACMSMGR STOP QTI/NODE=SPARKS

> This command stops the QTI on node SPARKS.

Previous | Next | Contents | Index