Event Notification Facility › SNMP Monitor › Environment Variables

Environment Variables

The SNMP Monitor runs with a set of environment variables. You can override the default values of these variables by customizing the SNMPVARS parmlib member specified by the ENVVAR DD statement in your ENFSNMPM procedure. A sample is distributed in the CAW0OPTV data set.

SNMP_ECHO_CONFIG_FILE

Specify SNMP_ECHO_CONFIG_FILE=Y to echo the configuration file to CAW1LOG. For security reasons the default is not to echo (mainly for SNMPv3 considerations).

Default: SNMP_ECHO_CONFIG_FILE=N

CAICATD0000

Specifies the enterprise object identifier (OID).

Default: 1.3.6.1.4.1.791, which is the CA enterprise OID

CAICATD0001

Specifies the system default description, which is the MIB-II machine-specific information for the system. It takes the form of an OID and is used only by the CA security API.

SNMP_CACHE_TIMEOUT

Specifies the time in seconds to hold valid DNS lookup values in cache (reduce DNS calls). Entries will be re-validated after the time interval.

Default: 600

SNMP_CACHE_WAIT

Specifies the time in to wait after an attempt to resolve a name has failed before attempting again to resolve the name. (Allows for DSN updating.)

Default: 60

SNMP_DEBUG

Indicates whether debugging messages should be issued. You can specify SNMP_DEBUG=Y to issue the messages.

Default: SNMP_DEBUG=N.

SNMP_TRACE

Indicates whether tracing messages should be issued. You can specify SNMP_TRACE=Y to issue the messages.

Default: SNMP_TRACE=N.

SAPI_ROUTER

Specifies the node name for the CA Audit machine.

Default: none

SAPI_ROUTERPORT

Specifies a fixed port number for CA Audit machine if portmapper not available.

Default: 111

IP_STACK

Specifies the TCP/IP stack to be used. The format is IP_STACK=TCPIP-JOBNAME.

Default: default TCP/IP stack

TZ

Specifies the time zone Affects the timestamp on messages. See the appendix on “Setting the Local Time Zone with the TZ Environmental Variable” in the z/OS UNIX System Services Command Reference.

Configuration File

Beginning with CA Common Services for z/OS Version 14.0, the SNMP Monitor runs with a configuration file. Customize the SNMPCNFG parmlib member specified by the CONFIG DD statement in your ENFSNMPM procedure. A sample is distributed in the CAW0OPTV data set.

The basic syntax is:

node port protocol parameters

The full description is contained in the sample. The node corresponds to the “node” in the CAIENF Event which is set by the product creating the Event. Consult the product documentation to determine how the node is set.

If using only the simple SNMP TRAP protocol (as in versions of the SNMP Monitor prior to Version 14.0), a simple one line configuration is all that is necessary. Specify the node as an asterisk, the port with the port number (in versions prior to Version 14.0, this was supplied by the environmental variable SNMP_PORT), the protocol as “snmpv1” and for parameters, specify the SNMP community (in versions prior to Version 14.0, this was supplied by the environmental variable SNMP_COMMUNITY, the default was “public”). See the sample for an example of this entry.

If using SNMPv2 or SNMPv3, see the sample for a full description of the parameters.

For SNMPv3, the ENGINEID can be set for each target host so that the SNMP Monitor can participate in any number of SNMP administratively defined environments. Both MD5 and SHA-1 are supported for authentication; only DES is supported for privacy (encryption).