# Compaq ACMS for OpenVMS
Remote Systems Management Guide

Previous | Contents | Index

## 9.2.1 Field Descriptions

Following are descriptions of the fields in Table 9-1.

- record_state
  The current state of this table entry. Valid states are VALID (the process is currently running and maintaining this table entry) or INACTIVE (the process is no longer running). Inactive rows are subject to reuse.
- id_coll_state
  The current collection state for this class and this process. Collection states can be modified by modifying entries in the Collection table. See Section 5.1 and Section 9.3 for discussions of data collection.
- process_name
  The OpenVMS process name for the process.
- pid
  The OpenVMS process identifier for the process.
- username_active
  The OpenVMS user name under which the process is currently running. This is the value that was in the ACMSGEN file when the process was started.

- username_stored
  The OpenVMS process name currently stored in the ACMSGEN file for this process.
- start_time
  Date and time the process was started.
- end_time
  Date and time the process ended. If the process has not yet ended, this field will be null.
- acms_version
  Current version of the ACC.
- config_coll_state
  The current collection state for this class and this process. Collection states can be modified by modifying entries in the Collection table. See Section 5.1 and Section 9.3 for discussions of data collection.
- acms_state
  Current ACMS state of the process. This field can be set (to DISABLED or to 0) by the SNMP interface only. RPC users use the ACMSMGMT_STOP_ACC_1 procedure described in Section 8.48. ACMSMGR users use the STOP SYSTEM command.
- acc_priority_active
  The base priority for this process. This is the value of the ACMSGEN field when the process was started.
- acc_priority_stored
  The base priority currently stored in the ACMSGEN file for this process.
- max_appl_active
  The maximum number of ACMS applications that can be started simultaneously on this node. This is the value of the ACMSGEN field when the ACC process was started.
- max_appl_stored
  The value of the max_appl field currently stored in the ACMSGEN file.
- mss_maxobj_active
  The maximum number of ACMS message switch objects that can be started simultaneously on this node. This is the value of the ACMSGEN field when the ACC process was started. See the MSS class field mss_objects for a count of the current and maximum number of MSS objects instantiated on the system.
- mss_maxobj_stored
  The value of the mss_maxobj field currently stored in the ACMSGEN file.
- mss_maxbuf_active
  The maximum size of a message segment of an ACMS message switch message. This is the value of the ACMSGEN field when the ACC process was started.

- mss_maxbuf_stored
  The value of the mss_maxbuf field currently stored in the ACMSGEN file.
- mss_poolsize_active
  The size of the MSS shared pool (in pagelets). This is the value of the ACMSGEN field when the ACC process was started.
- mss_poolsize_stored
  The value of the mss_poolsize field currently stored in the ACMSGEN file.
- mss_process_pool_active
  The default size of the MSS pool (in pagelets) allocated for each ACMS process. This is the value of the ACMSGEN field when the ACC process was started.
- mss_process_pool_stored
  The value of the mss_process_pool field currently stored in the ACMSGEN file.
- mss_net_retry_active
  The time ACMS processes will wait before retrying an MSS network operation. This field can be modified dynamically.
- mss_net_retry_timer_stored
  The value of the mss_net_retry_timer field currently stored in the ACMSGEN file.
- audit_state
  The current system auditing state.
- username_default_active
  The default user name for remote users. This is the value of the ACMSGEN field when the ACC process was started.
- username_default_stored
  The value of the username_default field currently stored in the ACMSGEN file.
- node_name_active
  The node name for the current node. This is the value of the ACMSGEN field when the ACC process was started.
- node_name_stored
  The value of the node_name field currently stored in the ACMSGEN file.
- ws_poolsize_active, wsc_poolsize_active, tws_poolsize_active, twsc_poolsize active
  The default size of the group and user workspace (WS), user workspace control (WSC), task workspace (TWS), or task workspace control (TWSC) pool (in pagelets). This is the value of the ACMSGEN field when the ACC process was started.
- ws_poolsize_stored, wsc_poolsize_stored, tws_poolsize_stored, twsc_poolsize_stored
  The value of associated poolsize field currently stored in the ACMSGEN file.

