z/OS Communications Server: IP Programmer's Guide and Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


DPI OPEN character set selection

z/OS Communications Server: IP Programmer's Guide and Reference
SC27-3659-02

The version of DPI Version 2.0 included with SNMP requires use of the EBCDIC character set. Any DisplayString MIB objects known to the agent (in its compiled MIB) supplied with SNMP will have ASCII conversion handled by the agent. The subagent will always deal with the values of these objects in EBCDIC. Any portion of an instance identifier that is a DisplayString must be in ASCII. The agent does not handle instance IDs.

When the DPI subagent sends a DPI OPEN packet, it must specify the character set that it wants to use. The subagent here needs to know or determine in an implementation dependent manner if the agent is running on a system with the same character set as the subagent. If you connect to the agent at loopback or your own machine, you might assume that you are using the same character set.

The DPI subagent has two choices:
DPI_NATIVE_CSET
Specifies that you want to use the native character set of the platform on which the agent that you connect to is running.
DPI_ASCII_CSET
Specifies that you want to use the ASCII character set. The agent will not translate between ASCII and the native character set.

Although you can specify ASCII, the SNMP agent does not support it.

The DPI packets have a number of fields that are represented as strings. The fields that must be represented in the selected character set are:
  • The null-terminated string pointed to by the description_p, enterprise_p, group_p, instance_p, and oid_p parameters in the various mkDPIxxxx(...) functions.
  • The string pointed to by the value_p parameter in the mkDPIset(...) function, that is if the value_type parameter specifies that the value is an SNMP_TYPE_DisplayString or an SNMP_TYPE_OBJECT_IDENTIFIER.
  • The null-terminated string pointed to by the description_p, enterprise_p, group_p, instance_p, and oid_p pointers in the various snmp_dpi_xxxx_packet structures.
  • The string pointed to by the value_p pointer in the snmp_dpi_set_packet structure, that is if the value_type field specifies that the value is an SNMP_TYPE_DisplayString or an SNMP_TYPE_OBJECT_IDENTIFIER.
See the following related information.
Parent topic: SNMP agent Distributed Protocol Interface version 2.0

Go to the previous page Go to the next page

Notices | Terms of use | Support | Contact z/OS | zFavorites



Copyright IBM Corporation 1990, 2014