Compaq ACMS for OpenVMS
Remote Systems Management
Guide
9.6.1 Field Descriptions
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.
9.7 Interfaces Table
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 .
Table 9-6 Interfaces Table
Field |
Data Type |
SNMP Access |
RPC Access |
Configuration Access |
Dynamic |
interface
|
string
|
R
|
R
|
R
|
|
state
|
state1
|
RW
|
RW
|
RW
|
D
|
running_state
|
state2
|
R
|
R
|
R
|
|
get_request_count
|
integer
|
R
|
R
|
|
|
set_request_count
|
integer
|
R
|
R
|
|
|
alarms_sent
|
integer
|
R
|
R
|
|
|
time_alarm_last_sent
|
integer
|
R
|
R
|
|
|
Key to Access Modes
- R---Read Access
- RW---Read/Write Access
- Blank---Not available to the interface
- D---Field is dynamic.
9.7.1 Field Descriptions
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.
9.8 Manager Status Table
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.
Table 9-7 Manager Status Table
Field Name |
Data Type |
SNMP Access |
RPC Access |
Dynamic |
collection_count
|
integer
|
R
|
R
|
|
interfaces_count
|
integer
|
R
|
R
|
|
timer_count
|
integer
|
R
|
R
|
|
trap_count
|
integer
|
R
|
R
|
|
rpc_udp_state
|
state1
|
R
|
R
|
|
rpc_tcp_state
|
state1
|
R
|
R
|
|
Key to Access Modes
- R---Read Access
- RW---Read/Write Access
- Blank---Not available to the interface
- D---Field is dynamic
9.8.1 Field Descriptions
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.
9.9 Parameter Table
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.
Note
All the fields in Table 9-8 are of type integer, and all fields
have read and write access.
|
Table 9-8 Parameter Table
Field |
Default Value |
Minimum Value |
Maximum Value |
Dynamic |
Interface |
dcl_audit_level
|
E
|
0
|
F
|
D
|
S,R,F
|
dcl_mgr_priority
|
5
|
1
|
10
|
|
S,R,F
|
dcl_stacksize
|
300
|
1
|
2147483647
|
|
S,R,F
|
error_interval++
|
10
|
1
|
863999999
|
D
|
S,R,F
|
event_log_priority
|
5
|
1
|
10
|
|
S,R,F
|
log_stacksize
|
300
|
1
|
2147483647
|
|
S,R,F
|
login_creds_lifetime
|
60
|
1
|
14399999
|
D
|
S,R,F
|
max_logins
|
20
|
1
|
2147483647
|
D
|
S,R,F
|
max_rpc_return_recs
|
20
|
1
|
2147483647
|
|
S,R,F
|
mgr_audit_level
|
E
|
0
|
F
|
D
|
S,R,F
|
msg_proc_audit_level
|
E
|
0
|
F
|
D
|
S,R,F
|
msg_proc_priority
|
5
|
1
|
10
|
|
S,R,F
|
msg_proc_stacksize
|
300
|
1
|
2147483647
|
|
S,R,F
|
mss_coll_interval
|
10
|
1
|
863999999
|
D
|
S,R,F
|
proc_mon_audit_level
|
E
|
0
|
F
|
|
S,R,F
|
proc_mon_interval
|
30
|
1
|
14399999
|
D
|
S,R,F
|
proc_mon_priority
|
5
|
1
|
10
|
|
S,R,F
|
proc_mon_stacksize
|
300
|
1
|
2147483647
|
|
S,R,F
|
proxy_creds_lifetime
|
60
|
1
|
14399999
|
D
|
S,R,F
|
rpc_audit_level
|
E
|
0
|
F
|
D
|
S,R,F
|
rpc_priority
|
5
|
1
|
10
|
|
S,R,F
|
rpc_stacksize
|
300
|
1
|
2147483647
|
|
S,R,F
|
security_audit_level
|
E
|
0
|
F
|
D
|
S,R,F
|
snap_audit_level++
|
E
|
0
|
F
|
D
|
S,R,F
|
snap_priority++
|
5
|
1
|
10
|
|
S,R,F
|
snap_stacksize++
|
400
|
300
|
2147483647
|
|
S,R,F
|
snmp_agent_time_out
|
10
|
1
|
863999999
|
D
|
S,R,F
|
snmp_audit_level
|
E
|
0
|
F
|
D
|
S,R,F
|
snmp_are_you_there
|
300
|
1
|
863999999
|
|
S,R,F
|
snmp_priority
|
5
|
1
|
10
|
|
S,R,F
|
snmp_sel_time_out
|
5
|
0
|
863999999
|
|
S,R,F
|
snmp_stacksize
|
300
|
1
|
2147483647
|
|
S,R,F
|
tcp_enabled++
|
1
|
0
|
1
|
|
S,R,F
|
timer_audit_level
|
E
|
0
|
F
|
D
|
S,R,F
|
timer_interval
|
30
|
1
|
863999999
|
D
|
S,R,F
|
timer_priority
|
5
|
1
|
10
|
|
S,R,F
|
timer_stacksize
|
300
|
1
|
2147483647
|
|
S,R,F
|
total_entity_slots
|
20
|
1
|
2147483647
|
|
S,R,F
|
trace_msg_wait_time
|
5
|
1
|
14399999
|
D
|
S,R,F
|
trace_start_wait_time
|
5
|
1
|
14399999
|
D
|
S,R,F
|
trap_audit_level
|
E
|
0
|
F
|
D
|
S,R,F
|
trap_priority
|
5
|
1
|
10
|
|
S,R,F
|
trap_stacksize
|
300
|
1
|
2147483647
|
|
S,R,F
|
udp_enabled++
|
1
|
0
|
1
|
|
S,R,F
|
vms_coll_interval
|
10
|
1
|
863999999
|
D
|
S,R,F
|
wksp_coll_interval++
|
10
|
1
|
863999999
|
D
|
S,R,F
|
++Only valid for use with systems running ACMS Version 4.4 or higher.
Key to Interface
- S---SNMP
- R---RPC (API and ACMSMGR utility)
- F---File (configuration file)
- D---Field is dynamic.