The Users table contains information about users who have logged in to Remote Manager, either explicitly (using a user name and password) or implicitly (using a proxy account). 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. External users cannot make changes to this table.

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

Table 8-14 Users Table

Field Name	Data Type	SNMP Access	RPC Access	Dynamic
client_id	integer	R	R
gid	short integer	R	R
uid	short integer	R	R
proxy_gid	short integer	R	R
proxy_uid	short integer	R	R
nodename	string	R	R
expires	string	R	R
uname	string	R	R
rights	integer array	R	R
proxy_flag	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-14.

• client_id
  Unique number that identifies this client.
• gid
  Group portion of the user's UIC on the client node.
• uid
  User portion of the user's UIC on the client node,
• proxy_gid
  Group portion of the UIC from the proxy account on the server node.

• proxy_uid
  User portion of the UIC from the proxy account on the server node.
• nodename
  Name of client node. This is the only node from which the client ID is valid.
• expires
  Date and time the user log in expires. Full OpenVMS ASCII date (DD-MMM-YYYY HH:MM:SS.hh).
• uname
  Account name of the account being used for authorization. This can be the account name for the proxy.
• rights
  Rights held by the user. This is an array of three elements. The first element contains the ACMS$MGMT_READ rights identifier; the second contains the ACMS$MGMT_WRITE rights identifier; the third contains the ACMS$MGMT_OPER identifier. A value of 0 indicates the user does not hold the right.
• proxy_flag
  A flag indicating whether the user has explicitly logged in (value of 0) or implicitly logged in by means of proxy (value of 1).

This chapter provides reference information about the commands of the ACMSCFG utility.

9.1 ACMSCFG Overview

The ACMSCFG utility is provided for performing operations on the ACMS Remote Manager configuration file. Similar to the ACMSMGR utility (described in Chapter 10), the ACMSCFG utility performs only a subset of the operations that the ACMSMGR utility performs.

The ACMSCFG utility performs operations on the Remote Manager configuration file only, and only on configuration files that are directly accessible to the process running the utility.

Section 3.2 discusses the purpose and use of the configuration file, as well as file defaults.

9.1.1 Command Format

The format for ACMSCFG commands is as follows:

ACMSCFG verb object qualifiers

The following verbs are supported:

• ADD
• DELETE
• HELP
• SET
• SHOW

Each verb has associated objects. The following sections list the objects and any qualifiers for each ACMSCFG command.

9.1.2 Command Objects and Qualifiers

The objects and qualifiers for the ACMSCFG commands are summarized in Table 9-1.

Table 9-1 ACMSCFG Command Objects and Qualifiers

Objects	Qualifiers
ADD Command
COLLECTION	/CLASS, /COLL_STATE, /ENTITY, /NAME
TRAP	/ENTITY, /NAME, /PARAMETER, /SEVERITY, /TRAP_MIN, /TRAP_MAX
DELETE Command
COLLECTION	/CLASS, /ENTITY, /NAME
TRAP	/ENTITY, /NAME, /PARAMETER
SET Command
COLLECTION	/CLASS, /COLL_STATE, /ENTITY, /NAME
INTERFACE	/INTERFACE, /STATE
PARAMETER	/DCL_AUDIT_LEVEL, /DCL_MGR_PRIORITY, /DCL_STACKSIZE, /EVENT_LOG_PRIORITY, /LOG_STACKSIZE, /LOGIN_CREDS_LIFETIME, /MAX_LOGINS, /MAX_RPC_RETURN_RECS, /MGR_AUDIT_LEVEL, /MSG_PROC_AUDIT_LEVEL, /MSG_PROC_PRIORITY, /MSG_PROC_STACKSIZE, /MSS_COLL_INTERVAL, /PROC_MON_AUDIT_LEVEL, /PROC_MON_INTERVAL, /PROC_MON_PRIORITY, /PROC_MON_STACKSIZE, /PROXY_CREDS_LIFETIME, /RPC_AUDIT_LEVEL, /RPC_PRIORITY, /RPC_STACKSIZE, /SECURITY_AUDIT_LEVEL, /SNMP_AGENT_TIME_OUT, /SNMP_ARE_YOU_THERE, /SNMP_AUDIT_LEVEL, /SNMP_PRIORITY, /SNMP_SEL_TIME_OUT, /SNMP_STACKSIZE, /TIMER_AUDIT_LEVEL, /TIMER_INTERVAL, /TIMER_PRIORITY, /TIMER_STACKSIZE, /TOTAL_ENTITY_SLOTS, /TRACE_MSG_WAIT_TIME, TRACE_START_WAIT_TIME, /TRAP_AUDIT_LEVEL, /TRAP_PRIORITY, /TRAP_STACKSIZE, /WKSP_COLL_INTERVAL
TRAP	/ENTITY, /NAME, /PARAMETER, /SEVERITY, /TRAP_MIN, /TRAP_MAX
SHOW Command
COLLECTION	None
CONTROL	None
INTERFACE	None
PARAMETER	None
TRAP	None