- astlm_active, biolm_active, bytlm_active, diolm_active, enqlm_active, fillm_active, pgflquota_active, tqelm_active, wsdefault_active, wsextent_active, wsquota_active
  The default value of the related OpenVMS process quota. This is the value of the quota when the ACC process was started.
- astlm_stored, biolm_stored, bytlm_stored, diolm_stored, enqlm_stored, fillm_stored, pgflquota_stored, tqelm_stored, wsdefault_stored, wsextent_stored, wsquota_stored
  The value of the related process quota currently stored in the OpenVMS system user authorization file (SYSUAF.DAT).
- channelcnt_active, gblsections_active, gblpages_active, gbpagfil_active
  The default value of the related OpenVMS system parameter. This is the value of the parameter when the ACC process was started.
- channelcnt_stored, gblsections_stored, gblpages_stored, gbpagfil_stored
  The value of the related system parameter currently stored in the OpenVMS System Generation utility (SYSGEN) work area.
- runtime_coll_state
  The current collection state for this class and this process. Collection states can be modified by modifying entries in the Collection table. See Section 5.1 and Section 9.3 for discussions of data collection.
  If this field is set to DISABLED, the process is not currently collecting data for the fields in this class. Any field values reflect activity during a prior period when collection was enabled.
- current_appls
  The number of applications currently running on the node.
- current_users
  The number of users currently logged in to the node.
- current_local_users
  The number of current users logged in to ACMS locally.
- current_remote_users
  The number of current users who are logged in to ACMS remotely.
- appl_starts
  The number of applications that have been started on the node since the system was started.
- decnet_object
  If the process has a current DECnet object, the value of this field is STARTED. Otherwise, the value is STOPPED. If the DECnet object is stopped (and the runtime_coll_state is enabled for this process), either distributed processing has not been enabled (that is, the node_name parameter in the ACMSGEN file is NULL) or there is currently a problem with DECnet. Also, check the ACC CONFIG parameters node_name_active and node_name_stored to determine the current status of the ACMSGEN node_name field.

- astlm_current, biolm_current, bytlm_current, diolm_current, enqlm_current, fillm_current, pgflquota_current, tqelm_current, wssize_current, channelcnt_current
  The actual amount of the related OpenVMS process or system resource that is being consumed by the ACC process. The frequency with which these fields are updated is based on the value of the vms_coll_interval field in the Parameter table (see Table 9-8).
- pool_coll_state
  The current collection state for this class and this process. Collection states can be modified by modifying entries in the Collection table. See Section 5.1 and Section 9.3 for discussions of data collection.
  If this field is set to DISABLED, the process is not currently collecting data for the fields in this class. Any field values reflect activity during a prior period when collection was enabled.
- mss_shared_total
  The total size (in bytes) of the MSS shared pool on this node. The frequency with which this field is updated is based on the value of the Parameter table field mss_coll_interval (see Table 9-8).
- mss_shared_free
  The amount (in bytes) of unused MSS shared pool. The frequency with which this field is updated is based on the value of the Parameter table field mss_coll_interval (see Table 9-8).
- mss_shared_largest
  The largest unused block (in bytes) available in the MSS shared pool. The frequency with which this field is updated is based on the value of the Parameter table field mss_coll_interval (see Table 9-8).
- mss_shared_failures
  The number of failed attempts to allocate space from the MSS shared pool. The frequency with which this field is updated is based on the value of the Parameter table field mss_coll_interval (see Table 9-8).
- mss_shared_garbage
  The number of garbage collections that have been run to reclaim space in the MSS shared pool. The frequency with which this field is updated is based on the value of the Parameter table field mss_coll_interval (see Table 9-8).
- mss_process_total
  The total size (in bytes) of the MSS process pool allocated for this process. The frequency with which this field is updated is based on the value of the Parameter table field mss_coll_interval (see Table 9-8).
- mss_process_free
  The amount of unused MSS process pool (in bytes) for this process. The frequency with which this field is updated is based on the value of the Parameter table field mss_coll_interval (see Table 9-8).
- mss_process_largest
  The largest unused block (in bytes) available in the MSS process pool for this process. The frequency with which this field is updated is based on the value of the Parameter table field mss_coll_interval (see Table 9-8).
