Previous | Contents | Index |
Updates records in the Trap table.
ACMSMGR SET TRAP [/qualifiers]
Command Qualifier Default /ENTITY=[*,entity-name] Qualifier is required. /NAME=[*,entity-name] * (all) /NODE=node-name Translation of logical ACMS$MGMT_SERVER_NODE /PARAMETER=keyword EXISTS /SEVERITY=[I,W,E,F] E /TRAP_MIN=value -1 /TRAP_MAX=value -1 /USER=user-name Translation of logical ACMS$MGMT_USER
ACMS$MGMT_OPERATE
None.
/ENTITY=[*, ACC, CP, EXC, MGR, QTI, TSC]
This required qualifier specifies the entity or entities for which a trap should be set./NAME=[*, entity-name]
This qualifier specifies particular instances of an entity. Wildcards (*, !) are allowed in names.For the MGR entity, this field should always be set to asterisk (*).
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).
The default is all (*).
/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.
/PARAMETER=[EVENT_SEVERITY, EXISTS]
This parameter specifies the field that should be monitored.
- EVENT_SEVERITY
Internal Remote Manager events are to be monitored. The Remote Manager logs internal events in the Remote Manager log. (See Section 10.25 and Section 3.7 for discussions of the Remote Manager log.) Traps can be generated based on the severity levels of these events.- EXISTS
Process existence is to be monitored. Traps are generated if the associated entity type and name either starts or stops./SEVERITY=[I, W, E, F]
This qualifier specifies the severity to be associated with the trap. Severity codes are embedded in the trap message and must be parsed by the trap receiver. Severities are informational (I), warning (W), error (E), or fatal (F)./TRAP_MIN=value
This qualifier specifies the minimum allowable value for the parameter being monitored. A trap is generated if the parameter value is less than the minimum. See Section 8.12.2 for a list of valid values./TRAP_MAX=value
This qualifier specifies the maximum allowable value for the parameter being monitored. A trap is generated if the parameter value is greater than the maximum. See Section 8.12.2 for a list of valid values./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 trap records, the combination of entity, name, and parameter must exactly match a record in the Trap table.Changes become active as soon as they are added to the Trap table.
See Section 8.12.2 for a discussion about setting appropriate trap minimums and maximums. See Section 8.12.3 for a description of the trap message generated.
$ ACMSMGR SET TRAP /ENT=QTI/PARAM=EXISTS/MAX=0 |
This command causes an SNMP trap to be generated whenever the QTI process is started if the SNMP interface is running.
10.18 ACMSMGR SET TSC
Makes modifications to the ACMS terminal subsystem.
ACMSMGR SET TSC [/qualifiers]
Command Qualifier Default /ACTIVE /STORED /CP_USERNAME=user-name None /CP_PRIORITY=value None /CP_SLOTS=value None /MAX_LOGINS=value None /MAX_TTS_CP=value None /MIN_CPIS=value None /NODE=node-name Translation of logical ACMS$MGMT_SERVER_NODE /PERM_CPS=value None /STORED /STORED /TSC_PRIORITY=value None /TSC_USERNAME=user-name None /USER=user-name Translation of logical ACMS$MGMT_USER
ACMS$MGMT_OPERATE
None.
/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./CP_USERNAME=user-name
This field corresponds to and updates the ACMSGEN field CP_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./CP_PRIORITY=value
This field corresponds to and updates the ACMSGEN field CP_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./CP_SLOTS=value
This field corresponds to and updates the ACMSGEN field CP_SLOTS. 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./MAX_LOGINS=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 value specified to be stored in the current ACMSGEN file./MAX_TTS_CP=value
This field corresponds to and updates the ACMSGEN field MAX_TTS_CP. 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./MIN_CPIS=value
This field corresponds to and updates the ACMSGEN field MIN_CPIS. 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./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.
/PERM_CPS=value
This field corresponds to and updates the ACMSGEN field PERM_CPS. 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 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./TSC_PRIORITY=value
This field corresponds to and updates the ACMSGEN field TSC_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./TSC_USERNAME=user-name
This field corresponds to and updates the ACMSGEN field TSC_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./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 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.
#1 |
---|
$ ACMSMGR SET TSC /NODE=SPARKS/MAX_LOGINS=500/ACTIVE/STORED |
This command modifies the ACMSGEN field max_logins on node SPARKS, updates the active system, and saves the change in the file.
#2 |
---|
$ ACMSMGR SET TSC /NODE=SPARKS/MAX_LOGINS=500/ACTIVE |
This command modifies the ACMSGEN field max_logins on node SPARKS and updates the active system only. The change is not saved in the ACMSGEN file.
#3 |
---|
$ ACMSMGR SET TSC /NODE=SPARKS/MAX_LOGINS=500/STORED |
This command modifies the ACMSGEN field max_logins on node SPARKS and saves the change in the ACMSGEN file. The active system is not updated.
10.19 ACMSMGR SHOW ACC
Displays information about an ACC on one or more remote nodes.
ACMSMGR SHOW ACC [/qualifiers]
Command Qualifier Default /ACTIVE See Notes. /[BRIEF,FULL] /FULL if no class qualifier (/CONFIG, /ID, /POOL, or /RUNTIME) is specified. Otherwise, /BRIEF. /[CONFIG,ID,POOL,RUNTIME] * (all) /INTERVAL=interval Command is executed once. /NODE=node-name Translation of logical ACMS$MGMT_SERVER_NODE /OUT=file-name None /STORED See Notes. /USER=user-name Translation of logical ACMS$MGMT_USER
ACMS$MGMT_READ
None.
/ACTIVE
When specified with the /BRIEF qualifier, this qualifier causes active ACMSGEN field values to be displayed. /ACTIVE is effective only when used with the /CONFIG qualifier. If /BRIEF is not specified, or if /FULL is specified, this qualifier has no effect (both active and stored values are displayed)./[BRIEF,FULL]
This qualifier causes either summary (/BRIEF) or detailed (/FULL) information to be displayed. If no class qualifier (/CONFIG, /ID, /POOL, or /RUNTIME) is specified, this qualifier is ignored and all details are displayed (equivalent to /FULL)./[CONFIG,ID,POOL,RUNTIME]
This qualifier causes data for only the specified class to be displayed. The default is to display information for all classes./INTERVAL=interval
This qualifier causes the command to be reissued automatically at a specified interval (in seconds). Use either Ctrl/C or Ctrl/Y to interrupt the command. If this qualifier is not specified, the command is executed only once./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.
/OUT=file-name
This qualifier causes output to be written to the specified file. If this qualifier is not specified, output is displayed to the terminal (SYS$OUTPUT)./STORED
When specified with the /BRIEF qualifier, this qualifier causes field values from the ACMSGEN file (not those active in memory) to be displayed. The /STORED qualifier is effective only when used with the /CONFIG qualifier. If /BRIEF is not specified, or if /FULL is specified, this qualifier has no effect (both active and stored values are displayed)./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 displays information about the ACC on the target node. The /BRIEF and /FULL qualifiers control the format of information to be displayed.See Section 8.2 for a discussion of each field displayed.
Note that some information may not be current, depending on whether the class to which the data belongs has been enabled for the ACC. The Collect State field indicates whether or not information is being collected for that class.
#1 |
---|
$ ACMSMGR SHOW ACC /CONFIG /NODE=GOCROW,VLCROW ACMS Remote Management -- Command line utility ACMS V4.3-0 ACC Table Display Time: 25-AUG-1999 13:59:06.99 A Collect Audit Max Mss Mss Proc Mss Mss WS TWS Node S State State Appl Max Obj Pool Poolsize Maxbuf Poolsize Poolsize ------ - ------- ------- ---- ------- -------- -------- ------ -------- -------- gocrow A enabled enabled 10 1006 512 4096 1544 256 1440 vlcrow A enabled enabled 10 1006 512 2048 1544 256 1440 |
This command displays ACC configuration information from nodes GOCROW and VLCROW. Authorization is performed for the user specified by the logical name ACMS$MGMT_USER, or by proxy if the logical is not defined. Only summary configuration information is displayed because neither the /BRIEF nor /FULL qualifier was supplied.
#2 |
---|
$ ACMSMGR SHOW ACC /NODE=VLCROW /USER=JONES ACMS Remote Management -- Command line utility ACMS V4.3-0 ACC Table Display Time: 25-AUG-1999 13:59:04.38 ========================================================================== Node IDENTIFICATION -------- ----------------------------------------------------------------- vlcrow Id Class Collection State enabled Version V4.3-0 Process Name ACMS01ACC001000 PID 37C0024F User Name LT$ACC_V31 Start Time 24-AUG-1999 14:49:15.76 End Time (null) Node CONFIGURATION Active Stored -------- --------------------------------- --------------- ------------- vlcrow Config Class Collection State enabled System Auditing State enabled ACC Running State started ACC Username LT$ACC_V31 LT$ACC_V31 ACC Base Priority 4 4 Max Applications 10 10 MSS Max Objects 1006 1006 MSS Maxbuf (bytes) 1544 1544 MSS Poolsize (pagelets) 2048 2048 MSS Process Pool (pagelets) 512 512 MSS Net Retry Timer (D) (seconds) 10 10 Username Default (D) LTU_ACMSDEF LTU_ACMSDEF Node Name (ACMSGEN) (DECnet node) VLCROW VLCROW WS Poolsize (pagelets) 256 256 WSC Poolsize (pagelets) 128 128 TWS Poolsize (pagelets) 1440 1440 TWSC Poolsize (pagelets) 169 169 Node RUNTIME -------- ------------------------------------------------------------------------- vlcrow Runtime Class Collection State enabled DECnet Object started Gauges Current Max Max Time --------------------------------- -------- ------ ------------------------ Applications 1 1 24-AUG-1999 14:49:49.19 Users: Total 4 85 25-AUG-1999 04:53:59.32 Users: Remote 0 0 (null) Number of application starts 1 Node POOL -------- -------------------------------------------------------------------------- vlcrow Pool Class Collection State enabled Objects Current Max Time --------------------------------- --------- ------ ----------------------- MSS Objects 252 432 25-AUG-1999 13:59:03.86 Process Pool Pct Time ------------------------------------------- ------ ------------------------ Pool Size 262144 Current Free (bytes) 255312 (97%) Minimum Free (bytes) 255056 (97%) 24-AUG-1999 15:00:17.30 Largest Current Free Block (bytes) 65536 Minimum Largest Free Block (bytes) 65536 25-AUG-1999 13:59:03.25 Allocation Failures 0 Garbage Collections 0 Shared Pool Pct Time ------------------------------------------- ------ ------------------------ Pool Size 1048576 Current Free (bytes) 973176 (92%) Minimum Free (bytes) 948480 (90%) 24-AUG-1999 16:22:58.01 Largest Current Free Block (bytes) 65536 Minimum Largest Free Block (bytes) 65536 25-AUG-1999 13:59:03.25 Allocation Failures 0 Garbage Collections 0 |
This command displays all ACC management information from node VLCROW. Authorization is performed for user JONES. Since no class qualifiers (/ID, /CONFIG, /RUNTIME, /POOL) were specified, information is returned for all classes by default.
10.20 ACMSMGR SHOW COLLECTION
Displays Collection table data from one or more remote nodes.
ACMSMGR SHOW COLLECTION [/qualifiers]
Command Qualifier Default /INTERVAL=interval Command is executed once. /NODE=node-name Translation of logical ACMS$MGMT_SERVER_NODE /OUT=file-name None /USER=user-name Translation of logical ACMS$MGMT_USER
ACMS$MGMT_READ
None.
/INTERVAL=interval
This qualifier causes the command to be reissued automatically at a specified interval (in seconds). Use either Ctrl/C or Ctrl/Y to interrupt the command. If this qualifier is not specified, the command is executed only once./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.
/OUT=file-name
This qualifier causes output to be written to the specified file. If this qualifier is not specified, output is displayed to the terminal (SYS$OUTPUT)./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 displays data-collection configuration information on the target node.See Section 8.5 for a discussion of each field displayed. See Section 4.1 for a discussion of collections.
$ ACMSMGR SHOW COLL/NODE=VLCROW ACMS Remote Management -- Command line utility ACMS V4.3-0 Entity/Collection table Display Time: 25-AUG-1999 13:59:11.31 Node Wt Entity Collect Collect Type Entity Name Class State ------------ -- -------- -------------------------------------------- ------- vlcrow 2 * * id enabled vlcrow 2 * * config enabled vlcrow 2 * * runtime enabled vlcrow 2 * * pool enabled |
This command displays the contents of the Collection table on node VLCROW, where all collections have been enabled for all entities. Authorization is performed for the user specified by the logical ACMS$MGMT_USER, or by proxy if the logical is not defined.
Previous | Next | Contents | Index |