An installation can set values for selected MIB objects by providing
OSNMPD.DATA information. A sample of OSNMP.DATA is installed as file
/usr/lpp/tcpip/samples/osnmpd.data. See
z/OS Communications Server: IP Configuration
Reference for syntax information. If no OSNMPD.DATA
file is found, the defaults for these MIB objects are as follows:
- Object
- Default
- dpiPathNameForUnixStream
- The default is /var/dpi_socket. This is the z/OS® UNIX path
name that is used in accepting requests from subagents that communicate
with the agent over z/OS UNIX connections.
The SNMP agent
creates this path name every time it initializes. For subagents to
successfully connect to the agent using this path name, either the
subagents must be defined with superuser authority or the read and
write file access permission bits for the path name must be set as
follows:
- If the user ID of a subagent is associated with the same security
product group as the agent, read and write access must be set in the
Group section of the file access permission bits.
- If the user ID of a subagent is not associated with the same security
product group as the agent, read and write access must be set in the
Other section of the file access permission bits.
You can configure the read and write access by specifying
the -C agent initialization parameter.
For more detailed information
about file access permission bits and handling security for your files, see z/OS UNIX System Services User's Guide. If you need to change the file access permission
bits for this path name after the agent has initialized, you can use
the z/OS UNIX chmod command. For more
information about the chmod command, see z/OS UNIX System Services Command Reference.
- sysDescr
- If the environment variable HOSTNAME exists, its value is used.
Otherwise, the default value identifies the z/OS system under which the agent is running.
The maximum length of this object is 255 octets.
- sysContact
- "SNMPBASE-Unspecified". The maximum length of this object is 255
octets.
- sysLocation
- "SNMPBASE-Unspecified". The maximum length of this object is 255
octets.
- sysName
- "SNMPBASE-Unspecified". The maximum length of this object is
255 octets.
- sysObjectId
- 1.3.6.1.4.1.2.3.13
Note: sysObjectID is defined as the vendor's
authoritative identification of the network management subsystem contained
in the entity. That is, it is intended to uniquely identify the SNMP
agent. Changing this value is not recommended and will be disabled
in a subsequent release.
- sysServices
- A single octet with a default of 0. See the RFC 1907 description
for this object.
- snmpEnableAuthenTraps
- Default value is 2, which means traps are disabled.
- saDefaultTimeout
- 5 seconds.
- saMaxTimeOut
- 600 seconds.
- saAllowDuplicateIDs
- Default is 1, which means multiple instances of a subagent (that
is, where the subagent identifier for all the subagents is the same)
are allowed to connect to the SNMP agent. To prevent multiple instances
of a subagent from connecting to the SNMP agent, set the value to
2.
Note: Because a subagent identifier cannot be specified for subagents
connecting using the DPI V1.1 API, the SNMP agent assigns the same
constant identifier for all DPI V1.1 subagents. Therefore, this object
must be set to 1 to allow multiple DPI V1.1 subagents to run concurrently.
For more information about subagent identifiers, see
Allowing subagents with duplicate identifiers to connect.
For information about where these MIB objects are defined, see z/OS Communications Server: IP User's Guide and
Commands.
If creating a data set, you can specify a sequential data set with
the following attributes: RECFM=FB, LRECL=80, and BLKSZ=3120. Other
data set attributes might also work, depending on your installation
parameters.