9.2 ACMSCFG ADD COLLECTION

Format

ACMSCFG ADD COLLECTION [/qualifiers]

Command Qualifier	Default
/CLASS=keyword	* (all)
/COLL_STATE=keyword	DISABLED
/ENTITY=keyword	None
/NAME=[*,entity-name]	* (all)

Privileges Required

None.

Parameters

None.

Qualifiers

/CLASS=[*, CONFIG, ID, POOL, RUNTIME]

This qualifier determines the class that will be enabled or disabled. The default is all (*).

See Section 4.1.1 for a description of each class type.

/COLL_STATE=[DISABLED, ENABLED]

This qualifier determines the state of the collection. The default is DISABLED.

/ENTITY=[*, ACC, CP, EXC, GROUP, QTI, SERVER, TSC]

This required qualifier determines the entity or entities for which collection should be enabled or disabled.

/NAME=[*,entity-name]

This qualifier specifies particular instances of an entity. Wildcards (*, !) are allowed in names.

For ACC, CP, QTI, and TSC entity types, the entity name is the process name. For EXCs, the entity name is the name of the application (for example, VR_APPL).

Server and task group names can be specified as compound names made up of application name and server or task group name, separated by a period (for example, VR_APPL.VR_READ_SERVER). Either part of server or task group name can be a wildcard (for example, *.VR_READ_SERVER or VR_APPL.*). If only one part of a server or task group name is specified, it is assumed to be the application name, and a wildcard is used as the server or task group name. For example, VR_APPL is equivalent to VR_APPL.*.

The default is all (*), which is equivalent to *.* for a compound name.

Notes

When adding new collection records, the combination of class, entity, and name must be unique.

It is not possible to add records for the ID and CONFIG class. By default, all ACMS processes collect ID and CONFIG class data.

When multiple collection records apply to a given process, the records are assigned weights according to a precedence of name, then entity, and then class. Within a column, wildcard entries are weighted less than nonwildcard entries. The row with the highest weight that applies to a process is used. The command ACMSMGR SHOW COLLECTIONS displays weights for each row in the table. See Section 4.1.1 for a discussion of the Collection table and how weights are assigned.

See Section 10.2 for a discussion about adding collection records at run time.

Examples

$  ACMSCFG ADD COLLECTION/ENTITY=EXC/CLASS=RUNTIME/NAME=VR_APPL
      

This command creates an entry in the Collection table in the configuration file.

9.3 ACMSCFG ADD TRAP

Format

ACMSCFG ADD TRAP [/qualifiers]

Command Qualifier	Default
/ENTITY=keyword	None
/NAME=[*,entity-name]	* (all)
/PARAMETER=keyword	EXISTS
/SEVERITY=[I,W,E,F]	E
/TRAP_MIN=value	-1
/TRAP_MAX=value	-1

Privileges Required

None.

Parameters

None.

Qualifiers

/ENTITY=[*, ACC, CP, EXC, MGR, QTI, TSC]

This required qualifier determines the entities for which a trap should be set.

/NAME=[*,entity-name]

