Compaq ACMS for OpenVMS
Remote Systems Management Guide


Previous Contents Index

10.17 ACMSMGR SET TRAP

Updates records in the Trap table.


Format

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


Privileges Required

ACMS$MGMT_OPERATE

Parameters

None.

Qualifiers

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

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


Notes

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.


Example


$  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.

Format

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


Privileges Required

ACMS$MGMT_OPERATE

Parameters

None.

Qualifiers

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


Notes

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.


Examples

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

Format

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


Privileges Required

ACMS$MGMT_READ

Parameters

None.

Qualifiers

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


Notes

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.


Examples

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

Format

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


Privileges Required

ACMS$MGMT_READ

Parameters

None.

Qualifiers

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


Notes

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.


Example


$  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