- mss_process_failures
  The number of failed attempts to allocate space in the MSS process pool for this process. The frequency with which this field is updated is based on the value of the Parameter table field mss_coll_interval (see Table 9-8).
- mss_process_garbage
  The number of garbage collections for this process that have been run to reclaim space in the MSS process pool. The frequency with which this field is updated is based on the value of the Parameter table field mss_coll_interval (see Table 9-8).
- mss_objects
  The number of MSS objects currently instantiated on the node. The frequency with which this field is updated is based on the value of the Parameter table field mss_coll_interval (see Table 9-8).
- mss_msgs_1-1024, mss_msgs_1025-2048, mss_msgs_2049-4096, mss_msgs_4097-8192, mss_msgs_8193-16384, mss_msgs_16385-32768, mss_msgs_32769-65636
  The number of MSS messages whose sizes fall within the specified range (in bytes).
- mss_msg_count_resets
  The number of MSS message size counter resets that have occurred. Each of the preceding counters (mss_msgs_n-n) are reset if one of the counters overflows.
- tws_poolsize_total, twsc_poolsize_total
  The total amount (in pagelets) of TWS or TWSC process pool being used by all task groups running on the current node. The frequency with which these fields are updated is based on the value of the wksp_coll_interval field in the Parameter table (see Table 9-8).
- tws_pool_large_used, twsc_pool_large_used
  The largest amount (in bytes) of TWS or TWSC process pool being used by a task group running on the current node. The frequency with which these fields are updated is based on the value of the wksp_coll_interval field in the Parameter table (see Table 9-8).
- tws_pool_min_free, twsc_pool_min_free
  The minimum amount (in bytes) of unused TWS or TWSC process pool available on the current node. The frequency with which these fields are updated is based on the value of the wksp_coll_interval field in the Parameter table (see Table 9-8).
- ws_pool_large_used, wsc_pool_large_used
  The largest amount (in bytes) of WS or WSC process pool being used by an application running on the current node. The frequency with which these fields are updated is based on the value of the wksp_coll_interval field in the Parameter table (see Table 9-8).
- ws_pool_min_free, wsc_pool_min_free
  The minimum amount (in bytes) of unused WS or WSC process pool available on the current node. The frequency with which these fields are updated is based on the value of the wksp_coll_interval field in the Parameter table (see Table 9-8).
- err_coll_state
  The current collection state for this class and this process. Collection states can be modified by modifying entries in the Collection table. See Section 5.1 and Section 9.3 for discussions of data collection.
  Errors for this process are only sent to the Remote Manager if this field is set to ENABLED. If this field is set to DISABLED, the process will not collect data for the fields in this class; existing field values reflect activity during a prior period when collection was enabled.
- err_count
  The total number of errors related to this process that were sent to the Remote Manager.
- last_err_msg
  The text of the most recent error message related to this process that was sent to the Remote Manager.
- time_of_last_error
  Date and time of the most recent error message related to this process that was sent to the Remote Manager.

# 9.3 Collection Table

The Collection table is populated from the configuration file maintained by the user on the local system (or in a cluster common area) when the ACMS run-time system is started.

This table can be used at run time to enable or disable data collection and data snapshots by entity and class. The primary key to this table is the combination of entity, class, and name. Duplicate rows are not allowed.

Table 9-2 Collection Table
Field | Data Type | SNMP Access | RPC Access | Configuration Access | Dynamic
--- | --- | --- | --- | --- | ---
entity | string | R | RW | RW | D
class | string | R | RW | RW | D
name | string | R | RW | RW | D
coll_state | state 1 | RW | RW | RW | D
storage_location++ | string | R | RW | RW | D
storage_state++ | state1 | R | RW | RW | D
storage_interval++ | integer | R | RW | RW | D
storage_start_time++ | time | RW | RW | RW | D
storage_end_time++ | time | RW | RW | RW | D

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

Key to Access Modes

- R---Read Access
- RW---Read/Write Access
- Blank---Not available to the interface
- D---Field is dynamic.

## 9.3.1 Field Descriptions

Following are descriptions of the fields in Table 9-2.