This qualifier specifies particular instances of an entity. In general, the entity name is the process name. The exceptions are the EXC entity and the MGR entity.

For the EXC entity, use the assigned application name.

For the MGR entity, you must specify all (*).

Wildcards (*, !) are allowed in names. The default qualifier is the asterisk (*) wildcard.

/PARAMETER=[EVENT_SEVERITY, EXISTS]

The field that should be monitored. Valid values are:

• EVENT_SEVERITY
  This parameter is used for monitoring internal Remote Manager events. The Remote Manager logs internal events in the Remote Manager log. (See Section 3.7 and Section 10.25 for discussions of the Remote Manager log.) Traps can be generated based on the severity levels of these events.
• EXISTS
  This parameter is used for monitoring process existence. Traps are generated if the associated entity type and name either start or stop.

/SEVERITY=[I, W, E, F]

A severity to be associated with the trap. Severity codes are embedded in the trap message and must be parsed by the trap receiver. Severities can be informational (I), warning (W), error (E), and 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 value. See Table 8-11 for a list of valid /TRAP_MIN 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 value. See Table 8-11 for a list of valid /TRAP_MAX values.

Notes

When adding new trap records, the combination of entity, name, and parameter must be unique.

See Section 8.12.2 for a discussion about setting appropriate trap minimums and maximums. See Section 8.12.3 for a description of the trap message generated.

Examples

$  ACMSCFG ADD TRAP /ENTITY=ACC/PARAMETER=EXISTS/TRAP_MIN=1
      

This command causes an SNMP trap to be generated whenever the ACC process stops if the SNMP interface is running.

9.4 ACMSCFG DELETE COLLECTION

Format

ACMSCFG DELETE COLLECTION [/qualifiers]

Command Qualifier	Default
/CLASS=keyword	* (all)
/ENTITY=keyword	None
/NAME=[*,entity-name]	* (all)

Privileges Required

None.

Parameters

None.

Qualifiers

/CLASS=[*, CONFIG, ID, POOL, RUNTIME]

This qualifier determines the class that will be enabled or disabled.

See Section 4.1.1 for a description of each class type.

/ENTITY=[*, ACC, CP, EXC, GROUP, QTI, SERVER, TSC]

This required qualifier determines the entities for which collection should be enabled or disabled.

/NAME=[*,entity-name]

This qualifier specifies particular instances of an entity. Wildcards (*, !) are allowed in names.

For ACC, CP, QTI, and TSC entity types, the entity name is the process name. For EXCs, the entity name is the name of the application (for example, VR_APPL).

Server and task group names can be specified as compound names made up of application name and server or task group name, separated by a period (for example, VR_APPL.VR_READ_SERVER). Either part of server or task group names can be a wildcard (for example, *.VR_READ_SERVER or VR_APPL.*). If only one part of a server or task group name is specified, it is assumed to be the application name, and a wildcard is used as the server or task group name. For example, VR_APPL is equivalent to VR_APPL.*.

The default is all (*), which is equivalent to *.* for a compound name.

Notes

When deleting collection records, the combination of class, entity, and name must exactly match the row to be deleted.

It is not possible to delete records for the ID and CONFIG class. By default, all ACMS processes collect ID and CONFIG class data.

When multiple collection records apply to a given process, the records are assigned weights according to a precedence of name, then entity, then class. Within a column, wildcard entries are weighted less than nonwildcard entries. The row with the highest weight that applies to a process is used. The ACMSMGR SHOW COLLECTIONS command displays weights for each row in the table. See also Section 4.1.1 for a discussion of the Collection table and how weights are assigned.

See Section 10.4 for a discussion about deleting collection records at run time.

Examples

$  ACMSCFG DELETE COLLECTION/ENTITY=EXC/CLASS=RUNTIME/NAME=VR_APPL
      

This command deletes the entry in the Collection table for run-time collection by the VR_APPL application.

9.5 ACMSCFG DELETE TRAP

Format

ACMSCFG DELETE TRAP [/qualifiers]

