HP OpenVMS Systems Documentation

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

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

• user_name
  The OpenVMS account under which the process is running.
• pid
  The OpenVMS process identifier of the 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.
• appl_name
  Name of the application.
• build_time
  Date and time the application database (ADB) was built.
• exc_appl_tbl_state
  This field is available to the SNMP interface only. It contains the state of the application global section for this EXC. When EXCs have completed their startup, they construct global sections containing server and task group tables. If this field is not MGMT$K_VALID (2), the Server and Task Group tables are not available.
• exc_server_types
  This field is available to the SNMP interface only. It contains the number of server types contained in the application, which is also the number of rows in the Server table for this EXC.
• exc_task_groups
  This field is available to the SNMP interface only. It contains the number of task groups contained in the application, which is also the number of rows in the Task Group table for this EXC.
• 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.
• audit_state_active
  Current auditing state of the application.
• audit_state_stored
  Value of the auditing state of the application as specified in the ACMS application database (.ADB file).
• max_tasks_active
  The current maximum number of executing tasks allowed.
• max_tasks_stored
  The maximum number of executing tasks allowed as specified in the ACMS application database (.ADB file).

• sp_monitoring_interval_active
  The current server process monitoring interval for the application.
• sp_monitoring_interval_stored
  The server process monitoring interval for the application as specified in the ACMS application database (.ADB file).
• max_servers_active
  The current maximum number of started server instances for the application.
• max_servers_stored
  The maximum number of started server instances for the application as specified in the ACMS application database (.ADB file).
• transaction_timeout_active
  The current default task timeout for the application.
• transaction_timeout_stored
  The default task timeout for the application as specified in the ACMS application database (.ADB 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 EXC 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).
• ws_poolsize, wsc_poolsize
  The default size (in pagelets) of WS or WSC process pool for the application.
• tws_poolsize, twsc_poolsize
  The default size (in pagelets) of TWS or TWSC process pool for the application.
• acms_state
  The current ACMS state of this process.
• 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.

• 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.
• current_servers
  The number of server instances currently started in this application.
• current_submitters
  The number of submitters currently logged in to this application.
• current_tasks
  The number of tasks currently started in the application.
• total_tasks_executed
  The total number of tasks started in the application since the application was started.
• total_submitters
  The total number of submitters who have submitted tasks to this application since the application was started.
• current_active_servers
  The current number of active servers (that is, those servers performing processing steps).
• current_free_servers
  The number of started servers which are not currently active (that is, not currently executing processing steps).
• current_waiting_tasks
  The number of tasks that are not executing, waiting for a procedure server to become available.
• server_start_count
  The number of times servers have been started in this application.
• server_failure_count
  The number of times servers have been stopped in this application.
• server_process_total
  The number of concurrent server processes (active or free) running in this application.
• task_failures
  The number of tasks in this application that have failed to complete successfully.
• task_start_failures
  The number of tasks in this application that have failed to start.

• task_security_failures
  The number of tasks in this application that have failed to start because of security violations.
• task_cancels
  The number of tasks in this application that have been canceled.
• active_tdms_requests
  The number of TDMS requests (both exchange and menu) that are currently executing for this process.
• active_tdms_read_messages
  The number of TDMS read messages currently outstanding for this process.
• active_tdms_write_messages
  The number of TDMS write messages currently outstanding for this process.
• active_tdms_cancels
  The number of TDMS cancels currently outstanding for this process.
• total_tdms_requests
  The total number of TDMS requests (both exchange and menu) processed by this process while the runtime_coll_state has been ENABLED.
• total_tdms_read_messages
  The total number of TDMS read messages processed by this process while the runtime_coll_state has been ENABLED.
• total_tdms_write_messages
  The total number of TDMS write messages processed by this process while the runtime_coll_state has been ENABLED.
• total_tdms_cancels
  The total number of TDMS cancels processed by this process while the runtime_coll_state has been ENABLED.
• total_dataset_hangups
  The total number of TDMS dataset hangups (unexpected session interruptions) processed by this process while the runtime_coll_state has been ENABLED.
• 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 EXC process.
• 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_process_total
  The total size of the MSS process pool (in bytes) 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 available (in bytes) 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 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).
• ws_pool_total, wsc_pool_total
  The total size of the WS or WSC pool (in bytes) allocated for this application. The frequency with which these fields are updated is based on the value of the Parameter table field wksp_coll_interval (see Table 9-8).
• ws_pool_used, wsc_pool_used
  The amount of WS or WSC pool (in bytes) used by this application. The frequency with which these fields are updated is based on the value of the Parameter table field wksp_coll_interval (see Table 9-8).
