Following are descriptions of the fields in Table 8-10.

• 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 4.1 and Section 8.3 for discussions of data collection.
• appl_name
  Name of the application to which this server type belongs.
• task_group_name
  Name of this task group.

• build_time
  The date and time the task group database (TDB) was built.
• 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 4.1 and Section 8.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.
• tws_pool_total
  The total size of the TWS pool allocated for this task group. The frequency with which this field is updated is based on the value of the Parameter table field wksp_coll_interval (see Table 8-7).
• tws_pool_free
  The amount of unused TWS pool this task group. The frequency with which this field is updated is based on the value of the Parameter table field wksp_coll_interval (see Table 8-7).
• tws_pool_largest
  The largest unused block available in this task group's TWS pool. The frequency with which this field is updated is based on the value of the Parameter table field wksp_coll_interval (see Table 8-7).
• tws_pool_failures
  The number of failed attempts to allocate space in the TWS pool for this task group, The frequency with which this field is updated is based on the value of the Parameter table field wksp_coll_interval (see Table 8-7).
• tws_pool_garbage
  The number of garbage collections that have been run to reclaim space in this task group's TWS pool. The frequency with which this field is updated is based on the value of the Parameter table field wksp_coll_interval (see Table 8-7).
• twsc_pool_total
  The total size of the TWSC pool allocated for this task group. The frequency with which this field is updated is based on the value of the Parameter table field wksp_coll_interval (see Table 8-7).
• twsc_pool_free
  The amount of unused TWSC Pool for this task group. The frequency with which this field is updated is based on the value of the Parameter table field wksp_coll_interval (see Table 8-7).
• twsc_pool_largest
  The largest unused block available in this task group's TWSC pool. The frequency with which this field is updated is based on the value of the Parameter table field wksp_coll_interval (see Table 8-7).

• twsc_pool_failures
  The number of failed attempts to allocate space in this task group's TWSC pool. The frequency with which this field is updated is based on the value of the Parameter table field wksp_coll_interval (see Table 8-7).
• twsc_pool_garbage
  The number of garbage collections that have been run to reclaim space in this task group's TWSC pool. The frequency with which this field is updated is based on the value of the Parameter table field wksp_coll_interval (see Table 8-7).

The Trap table is used to control which events trigger the Remote Manager to generate an SNMP trap. The ACMS Remote Manager populates this table from the configuration file at system startup. Thereafter, users make modifications to this table through either the SNMP interface or the ACMSMGR interface.

The primary key to this table is the combination of entity, name, and parameter. Duplicate rows are not allowed.

Table 8-11 Trap Table

Field	Data Type	SNMP Access	RPC Access	Configuration Access	Dynamic
entity	integer	R	RW	RW	D
name	string	R	RW	RW	D
parameter	integer	R	RW	RW	D
min_value	integer	RW	RW	RW	D
max_value	integer	RW	RW	RW	D
severity	integer	RW	RW	RW	D
alarms_sent	integer	R	R
alarm_last_sent	integer	R	R
trap_delete	integer	RW			D

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

• entity
  Name or type of the entity. Valid values are ACC, CP, EXC, MGR, QTI, and TSC. Symbolic values for the RPC interface are defined in Section 7.1.4. This value for entity cannot be changed from the SNMP interface.

• name
  A name for the entity that helps to uniquely identify an instance of the entity type. This value cannot be changed from the SNMP interface. Possible entity names are:
  • ACC, CP, QTI, TSC (process name)
  • EXC (application name)
  • GROUP (task group name)
  • MGR: Must be *
  • SERVER (server name): One of the following wildcard values:
    • asterisk (*) (matches all characters)
    • exclamation point (!) (negation)
• parameter
  Parameter specifies the value or condition to be monitored for potential alarms. This value cannot be changed from the SNMP interface.
  Not all parameters are valid for all entity types (see Table 8-12). Valid values are:
  • EVENT_SEVERITY
    This parameter causes a test to be performed each time an auditable event is raised in the Remote Manager. Remote Manager events are filtered using the fields in the Parameter table (see Section 8.8) and are stored in the Remote Manager log (see Section 3.7). Events are monitored for traps even if the event is not currently being logged.
  • EXISTS
    This parameter causes a test to be performed each time the Remote Manager detects that a process has started or stopped.
• min_value
  The minimum allowable value for the parameter. Valid minimums are parameter dependent (see Table 8-12). If the field or condition being monitored is less than the value specified, an alarm is generated. A value of -1 is used when this field is not to be evaluated.
• max_value
  The maximum allowable value for the parameter. Valid maximums are parameter dependent (see Table 8-12). If the field or condition being monitored is greater than the value specified, an alarm is generated. A value of -1 is used when this field is not to be evaluated.
• severity
  A severity to be associated with the trap. Severity codes are embedded in the trap message (see Section 8.12.3) and must be parsed by the trap receiver. Valid values are:
  • INFO
  • WARN
  • ERROR
  • FATAL
• alarms_sent
  A count of the number of alarms that have been sent.
• alarm_last_sent
  The date and time the last alarm was sent.