- entity
  Name or type of the entity. Valid values are ACC, CP, EXC, GROUP, QTI, SERVER, and TSC.
- class
  Class of data to be collected. Valid values are CONFIG, ID, ERROR, POOL, and RUNTIME.
- name
  A name for the entity that helps to uniquely identify an instance of the entity type. Possible entity names are:
  - ACC, CP, QTI, TSC (process name)
  - EXC (application name)
  - GROUP (task group name)
  - SERVER (server name)
  Name can include the following wildcard values:
  - asterisk (*) (matches all characters)
  - exclamation point (!) (negation)
- coll_state
  Current state as configured, either from the configuration file or by a user at run time. Valid values are ENABLED or DISABLED. A change to this field causes collection to be initiated or terminated.
- storage_location
  An OpenVMS file specification (or logical name) that indicates where collection data is to be writer. The default value for this field the logical ACMS$MGMT_SNAPSHOT.
  If a directory is not specified as part of the file specification, the file is placed in the default directory of the account under which the Remote Manager process is running.
  Multiple collection entities can share and write output to the same data snapshot file.
  See Section 5.1 for more information on creating data snapshots by periodically saving data collections.
- storage_state
  Current state of data snapshots as configured either from the configuration file or by a user at run time. Valid values are ENABLED or DISABLED. A change to this field causes data snapshots to be either initiated or terminated.
  In order for data snapshots to be fully functional, the coll_state field must be set to ENABLED, and the current time must fall between the specified storage_start_time and storage_end_time values.
  See Section 5.1 for more information on creating data snapshots by saving periodically data collections.

- storage_interval
  Controls the frequency (in seconds) at which data snapshots are collected. A lower value causes data snapshots to be collected more often; a higher value causes data snapshots to be collected less often.
  The storage_interval value should be a multiple of the timer_interval value. The timer_interval value determines the minimum elapsed time for many Remote Manager parameters, including the storage interval setting. The relationship of the values in these two fields determine how often data snapshots are performed, for example:
  - If the timer_interval value is greater, its value is used by default. For instance, if the timer_interval is 10 and the storage_interval is 5, snapshots will be written at 10 second intervals.
  - If the storage_interval value is greater and is a multiple of the timer_interval, the storage_interval value is used. For example, if the timer_interval is 10 and the storage_interval is 30, snapshots will be written at 30 second intervals.
  - If the storage_interval value is greater and is not a multiple of the timer_interval, the next multiple of the timer_interval value is used. For example, if the timer_interval is 10 and the storage_interval is 15, snapshots will be written at 20 second intervals.
  See Section 5.1 for more information on creating data snapshots by periodically saving data collections.
- storage_start_time
  The date and time (DD-MMM-YY:hh:mm:ss.nn) when the data snapshot interval is scheduled to begin. The default value is NOW (begin immediately).
  See Section 5.1 for more information on creating data snapshots by periodically saving data collections.
- storage_end_time
  The date and time (DD-MMM-YY:hh:mm:ss.nn) when the data snapshot interval is scheduled to end. The default value is NEVER (run indefinitely).
  See Section 5.1 for more information on creating data snapshots by periodically saving data collections.

# 9.4 CP Table

The CP table contains a row for each terminal Command Process (CP) running on the node.