Command Qualifier	Default
/ENTITY=keyword	None
/NAME=[*,entity-name]	* (all)
/PARAMETER=keyword	EXISTS

Privileges Required

None.

Parameters

None.

Qualifiers

/ENTITY=[*, ACC, CP, EXC, MGR, QTI, TSC]

This required qualifier determines the entity or entities for which a trap should be set.

/NAME=[*,entity-name]

This qualifier specifies particular instances of an entity. In general, the entity name is the process name. The exceptions are the EXC entity and the MGR entity.

For the EXC entity, use the assigned application names.

For the MGR entity, you must specify all (*).

Wildcards (*, !) are allowed in names. The default qualifier is the asterisk (*) wildcard.

/PARAMETER=[EVENT_SEVERITY,EXISTS]

The field that should be monitored. Valid values are:

• EVENT_SEVERITY
  This parameter is used for monitoring internal Remote Manager events. The Remote Manager logs internal events in the Remote Manager log. (See Section 3.7 and Section 10.25 for discussions of the Remote Manager log.) Traps can be generated based on the severity levels of these events.
• EXISTS
  This parameter is used for monitoring process existence. Traps are generated if the associated entity type and name either start or stop.

Notes

When deleting trap records, the combination of entity, name, and parameter must exactly match a row in the Trap table.

Examples

$  ACMSCFG DELETE TRAP/ENTITY=ACC/PARAMETER=EXISTS
      

This command deletes a trap from the Trap table in the configuration file.

9.6 ACMSCFG SET COLLECTION

Format

ACMSCFG SET COLLECTION [/qualifiers]

Command Qualifier	Default
/CLASS=keyword	* (all)
/COLL_STATE=keyword	DISABLED
/ENTITY=keyword	None
/NAME=[*,entity-name]	* (all)

Privileges Required

None.

Parameters

None.

Qualifiers

/CLASS=[*, CONFIG, ID, POOL, RUNTIME]

This qualifier determines the class that will be enabled or disabled.

See Section 4.1.1 for a description of each class type.

/COLL_STATE=[DISABLED, ENABLED]

This qualifier determines the state of the collection.

/ENTITY=[*, ACC, CP, EXC, GROUP, QTI, SERVER, TSC]

This required qualifier determines the entities for which collection should be enabled or disabled.

/NAME=[*,entity-name]

This qualifier specifies particular instances of an entity. Wildcards (*, !) are allowed in names.

For ACC, CP, QTI, and TSC entity types, the entity name is the process name. For the EXC entity, the entity name is the name of the application (for example, VR_APPL).

Server and task group names can be specified as compound names made up of application name and server or task group name, separated by a period (for example, VR_APPL.VR_READ_SERVER). Either part of server or task group names can be a wildcard (for example, *.VR_READ_SERVER or VR_APPL.*). If only one part of a server or task group name is specified, it is assumed to be the application name, and a wildcard is used as the server or task group name. For example, VR_APPL is equivalent to VR_APPL.*.

The default is all (*), which is equivalent to *.* for a compound name.

Notes

When updating collection records, the combination of class, entity, and name must exactly match a record in the collection table.

It is not possible to update records for the ID and CONFIG class. By default, processes collect only ID and CONFIG class data during process initialization. If these classes were disabled during process startup, that information would not be available until the class was enabled and the process was restarted.

When multiple collection records apply to a given process, the records are assigned weights according to a precedence of name, then entity, then class. Within a column, wildcard entries are weighted less than nonwildcard entries. The row with the highest weight that applies to a process is used. The ACMSMGR SHOW COLLECTIONS command displays weights for each row in the table. See Section 4.1.1 for a discussion of the Collection table and how weights are assigned.

ACMS processes read the collection table during process startup to determine which classes to begin collecting.

Once the Remote Manager has been started, the ACMSMGR SHOW PROCESS command can be used to determine the class states for the currently running ACMS processes.

Examples

$  ACMSCFG SET COLLECTION/ENTITY=EXC/CLASS=RUNTIME/NAME=VR_APPL/COLL_STATE=DISABLED
      

This command disables run-time data collection for the VR_APPL application.