Compaq ACMS for OpenVMS
Remote Systems Management Guide


Previous Contents Index

11.23 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_OPER

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

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

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 9.13.2 for a discussion about setting appropriate trap minimums and maximums. See Section 9.13.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.

11.24 ACMSMGR SET TSC

Makes modifications to the ACMS terminal subsystem.

Format

ACMSMGR SET TSC [/qualifiers]

Command Qualifier Default
/ACTIVE /STORED
/ASTLM=value++ None. See /process-quota.
/BIOLM=value++ None. See /process-quota.
/BYTLM=value++ None. See /process-quota.
/CP_PRIORITY=value None
/CP_SLOTS=value None
/CP_USERNAME=user-name None
/DIOLM=value++ None. See /process-quota.
/ENQLM=value++ None. See /process-quota.
/FILLM=value++ None. See /process-quota.
/LOG 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
/PGFLQUOTA=value++ None. See /process-quota.
/STORED /STORED
/TQELM=value++ None. See /process-quota.
/TSC_PRIORITY=value None
/TSC_USERNAME=user-name None
/USER=user-name Translation of logical ACMS$MGMT_USER
/WSDEFAULT=value++ None. See /process-quota.
/WSEXTENT=value++ None. See /process-quota.
/WSQUOTA=value++ None. See /process-quota.

Privileges Required

ACMS$MGMT_OPER

Parameters

None.

Qualifiers

/process-quota=value

These qualifiers correspond to and update the related process quota fields in the system user authorization (SYSUAF) record for the user specified by /TSC_USERNAME. Updated quota values apply to the next process that is created.

Because these qualifiers control the nondynamic values for the related process quota fields, the /ACTIVE qualifier cannot be specified. The /STORED qualifier is the default and causes the specified values to be stored in the current SYSUAF.DAT file.

For information on using AUTHORIZE to modify process quotas, see the OpenVMS System Manager's Manual. For more information about the individual quotas and their values, see OpenVMS System Management Utilities Reference Manual: A--L or access the online help for AUTHORIZE.

/ACTIVE

This qualifier causes dynamic ACMSGEN field values to be updated from the current ACMSGEN file. The /ACTIVE qualifier cannot be specified on the same command with the /STORED qualifier. If neither is specified, the default is /STORED. If /ACTIVE is specified, no updates are written to the file.

/CP_PRIORITY=value

This qualifier corresponds to and updates the ACMSGEN field CP_PRIORITY. Because this is a nondynamic ACMSGEN field, the /ACTIVE qualifier cannot be specified with this qualifier. The /STORED qualifier causes the specified value to be stored in the current ACMSGEN file.

/CP_SLOTS=value

This qualifier corresponds to and updates the ACMSGEN field CP_SLOTS. Because this is a nondynamic ACMSGEN field, the /ACTIVE qualifier cannot be specified with this qualifier. The /STORED qualifier causes the specified value to be stored in the current ACMSGEN file.

/CP_USERNAME=user-name

This qualifier corresponds to and updates the ACMSGEN field CP_USERNAME. Because this is a nondynamic ACMSGEN field, the /ACTIVE qualifier cannot be specified with this qualifier. The /STORED qualifier causes the specified value to be stored in the current ACMSGEN file.

/LOG

This qualifier causes status information for the current SET transaction to be displayed to the terminal (SYS$OUTPUT). This qualifier is useful when setting multiple values; a separate status message is displayed for each value that is set.

/MAX_LOGINS=value

This qualifier corresponds to and updates the ACMSGEN field MSS_MAX_LOGINS. 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 qualifier 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 qualifier 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 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.

/PERM_CPS=value

This qualifier 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 field updates to be written and saved in the current ACMSGEN file. The /STORED qualifier cannot be specified on the same command as the /ACTIVE qualifier. If neither is specified, the default is /STORED.

/TSC_PRIORITY=value

This qualifier corresponds to and updates the ACMSGEN field TSC_PRIORITY. Because this is a nondynamic ACMSGEN field, the /ACTIVE qualifier cannot be specified with this qualifier. The /STORED qualifier causes the specified value to be stored in the current ACMSGEN file.

/TSC_USERNAME=user-name