• ws_pool_free, wsc_pool_free
  The amount of unused WS or WSC pool (in bytes) for this application. The frequency with which these fields are updated is based on the value of the Parameter table field wksp_coll_interval (see Table 9-8).
• ws_pool_largest, wsc_pool_largest
  The largest unused block available in the WS or WSC pool for this application. The frequency with which these fields are updated is based on the value of the Parameter table field wksp_coll_interval (see Table 9-8).
• ws_pool_failures, wsc_pool_failures
  The number of failed attempts to allocate space in the WS or WSC pool for this application. The frequency with which these fields are updated is based on the value of the Parameter table field wksp_coll_interval (see Table 9-8).
• ws_pool_garbage, wsc_pool_garbage
  The number of garbage collections that have been run to reclaim space in the WS or WSC pool for this application. The frequency with which these fields are updated is based on the value of the Parameter table field wksp_coll_interval (see Table 9-8).
• tws_pool_total, twsc_pool_total
  The default size for TWS or TWSC pools (in bytes) allocated for this application. The frequency with which these fields are updated is based on the value of the Parameter table field wksp_coll_interval (see Table 9-8).
• tws_poolsize_total, twsc_poolsize_total
  The total size of all TWS or TWSC pools (in bytes) for all task groups in this application. The frequency with which these fields are updated is based on the value of the Parameter table field wksp_coll_interval (see Table 9-8).
• tws_pool_large_used, twsc_pool_large_used
  The largest amount of TWS or TWSC pool used (in bytes) by a task group in this application. The frequency with which these fields are updated is based on the value of the Parameter table field wksp_coll_interval (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 generated by this process. 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.

The Interfaces table is populated from the configuration file by the ACMS Remote Manager process during process startup. This table specifies which interfaces are active and contains parameters associated with each interface. By default, the RPC interface is started; SNMP is not started .

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

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

• interface
  Name or type of the interface. Valid values are RPC or SNMP.
• state
  Current state as configured, either from the configuration file or by a user at run time. Valid values are ENABLED or DISABLED. Note that state and acms_state are not always the same because of potential run-time failures in a thread. For instance, if a thread fails to start, state may be ENABLED, but acms_state may be STOPPED.
  A thread can be enabled only if the acms_state value is STOPPED. A thread can be disabled only if the acms_state value is not STOPPED.
• acms_state
  Actual execution state. Interfaces go through the following states:
  • INITING
    The Remote Manager is in the process of creating the interface thread.
  • STARTING
    The interface thread has been created and is initializing.
  • STARTED
    The interface thread has completed initializing and is now running.
  • STOPPING
    The thread is starting shutdown, as the result of either a stop request or a fatal error.
  • STOPPED
    The thread is no longer executing.
• get_request_count
  The number of read requests submitted to the interface. This includes requests that are rejected because of authorization failures.

• set_request_count
  The number of write requests submitted to the interface. This includes requests that are rejected because of authorization failures.
• alarms_sent
  The number of alarms that have been sent by this interface. For SNMP, these are SNMP traps. For RPC, this field is undefined.
• time_alarm_last_sent
  The time the most recent alarm was sent by this interface. For SNMP, this is the time the last SNMP trap was sent. For RPC, this field is undefined.

The Manager Status table contains run-time values that reflect Remote Manager activity. This table is maintained internally by the Remote Manager and is read only to all external entities. Values in the table can be accessed through one of the supported interfaces. No changes can be made to the table by external users.

In general, the values in this table are informational only.

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

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

• collection_count
  Current number of Collection table entries.
• interfaces_count
  Current number of entries in the Interfaces table.
• timer_count
  Current number of entries in the Timer table.
• trap_count
  Current number of entries in the Trap table.

• rpc_udp_state
  Current state of the RPC interface using the UDP protocol. A value of 1 means that the UDP protocol is active. A value of 0 means that the UDP protocol is inactive.
• rpc_tcp_state
  Current state of the RPC interface using the TCP protocol. A value of 1 means that the UDP protocol is active. A value of 0 means that the UDP protocol is inactive.

The Parameter table contains values that control the operation of the ACMS Remote Manager and that are not directly related to any ACMS entity. This table is populated initially from the ACMSCFG file. The Remote Manager maintains the table internally at run time; users can access data in the table only through one of the supported interfaces. Changes made to the table at run time are lost when the Remote Manager is stopped.

In general, the values in this table should be modified for fine tuning only, and only if a demonstrated need exists.

• S---SNMP
• R---RPC (API and ACMSMGR utility)
• F---File (configuration file)
• D---Field is dynamic.