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