This qualifier corresponds to and updates the ACMSGEN field TSC_USERNAME. Because this is a nondynamic ACMSGEN field, the /ACTIVE qualifier cannot be specified 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 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 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
      

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.

#2

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

Note

++ Only for use on systems running ACMS Version 4.4 or higher.

11.25 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, /ERROR, /ID, /POOL,
or /RUNTIME) is specified. Otherwise, /BRIEF.
/[class-name] * (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, /ERROR, /ID, /POOL, or /RUNTIME) is specified, this qualifier is ignored and all details are displayed (equivalent to /FULL). Note that OpenVMS process quota and SYSGEN parameter information is only shown when /FULL is specified.

/[CONFIG,ERROR,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 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.

/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 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 displays information about the ACC on the target node. The /BRIEF and /FULL qualifiers control the format ofinformation to be displayed. To display OpenVMS process quota and SYSGEN parameter information, use the /FULL qualifier.

See Section 9.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 Config Class 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.4-0  ACC Table Display                     Time: 18-APR-2001 13:59:06.99 
 
       A Config   Audit  Max   Mss    Mss Proc  Mss     Mss     WS      TWS 
 Node  S Class    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.4-0  ACC Table Display                Time: 19-APR-2001 13:59:04.38 
 
 ========================================================================== 
 
 Node     IDENTIFICATION                                                    
 -------- ----------------------------------------------------------------- 
 vlcrow   ID Class Collection State         enabled 
          Version                           V4.4-0 
          Process Name                      ACMS01ACC001000 
          PID                               37C0024F 
          User Name                         LT$ACC_V31  
          Start Time                        18-APR-2001 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       
          MSS Net Retry Timer (D) (seconds) 10              10      
          Max Applications                  10              10      
          MSS Max Objects                   1006            1006    
          MSS Maxbuf [Msg Buffer] (bytes)   1544            1544    
          MSS Process Pool Size (pagelets)  512             512     
          MSS Pool Size [Shared] (pagelets) 2048            2048    
          WS Pool Size  (pagelets)          256             256     
          WSC Pool Size (pagelets)          128             128     
          TWS Pool Size (pagelets)          1440            1440    
          TWSC Pool Size (pagelets)         169             169     
          Username Default (D)              LTU_ACMSDEF     LTU_ACMSDEF 
          Node Name (ACMSGEN) (DECnet node) VLCROW          VLCROW         
          Working Set Default               1744            1744 
          Working Set Extent                300000          300000 
          Working Set Quota                 4000            4000 
          AST Limit                         500             500 
          Byte Limit                        497632          497632 
          Direct I/O Limit                  500             500 
          Buffered I/O Limit                500             500 
          Enqueue Limit                     3000            3000 
          File Limit                        500             500 
          Page File Quota                   100000          100000 
          Timer Queue Limit                 20              20 
          Channel Count                     256             256 
          Global Sections                   2000            2000 
          Global Pages                      1118076         1118076 
          Global Page File                  60000           60000 
 
 
 Node     RUNTIME                                                                     
 -------- ------------------------------------------------------------------------- 
 vlcrow   Runtime Class Collection State    enabled 
          DECnet Object                     started 
 
          Gauges                            Current  Max    Limit   Max Time                
          --------------------------------- -------- ------ ------- ------------------------ 
          Users: Total                      4        85             (null) 
          Users: Local                      4        20             (null) 
          Users: Remote                     0        0              (null)                 
          Applications                      1        1      20      18-APR-2001 14:49:49.19 
 
          Number of application starts      6 
 
          Process Quotas              Current      Max         Limit   Max Time                
          --------------------------- -----------  ----------  ------- ------------------------ 
          Working Set Size             6544        6544          300000  18-APR-2001 14:49:15.76 
          AST Limit                       5 (  0%)     5 (  0%)     500  18-APR-2001 14:49:15.76 
          Byte Limit                   1792 (  0%)  3648 (  0%) 1775409  18-APR-2001 14:49:15.76 
          Direct I/O Limit                0 (  0%)     1 (  0%)   15000  18-APR-2001 14:49:15.76 
          Buffered I/O Limit              2 (  0%)     3 (  0%)   10000  18-APR-2001 14:49:15.76 
          Enqueue Limit                   2 (  0%)     2 (  0%)    2000  18-APR-2001 14:49:15.76 
          File Limit                      3 (  0%)     3 (  0%)    1001  18-APR-2001 14:49:15.76 
          Page File Quota              7056 (  1%)  7056 (  1%)  500000  18-APR-2001 14:49:15.76 
          Timer Queue Limit               4 (  0%)     4 (  0%)     500  18-APR-2001 14:49:15.76 
          Channel Count                  29 ( 11%)    31 ( 12%)     256  18-APR-2001 14:49:15.76 
 
 Node     POOL                                                                     
 -------- -------------------------------------------------------------------------- 
 vlcrow   Pool Class Collection State       enabled 
 
          MSS Gauge                         Current   Max    Time                   
          --------------------------------- --------- ------ ----------------------- 
          MSS Objects                       252       432    18-APR-2001 14:49:15.76 
 
          MSS Maxbuf Message Counters       Current          Time 
          --------------------------------- ---------------- ----------------------- 
          MSS Msg Size     0 to  1024 bytes              157 
          MSS Msg Size  1025 to  2048 bytes                0 
          MSS Msg Size  2049 to  4096 bytes                0 
          MSS Msg Size  4097 to  8192 bytes                0 
          MSS Msg Size  8193 to 16384 bytes                0 
          MSS Msg Size 16385 to 32768 bytes                0 
          MSS Msg Size 32769 to 65536 bytes                0 
          MSS Message Counter Overflow Resets              0 (null) 
 
          MSS Process Pool                            Pct    Time                    
          ------------------------------------------- ------ ------------------------ 
          Pool Size                         262144   
          Current Free (bytes)              255312    (97%)   
          Minimum Free (bytes)              255056    (97%)  18-APR-2001 15:00:17.30 
          Largest Current Free Block (bytes) 65536    
          Minimum Largest Free Block (bytes) 65536           19-APR-2001 13:59:03.25 
          Allocation Failures                0       
          Garbage Collections                0       
 
          MSS Shared Pool                             Pct    Time                    
          ------------------------------------------- ------ ------------------------ 
          Pool Size                         1048576  
          Current Free (bytes)              973176    (92%)   
          Minimum Free (bytes)              948480    (90%)  18-APR-2001 16:22:58.01 
          Largest Current Free Block (bytes) 65536    
          Minimum Largest Free Block (bytes) 65536           19-APR-2001 13:59:03.25 
          Allocation Failures                0       
          Garbage Collections                0       
 
          WS/TWS Pools (for all EXCs)       Current   Max    Time                   
          --------------------------------- --------- ------ ----------------------- 
          TWS Pool Size Total (pagelets)    3520      3520   18-APR-2001 14:49:15.76 
          TWSC Pool Size Total (pagelets)   500       500    18-APR-2001 14:49:15.76 
          WS Pool Largest Used (bytes)      512       512    18-APR-2001 14:49:15.76 
          WSC Pool Largest Used (bytes)     544       544    18-APR-2001 14:49:15.76 
          TWS Pool Largest Used (bytes)     8192      8192   18-APR-2001 14:49:15.76 
          TWSC Pool Largest Used (bytes)    512       512    18-APR-2001 14:49:15.76  
 
          WS/TWS Pools (for all EXCs)       Current   Min    Time                   
          --------------------------------- --------- ------ ----------------------- 
          WS Pool Minimum Free (bytes)      0         0      18-APR-2001 14:49:15.76 
          WSC Pool Minimum Free (bytes)     0         0      18-APR-2001 14:49:15.76 
          TWS Pool Minimum Free (bytes)     0         0      18-APR-2001 14:49:15.76 
          TWSC Pool Minimum Free (bytes)    0         0      18-APR-2001 14:49:15.76 
 
 Node     ERROR                                                                     
 -------- -------------------------------------------------------------------------- 
 vlcrow   Error Class Collection State      enabled 
          Error Count                       1 
          Last Error Message                FDA462 
          Time of Last Error                17-APR-2001 14:26:01.37 
 
      


Previous Next Contents Index