| Previous | Contents | Index |
Logs out a user from a server on one or more nodes.
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
ACMS$MGMT_READ
None.
/NODE=node-name
This qualifier specifies a fully or partially qualified TCP/IP node name. To execute the command on more than one node, you can specify the node names in a comma-separated list. The ACMSMGR utility attempts to perform the operation sequentially on each node in the list.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.
Once logout is complete, subsequent ACMSMGR commands for a user, process, and node will fail authorization checks.
| #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.
10.8 ACMSMGR REPLACE SERVER
Replaces a running server in a running ACMS application.
ACMSMGR REPLACE SERVER [/qualifiers]
Command Qualifier Default /APPL=[*,application-name] * (all) /SERVER=[*,server-name] * (all) /NODE=node-name Translation of logical ACMS$MGMT_SERVER_NODE /USER=user-name Translation of logical ACMS$MGMT_USER
ACMS$MGMT_OPERATE
None.
/APPL=[*, 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./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./NODE=node-name
This qualifier specifies a fully or partially qualified TCP/IP node name. To execute the command on more than one node, you can specify the node names in a comma-separated list. The ACMSMGR utility attempts to perform the operation sequentially on each node in the list.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 10.6).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 3.4.1.2 for a discussion of proxy access.
This command is equivalent to the ACMSOPER command ACMS/REPLACE SERVER. The command is executed synchronously.
$ 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.
10.9 ACMSMGR RESET LOG
Resets (closes) the Remote Manager log file and creates (opens) a new
version.
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
ACMS$MGMT_WRITE
None.
/NODE=node-name
This qualifier specifies a fully or partially qualified TCP/IP node name. To execute the command on more than one node, you can specify the node names in a comma-separated list. The ACMSMGR utility attempts to perform the operation sequentially on each node in the list.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 10.6).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 3.4.1.2 for a discussion of proxy access.
$ ACMSMGR RESET LOG /NODE=SPARKS /USER=VANPEENEN
|
This command resets the Remote Manager log on node SPARKS.
10.10 ACMSMGR SET ACC
Makes modifications to the ACMS system.
ACMSMGR SET ACC [/qualifiers]
Command Qualifier Default /ACC_PRIORITY=value None /ACC_USERNAME=user-name None /ACTIVE /STORED /AUDIT_STATE=keyword 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 /STORED /STORED /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
ACMS$MGMT_OPER
None.
/ACC_PRIORITY=value
This field corresponds to and updates the ACMSGEN field ACC_PRIORITY. Because this is a nondynamic ACMSGEN field, the /ACTIVE qualifier has no effect when used with this qualifier. The /STORED qualifier causes the specified value to be stored in the current ACMSGEN file./ACC_USERNAME=user-name
This field corresponds to and updates the ACMSGEN field ACC_USERNAME. Because this is a nondynamic ACMSGEN field, the /ACTIVE qualifier has no effect when used 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 can be specified with the /STORED qualifier. If neither is specified, the default is /STORED. If /ACTIVE is specified alone, 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)./MAX_APPL=value
This field corresponds to and updates the ACMSGEN field MAX_APPL. Because this is a nondynamic ACMSGEN field, the /ACTIVE qualifier has no effect when used with this qualifier. The /STORED qualifier causes the specified value to be stored in the current ACMSGEN file./MSS_MAXBUF=value
This field corresponds to and updates the ACMSGEN field MSS_MAXBUF. Because this is a nondynamic ACMSGEN field, the /ACTIVE switch has no effect when used with this qualifier. The /STORED qualifier causes the specified value to be stored in the current ACMSGEN file./MSS_MAXOBJ=value
This field corresponds to and updates the ACMSGEN field MSS_MAXOBJ. Because this is a nondynamic ACMSGEN field, the /ACTIVE qualifier has no effect when used with this qualifier. The /STORED qualifier causes the specified value to be stored in the current ACMSGEN file./MSS_NET_RETRY_TIMER=value
This field 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 field corresponds to and updates the ACMSGEN field MSS_POOLSIZE. Because this is a nondynamic ACMSGEN field, the /ACTIVE qualifier has no effect when used with this qualifier. The /STORED qualifier causes the specified value to be stored in the current ACMSGEN file./MSS_PROCESS_POOL=value
This field corresponds to and updates the ACMSGEN field MSS_PROCESS_POOL. Because this is a nondynamic ACMSGEN field, the /ACTIVE qualifier has no effect when used 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 node name. To execute the command on more than one node, you can specify the node names in a comma-separated list. The ACMSMGR utility attempts to perform the operation sequentially on each node in the list.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.
/NODE_NAME=node-name
This field corresponds to and updates the ACMSGEN field NODE_NAME. Because this is a nondynamic ACMSGEN field, the /ACTIVE qualifier has no effect when used with this qualifier. The /STORED qualifier causes the specified value to be stored in the current ACMSGEN file./STORED
This qualifier causes ACMSGEN file updates to be written and saved in the current ACMSGEN file. The /STORED qualifier can be specified with the /ACTIVE qualifier. If neither is specified, the default is /STORED. If /ACTIVE is specified alone, no updates are written to the file./TWS_POOLSIZE=value
This field corresponds to and updates the ACMSGEN field TWS_POOLSIZE. Because this is a nondynamic ACMSGEN field, the /ACTIVE qualifier has no effect when used with this qualifier. The /STORED qualifier causes the specified value to be stored in the current ACMSGEN file./TWSC_POOLSIZE=value
This field corresponds to and updates the ACMSGEN field TWSC_POOLSIZE. Because this is a nondynamic ACMSGEN field, the /ACTIVE qualifier has no effect when used with this qualifier. The /STORED qualifier causes the value specified 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 10.6).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 3.4.1.2 for a discussion of proxy access.
/USERNAME_DEFAULT=user-name
This field corresponds to and updates the ACMSGEN field USERNAME_DEFAULT. 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./WS_POOLSIZE=value
This field corresponds to and updates the ACMSGEN field WS_POOLSIZE. Because this is a nondynamic ACMSGEN field, the /ACTIVE qualifier has no effect when used with this qualifier. The /STORED qualifier causes the specified value to be stored in the current ACMSGEN file.WSC_POOLSIZE=value
This field corresponds to and updates the ACMSGEN field WSC_POOLSIZE. Because this is a nondynamic ACMSGEN field, the /ACTIVE qualifier has no effect when used with this qualifier. The /STORED qualifier causes the specified value to be stored in the current ACMSGEN file.
This command provides the ability 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.
| #1 |
|---|
$ ACMSMGR SET ACC /NODE=SPARKS/MSS_NET_RETRY_TIMER=250/ACTIVE/STORED
|
This command modifies the ACMSGEN field mss_net_retry_timer on node SPARKS, updates the active system, and saves the change in the file.
| #2 |
|---|
$ ACMSMGR SET ACC /NODE=SPARKS/MSS_NET_RETRY_TIMER=250/ACTIVE
|
This command modifies the ACMSGEN field mss_net_retry_timer on node SPARKS and updates the active system only. The change is not saved in the ACMSGEN file.
| #3 |
|---|
$ ACMSMGR SET ACC /NODE=SPARKS/MSS_NET_RETRY_TIMER=500/STORED
|
This command modifies the ACMSGEN field mss_net_retry_timer on node SPARKS and saves the change in the ACMSGEN file. The active system is not updated.
10.11 ACMSMGR SET COLLECTION
Updates records in the Collection table.
ACMSMGR SET COLLECTION [/qualifiers]
Command Qualifier Default /CLASS=class-name * (all) /COLL_STATE=keyword None /ENTITY=[*,entity-name] Qualifier is required. /NAME=[*,entity-name] * (all) /NODE=node-name Translation of logical ACMS$MGMT_SERVER_NODE /USER=user-name Translation of logical ACMS$MGMT_USER
ACMS$MGMT_WRITE
None.
/CLASS=[*, ID, CONFIG, POOL, RUNTIME]
This qualifier specifies the class to be enabled or disabled. The default is * (all). See Section 4.1.1 for a description of each class type./COLL_STATE=[ENABLED, DISABLED]
This qualifier specifies the state of the collection./ENTITY=[*, ACC, CP, EXC, GROUP, QTI, SERVER, TSC]
This required qualifier specifies the entity or entities for which collection should be enabled or disabled./NAME=[*, entity-name]
This qualifier specifies particular instances of an entity. Wildcards (*, !) are allowed in names.For ACC, CP, QTI, and TSC entity types, the entity name is the process name. For the EXC entity type, the entity name is the name of the application (for example, VR_APPL).
Server and task group names can be specified as compound names made up of an application name and a server or task group name, separated by a period (for example, VR_APPL.VR_READ_SERVER). Either part of server or task group names can be a wildcard (for example, *.VR_READ_SERVER or VR_APPL.*). If only one part of a server or task group name is specified, it is assumed to be the application name, and the server or task group name is wildcarded. For example, VR_APPL is equivalent to VR_APPL.*.
The default is all (*), which is equivalent to *.* for a compound name.
/NODE=node-name
This qualifier specifies a fully or partially qualified TCP/IP node name. To execute the command on more than one node, you can specify the node names in a comma-separated list. The ACMSMGR utility attempts to perform the operation sequentially on each node in the list.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 10.6).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 3.4.1.2 for a discussion of proxy access.
When updating collection records, the combination of class, entity, and name must exactly match a record in the Collection table.You cannot modify Collection table entries for the ID and CONFIG classes.
When multiple collection records apply to a given process, the records are assigned weights according to a precedence of name, then entity, then class. Within a column, wildcard entries are weighted less than nonwildcard entries. The row with the highest weight that applies to a process is used. The ACMSMGR SHOW COLLECTIONS command displays weights for each row in the table. See also Section 4.1.1 for a discussion of the Collection table and of how weights are assigned.
Changes to the Collection table are processed immediately. The Remote Manager signals the appropriate ACMS process as soon as it has reevaluated the Collection table following an addition. Messages are sent to the ACMS process using the ACMS Trace Monitor.
ACMS processes read the Collection table during process startup to determine which classes to begin collecting.
The ACMSMGR SHOW PROCESS command can be used to determine the class states for the currently running ACMS processes.
$ ACMSMGR SET COLLECTION/ENT=EXC/CLASS=RUNTIME/NAME=VR_APPL/COLL_S=DISABLED
|
This command disables run-time data collection for the VR_APPL application.
| Previous | Next | Contents | Index |