Table 9-3 CP Table
Collection Class | Field | Data Type | SNMP Access | RPC Access | Dynamic
--- | --- | --- | --- | --- | ---
ID | record_state | integer | R | R |
ID | id_coll_state | integer | R | R |
ID | process_name | string | R | R |
ID | pid | integer | R | R |
ID | start_time | time | R | R |
ID | end_time | time | R | R |
ID | user_name | string | R | R |
CONFIG | astlm_active++ | integer | R | R |
CONFIG | astlm_stored++ | integer | RW | RW |
CONFIG | biolm_active++ | integer | R | R |
CONFIG | biolm_stored++ | integer | RW | RW |
CONFIG | bytlm_active++ | integer | R | R |
CONFIG | bytlm_stored++ | integer | RW | RW |
CONFIG | diolm_active++ | integer | R | R |
CONFIG | diolm_stored++ | integer | RW | RW |
CONFIG | enqlm_active++ | integer | R | R |
CONFIG | enqlm_stored++ | integer | RW | RW |
CONFIG | fillm_active++ | integer | R | R |
CONFIG | fillm_stored++ | integer | RW | RW |
CONFIG | pgflquota_active++ | integer | R | R |
CONFIG | pgflquota_stored++ | integer | RW | RW |
CONFIG | tqelm_active++ | integer | R | R |
CONFIG | tqelm_stored++ | integer | RW | RW |
CONFIG | wsdefault_active++ | integer | R | R |
CONFIG | wsdefault_stored++ | integer | RW | RW |
CONFIG | wsextent_active++ | integer | R | R |
CONFIG | wsextent_stored++ | integer | RW | RW |
CONFIG | wsquota_active++ | integer | R | R |
CONFIG | wsquota_stored++ | integer | RW | RW |
RUNTIME | runtime_coll_state | integer | R | R |
RUNTIME | acms_state | integer | R | R |
RUNTIME | decnet_object | integer | R | R |
RUNTIME | current_attached_terms | gauge | R | R |
RUNTIME | active_task_calls | gauge | R | R |
RUNTIME | active_tdms_menu_reqs | gauge | R | R |
RUNTIME | total_tdms_menu_reqs | integer | R | R |
RUNTIME | active_tdms_reqs | gauge | R | R |
RUNTIME | active_tdms_read_msgs | gauge | R | R |
RUNTIME | active_tdms_write_msgs | gauge | R | R |
RUNTIME | active_tdms_cancels | gauge | R | R |
RUNTIME | total_tdms_reqs | integer | R | R |
RUNTIME | total_tdms_read_msgs | integer | R | R |
RUNTIME | total_tdms_write_msgs | integer | R | R |
RUNTIME | total_tdms_cancels | integer | R | R |
RUNTIME | active_df_menu_reqs | gauge | R | R |
RUNTIME | total_df_menu_reqs | integer | R | R |
RUNTIME | active_df_reqs | gauge | R | R |
RUNTIME | active_df_enables | gauge | R | R |
RUNTIME | active_df_disables | gauge | R | R |
RUNTIME | active_df_cancels | gauge | R | R |
RUNTIME | active_df_sends | gauge | R | R |
RUNTIME | active_df_receives | gauge | R | R |
RUNTIME | active_df_transceives | gauge | R | R |
RUNTIME | total_df_reqs | integer | R | R |
RUNTIME | total_df_enables | integer | R | R |
RUNTIME | total_df_disables | integer | R | R |
RUNTIME | total_df_cancels | integer | R | R |
RUNTIME | total_df_sends | integer | R | R |
RUNTIME | total_df_receives | integer | R | R |
RUNTIME | total_df_transceives | integer | R | R |
RUNTIME | data_set_hangups | integer | R | R |
RUNTIME | astlm_current++ | gauge | R | R |
RUNTIME | biolm_current++ | gauge | R | R |
RUNTIME | bytlm_current++ | gauge | R | R |
RUNTIME | diolm_current++ | gauge | R | R |
RUNTIME | enqlm_current++ | gauge | R | R |
RUNTIME | fillm_current++ | gauge | R | R |
RUNTIME | pgflquota_current++ | gauge | R | R |
RUNTIME | tqelm_current++ | gauge | R | R |
RUNTIME | wssize_current++ | gauge | R | R |
RUNTIME | channelcnt_current++ | gauge | R | R |
POOL | pool_coll_state | integer | R | R |
POOL | mss_process_total | integer | R | R |
POOL | mss_process_free | min gauge | R | R |
POOL | mss_process_largest | min gauge | R | R |
POOL | mss_process_failures | integer | R | R |
POOL | mss_process_garbage | integer | R | R |
ERROR | err_coll_state++ | integer | R | R |
ERROR | err_count++ | integer | R | R |
ERROR | last_err_msg++ | string | R | R |
ERROR | time_of_last_error++ | time | R | R |

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

Key to Access Modes

- R---Read Access
- RW---Read/Write Access
- Blank---Not available to the interface
- D---Field is dynamic

Previous | Next | Contents | Index