• trap_delete
  This field is available only through the SNMP interface. Set this field to 1 to delete the table row. RPC users call the procedure shown in Section 7.5. ACMSMGR and ACMSCFG each provide a DELETE TRAP command for this purpose.

Table 8-12 lists the values that can be specified as the minimum or maximum for each parameter type.

Table 8-12 Trap Minimums and Maximums

Parameter	Value	Meaning	Valid for These Entities
EVENT_SEVERITY	1 1	Informational	MGR
	2 1	Warning	MGR
	4 1	Error	MGR
	8 1	Fatal	MGR
	--1 2	Ignore this field.	MGR
EXISTS	0 3	Stopped	ACC, CP, EXC, QTI, TSC
	1 4	Started	ACC, CP, EXC, QTI, TSC
	--1 2	Ignore this field.	ACC, CP, EXC, QTI, TSC

The following is the format of an SNMP trap message. Note that the message is generated as an ASCII string. Fields within the string are separated by a colon.

time: severity: entity_type: entity_name: parameter: value

In this format:

• time is a 23-character ASCII time in the format DD-MMM-YYYY HH:MM:SS.hh.
• severity is a single ASCII character that specifies the severity as determined from the severity field in the table that raised the alarm. Severities are:
  • I (informational)
  • W (warning)
  • E (error)
  • F (fatal)
• entity_type is one of the valid entity types (ACC, TSC, QTI, EXC, CP, MGR) and represents the entity that caused the alarm to be raised.
• entity_name is the process name of the entity that raised the alarm.
• parameter is the parameter that caused the alarm to be raised.
• value is the value that caused the alarm to be raised.

The TSC table contains a single entry for TSC management information.

Table 8-13 TSC 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
CONFIG	config_coll_state	integer	R	R
CONFIG	tsc_priority_active	integer	R	R
CONFIG	acms_state	integer	RW	R	D
CONFIG	tsc_priority_stored	integer	RW	RW
CONFIG	tsc_username_active	string	R	R
CONFIG	tsc_username_stored	integer	RW	RW
CONFIG	cp_priority_active	integer	R	R
CONFIG	cp_priority_stored	integer	RW	RW
CONFIG	cp_slots_active	integer	R	R
CONFIG	cp_slots_stored	integer	RW	RW
CONFIG	max_logins_active	integer	RW	RW	D
CONFIG	max_logins_stored	integer	RW	RW
CONFIG	max_tts_cp_active	integer	RW	RW	D
CONFIG	max_tts_cp_stored	integer	RW	RW
CONFIG	perm_cps_active	integer	RW	RW	D
CONFIG	perm_cps_stored	integer	RW	RW
CONFIG	min_cpis_active	integer	RW	RW	D
CONFIG	min_cpis_stored	integer	RW	RW
CONFIG	cp_username_active	integer	R	R
CONFIG	cp_username_stored	integer	RW	RW
RUNTIME	runtime_coll_state	integer	R	R
RUNTIME	current_users	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

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

• 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 4.1 and Section 8.3 for discussions of data collection.
• process_name
  The OpenVMS process name for the process.
• pid
  The OpenVMS process identifier for 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.

• 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 4.1 and Section 8.3 for discussions of data collection.
• tsc_priority_active
  The base priority for this process. This is the value of the ACMSGEN field when the process was started.
• tsc_priority_stored
  The base priority currently stored in the ACMSGEN file for this process.
• tsc_username_active
  The OpenVMS account under which the TSC will run. The tsc_username_active is the value of the ACMSGEN field when the process was started.
• tsc_username_stored
  The value of the tsc_username field currently stored in the ACMSGEN file.
• cp_priority_active
  The base priority for CP processes. This is the value of the ACMSGEN field when the TSC process was started.
• cp_priority_stored
  The base priority currently stored in the ACMSGEN file for CP processes.
• cp_slots_active
  The current number of CP slots. This is the value of the ACMSGEN field when the TSC process was started. This field also represents the maximum number of entries in the CP table.
• cp_slots_stored
  The value of the cp_slots field in the current ACMSGEN file.
• max_logins_active
  The current maximum number of logins allowed.
• max_logins_stored
  The value of the max_logins field in the current ACMSGEN file.
• max_tts_cp_active
  The current maximum number of terminals that a CP will support.
• max_tts_cp_stored
  The value of the max_tts_cp field in the current ACMSGEN file.
• perm_cps_active
  The number of permanent CPs that will be maintained on the system.
• perm_cps_stored
  The value of the perm_cps field in the current ACMSGEN file.
• min_cpis_active
  The number of CP slots that will be left open on a given CP.

• min_cpis_stored
  The value of the min_cpis field in the current ACMSGEN file.
• cp_username_active
  The current user name under which CP processes will run.
• cp_username_stored
  The value of the cp_username field in the current ACMSGEN file.
• acms_state
  Current ACMS state of the 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 4.1 and Section 8.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_users
  The current number of terminal users in all CPs started by this TSC.
• 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 4.1 and Section 8.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 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 8-7).
• mss_process_free
  The amount of unused 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 8-7).
• mss_process_largest
  The largest unused block 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 8-7).
• 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 8-7).

• mss_process_garbage
  The number of garbage collections 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 8-7).