gtpm2m35Migration Guide: Program Update Tapes

Simple Network Management Protocol Agent Support (APAR PJ27932)

The following section discusses the migration considerations for Simple Network Management Protocol (SNMP) agent support.

Prerequisite APARs

See the APEDIT for APAR PJ27932 for information about prerequisite APARs.

Functional Overview

SNMP is an industry-standard protocol that enables you to monitor and manage diverse and complex Transmission Control Protocol/Internet Protocol (TCP/IP) networks. SNMP is defined by a series of Request for Comments (RFC) documents that describe the flows and information that is communicated between the network management station and the different TCP/IP devices that are being managed. The SNMP architecture defines three entities:

The TPF 4.1 system provides agent support for SNMP Version 1 with a standard set of MIB variables (MIB-II). This allows an SNMP manager to monitor and manage the TPF 4.1 system as an SNMP agent. SNMP agent support provides the following:

Architecture

The SNMP architecture for standard TCP/IP network protocols is defined by the following RFC documents:

Go to http://www.ietf.org for more information about these RFCs and any related extensions.

The SNMP architecture is further defined by using a subset of the basic encoding rules (BER), which are documented in ISO 8825 Part 1: Basic Encoding Rules. Go to http://www.iso.ch/ to view ISO 8825.

Configuration Files

The SNMP architecture requires that you provide some information. This information is specified in the snmp.cfg SNMP configuration file. This file can be created on any platform and is placed in the basic subystem (BSS) TPF /etc directory.

See TPF Transmission Control Protocol/Internet Protocol for more information about the /etc/snmp.cfg SNMP configuration file and SNMP agent support.

Operating Environment Requirements and Planning Information

To ensure that your TPF 4.1 system performs correctly with SNMP agent support, you must establish the required operating environment. The following section describes hardware and software requirements specific to SNMP agent support.

Operating Environment Requirements and Planning Information provides information about the minimum system configuration requirements that are necessary to operate the TPF 4.1 system. You may find it helpful to review that chapter along with the following information.

Hardware

There are no hardware requirements.

Software (Programming Requirements)

The following section contains information about software requirements.

Communication

The following section summarizes the communication changes.

Operating Environment for TCP/IP-Based Communication

SNMP agent support requires an SNMP manager application that supports SNMP Version 1 on a remote platform.

Interface Changes

The following section summarizes interface changes.

C/C++ Language

The following section summarizes C/C++ language changes. This information is presented in alphabetic order by the type of C/C++ language information. See the TPF C/C++ Language Support User's Guide and TPF Application Programming for more information about the C/C++ language.

Build Scripts

Table 1131 summarizes changes to the build scripts used by the build tool. This information is presented in alphabetic order by the name of the build script.

Table 1131. Changes to Build Scripts for SNMP Agent Support

Build Script Type New, Changed, or No Longer Supported? Description of Change
CNMABS DLM New Created to start SNMP processing from the Internet daemon.
CNMPBS DLL New Created for SNMP agent support.
CNMTBS DLM New Created for SNMP trap processing.
CNM1BS DLM New Created for the ZSNMP command.
UCOMBS DLM New Created for the SNMP manager validation user exit (UCOM).
UMIBBS DLM New Created for the SNMP enterprise-specific MIB retrieval user exit (UMIB).

Dynamic Load Module (DLM) Stubs

Table 1132 summarizes changes to the dynamic load module (DLM) stubs. This information is presented in alphabetic order by the name of the DLM stub. See TPF Application Programming for more information about the DLM stubs.

Table 1132. Changes to Dynamic Load Module (DLM) Stubs for SNMP Agent Support

DLM Stub New or No Longer Supported?
CNMT New
UCOM New
UMIB New

General Use C/C++ Language Header Files

Table 1133 summarizes the general use C/C++ language header file changes. This information is presented in alphabetic order by the name of the general use C/C++ language header file.

General use means these header files are available for your use.

Table 1133. Changes to General Use C/C++ Language Header Files for SNMP Agent Support

C/C++ Language Header File New, Changed, or No Longer Supported? Do You Need to Recompile Segments? Segments to Recompile
c$ck2sn.h Changed No Not Applicable
c$snmp.h New No Not Applicable

Implementation-Specific C/C++ Language Header Files (IBM Use Only)

Table 1134 summarizes the general use C/C++ language header file changes that are for IBM use only. This information is presented in alphabetic order by the name of the general use C/C++ language header file.

Table 1134. Changes to Implementation-Specific C/C++ Language Header Files (IBM Use Only) for SNMP Agent Support

C/C++ Language Header File (IBM Use Only) New, Changed, or No Longer Supported? Do You Need to Recompile Segments? Segments to Recompile
i$snmp.h New No Not Applicable

Library Interface Scripts

There are no changes.

Link-Edited Modules

Table 1135 summarizes changes to the link-edited modules shipped by IBM, which should go into a data set with attributes DCB=(RECFM=U,LRECL=80,BLKSIZE=1200). This information is presented in alphabetic order by the name of the link-edited module.

Table 1135. Changes to Link-Edited Modules for SNMP Agent Support

Link-Edited Module New, Changed, or No Longer Supported? Description of Change
CNMA New Created for SNMP trap processing.
CNMP New Created for SNMP agent support.
CNMT New Created for SNMP trap processing.
CNM1 New Created for the ZSNMP commnd.
UCOM New Created for the SNMP manager validation user exit (UCOM).
UMIB New Created for the SNMP enterprise-specific MIB retrieval user exit (UMIB).

Members

Table 1136 summarizes changes to members. This information is presented in alphabetic order by the name of the member.

Notes:

  1. You must recompile or reassemble a member if it has changed.

  2. You must prelink and link a dynamic load module (DLM) if it has changed.

Table 1136. Changes to Members for SNMP Agent Support

Member DLM/DLL/LLM Name Type New, Changed, or No Longer Supported? Member Type Description of Change
CDNSSI CDNI DLM Changed C++ Language Updated to send LINKUP and LINKDOWN traps.
CNMA CNMA DLM New C++ Language Created to start SNMP processing from the Internet daemon.
CNME CNMP DLL New C++ Language Created for miscellaneous SNMP functions.
CNMF CNMP DLL New C++ Language Created for SNMP file refresh processing.
CNMIF CNMP DLL New Real-Time Assembler Created for SNMP MIB retrieval.
CNMIP CNMP DLL New Real-Time Assembler Created for SNMP MIB retrieval.
CNMM CNMP DLL New C++ Language Created for SNMP MIB retrieval.
CNMS CNMP DLL New C++ Language Created for the SNMP request message parser.
CNMT CNMT DLM New C++ Language Created for SNMP trap processing.
CNMTCP CNMP DLL New Real-Time Assembler Created for SNMP MIB retrieval.
CNMUDP CNMP DLL New Real-Time Assembler Created for SNMP MIB retrieval.
CNM1 CNM1 DLM New C++ Language Created for the ZSNMP command.
C536 COMX LLM Changed C Language Updated for SNMP agent support.
UCOM UCOM DLM New C++ Language Created for the SNMP manager validation user exit (UCOM).
UMIB UMIB DLM New C++ Language Created for the SNMP enterprise-specific MIB retrieval user exit (UMIB).

Object Code Only (OCO) Stubs

There are no changes.

Configuration Constant (CONKC) Tags

There are no changes.

Control Program Interface (CINFC) Tags

There are no changes.

Copy Members

Table 1137 summarizes the copy member changes. This information is presented in alphabetic order by the name of the copy member.

Table 1137. Changes to Copy Members for SNMP Agent Support

Copy Member Type New, Changed, or No Longer Supported Segment Where Copy Member is Included Name of Link-Edited Module DLM, DLL, LLM, or Control Program Description of Change
CTI1 Real-Time Assembler Changed CCTCP2 CPS0 Control Program Updated for SNMP counter updates.
CTI2 Real-Time Assembler Changed CCTCP2 CPS0 Control Program Updated for SNMP counter updates.
CTI3 Real-Time Assembler Changed CCTCP2 CPS0 Control Program Updated for SNMP counter updates.
CTI4 Real-Time Assembler Changed CCTCP2 CPS0 Control Program Updated for SNMP counter updates.
CTSM Real-Time Assembler Changed CCTCP3 CPS0 Control Program Updated for SNMP counter updates.
CTSS Real-Time Assembler Changed CCTCP3 CPS0 Control Program Updated for SNMP counter updates.
CTTO Real-Time Assembler Changed CCTCP1 CPS0 Control Program Updated for SNMP counter updates.
CTT5 Real-Time Assembler Changed CCTCP1 CPS0 Control Program Updated to send LINKUP and LINKDOWN traps.
CTT6 Real-Time Assembler Changed CCTCP1 CPS0 Control Program Updated for SNMP counter updates.
CTT8 Real-Time Assembler Changed CCTCP1 CPS0 Control Program Updated for SNMP counter updates.
CTX2 Real-Time Assembler Changed CCTCP1 CPS0 Control Program Updated to send LINKUP and LINKDOWN traps.
CT15 Real-Time Assembler Changed CCCTIN CPS0 Control Program Updated to carve out the SNMP table.

Fixed File Records

There are no changes.

Macros

The following section summarizes the macro changes. This information is presented in alphabetic order by the type of macro.

Advanced Program-to-Program Communications (APPC) Macros

There are no changes.

Communication Macros and Statements

There are no changes.

Data Macros

Table 1138 summarizes the data macro changes. This information is presented in alphabetic order by the name of the data macro.

Table 1138. Changes to Data Macros for SNMP Agent Support

Data Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs Using This Data Macro? Programs to Reassemble
CK2SN Changed No Not Applicable
IOSCR Changed No Not Applicable
ISNMP New No Not Applicable
ISTAK Changed Yes COE7, CTF3, CTF4, CTF5, CTSI, CTSJ, CTSX, CTSZ, CTS1

General Macros

Table 1139 summarizes the general macro changes. This information is presented in alphabetic order by the name of the general macro. See TPF General Macros for a complete description of all general macros.

Table 1139. Changes to General Macros for SNMP Agent Support

General Macro New, Changed, or No Longer Supported? Do You Need to Reassemble Programs? Programs to Reassemble
ITRPC New No Not Applicable

Selected Equate Macros

There are no changes.

Structured Programming Macros (SPMs)

There are no changes.

System Initialization Program (SIP) Skeleton and Internal Macros (Inner Macros)

Table 1140 summarizes the system initialization program (SIP) skeleton and internal macro changes. This information is presented in alphabetic order by the name of the SIP skeleton and internal macro. If the SIP skeleton and internal macro (inner macro) is changed, you must reassemble the SIP Stage I deck and run the appropriate job control language (JCL) jobs from the SIP Stage II deck.

Table 1140. Changes to SIP Skeleton and Internal Macros for SNMP Agent Support

SIP Skeleton and Internal Macro New, Changed, or No Longer Supported?
SPPGML Changed

System Initialization Program (SIP) Stage I Macros and Statements

There are no changes.

System Initialization Program (SIP) Stage II Macros

Table 1141 summarizes system initialization program (SIP) Stage II macro changes. This information is presented in alphabetic order by the name of the SIP Stage II macro. If IBMPAL is changed, you must run the system allocator (SALO) and load the new program allocation table (PAT) to the TPF 4.1 system.

Table 1141. Changes to SIP Stage II Macros for SNMP Agent Support

SIP Stage II Macro New, Changed, or No Longer Supported?
IBMPAL Changed

System Communication Keypoint (SCK) Generation Macros

There are no changes.

System Macros

There are no changes.

System Macros (IBM Use Only)

Table 1142 summarizes system macro changes that are for IBM use only. This information is presented in alphabetic order by the name of the system macro.

Table 1142. Changes to System Macros (IBM Use Only) for SNMP Agent Support

System Macro (IBM Use Only) New, Changed, or No Longer Supported? Do You Need to Reassemble Programs? Programs to Reassemble
DLTEC Changed No Not Applicable

Segments

Table 1143 summarizes segment changes. This information is presented in alphabetic order by the name of the segment.

Table 1143. Changes to Segments for SNMP Agent Support

Segment Type Link-Edit Module (Where Offline Segment Is Linked) New, Changed, or No Longer Supported? Description of Change
CCOSAE Object Code Only CPS0 Changed Updated for SNMP counter updates.
CMVW Real-Time Assembler Not Applicable Changed Updated to send LINKUP and LINKDOWN traps.
CMVX Real-Time Assembler Not Applicable Changed Updated to send LINKUP and LINKDOWN traps.
CNMR Real-Time Assembler Not Applicable New Created for the SNMP restart function.
COER Real-Time Assembler Not Applicable Changed Updated to call the SNMP restart function.
COE2 Real-Time Assembler Not Applicable Changed Updated for SNMP interface indexing.
COE3 Real-Time Assembler Not Applicable Changed Updated for SNMP interface indexing.
COE4 Real-Time Assembler Not Applicable Changed Updated for SNMP interface indexing.
COE5 Real-Time Assembler Not Applicable Changed Updated to send LINKUP and LINKDOWN traps.
COE9 Real-Time Assembler Not Applicable Changed Updated for SNMP interface indexing.
CTF2 Real-Time Assembler Not Applicable Changed Updated for SNMP interface indexing.
CTKT Real-Time Assembler Not Applicable Changed Updated the cycle-up process to call the SNMP file refresh function.
CTSR Real-Time Assembler Not Applicable Changed Updated to call the SNMP restart function.
CTSW Real-Time Assembler Not Applicable Changed Updated the socket sweeper for SNMP agent support.
CTS2 Real-Time Assembler Not Applicable Changed Updated for SNMP counter updates.
CTX3 Real-Time Assembler Not Applicable Changed Updated to send LINKUP and LINKDOWN traps.
CVAB Real-Time Assembler Not Applicable Changed Updated for the ZSNMP command.

System Equates

The are no changes.

User Exits

Control Program (CP) User Exits and ECB User Exits summarize the control program (CP) and ECB user exit changes. See TPF System Installation Support Reference for a complete description of all user exits.

Control Program (CP) User Exits

There are no changes.

ECB User Exits

This information is presented in alphabetic order by the name of the function.

Table 1144. Changes to ECB User Exits for SNMP Agent Support

Function User Exit Activated In User Exit Program New, Changed, or No Longer Supported? Description of Change
UCOM CNMS UCOM New Created for the SNMP manager validation user exit (UCOM).
UMIB CNMS UMIB New Created for the SNMP enterprise-specific MIB retrieval user exit (UMIB).

Functional and Operational Changes

The following section summarizes functional and operational changes. This information is presented in alphabetic order by the functional or operational change.

See Appendix A, "PUT 2-15 Interface Changes by Authorized Program Analysis Report (APAR)" for a summary of functional and operational changes by APAR.

Commands

Table 1145 summarizes command changes. This information is presented in alphabetic order by the name of the command. See TPF Operations for a complete description of all commands.

Attention: Changes to commands can impact any automation programs you are using in your complex.

Table 1145. Changes to Commands for SNMP Agent Support

Command New, Changed, or No Longer Supported? Description of Change
ZSNMP New Created for SNMP agent support.

Messages and System Errors

Table 1146 summarizes message (offline and online messages) and system error changes.

The message IDs or system error numbers are listed in numeric order preceded by their alphabetic prefix. Some offline and online messages do not have a standard message ID. For these, the messages are presented in alphabetic order based on the initial message text; or for those messages that begin with variable information, the initial message text that follows that variable information. See Messages (System Error and Offline) and Messages (Online) for a complete description of all messages and system errors.

Attention: Changes to offline messages, online messages, and system errors may impact any automation programs you are using in your complex.

Table 1146. Changes to Messages and System Errors for SNMP Agent Support

Message ID or System Error Number Message Type New, Changed, or No Longer Supported?
SNMP0001I Online New
SNMP0002E Online New
SNMP0003E Online New
SNMP0004E Online New
SNMP0005E Online New
SNMP0006E Online New
SNMP0007E Online New
SNMP0008E Online New
SNMP0009E Online New
SNMP0010W Online New
SNMP0011E Online New
SNMP0012E Online New
SNMP0013E Online New
SNMP0014E Online New
SNMP0015E Online New
SNMP0016E Online New
SNMP0017E Online New

Performance or Tuning Changes

There are no changes.

Storage Considerations and Changes

There are no changes.

System Initialization Program (SIP) and System Generation Changes

There are no changes.

Loading Process Changes

There are no changes.

Online System Load Changes

There are no changes.

Publication Changes

Table 1147 summarizes changes to the publications in the TPF library. This information is presented in alphabetic order by the publication title. See the TPF Library Guide for more information about the TPF library.

Table 1147. Changes to TPF Publications for SNMP Agent Support

Publication Title Softcopy File Name Description of Change
TPF C/C++ Language Support User's Guide GTPCLU0D Updated with the tpf_itrpc and tpf_snmp_BER_encode C functions that were added for SNMP agent support.
TPF General Macros GTPGEN0C Updated with the ITRPC macro that was added for SNMP agent support.
TPF Library Guide GTPDOC0D Updated with definitions for new terminology for SNMP agent support.
Messages (System Error and Offline) and Messages (Online) Not Applicable Updated with information about messages and system errors that were added, changed, and no longer supported for SNMP agent support.
TPF Migration Guide: Program Update Tapes GTPMG203 Updated with migration considerations for SNMP agent support.
TPF Operations GTPOPR0D Updated with information about the ZSNMP command that was added for SNMP agent support.
TPF Program Development Support Reference GTPPDR0D Updated with main storage dump labels that were added for SNMP agent support.
TPF System Installation Support Reference GTPINR0D Updated with information about the user exits that were added for the SNMP agent support.
TPF Transmission Control Protocol/Internet Protocol GTPCLW09 Updated with information about using SNMP agent support.

Host System Changes

There are no changes.

Application Programming Interface (API) Changes

SNMP agent support provides the following new APIs:

See TPF C/C++ Language Support User's Guide for more information about these APIs.

Database Changes

There are no changes.

Feature Changes

There are no changes.

Installation Validation

There are no changes.

Migration Scenarios

To install SNMP agent support on your existing TPF 4.1 system, do the following:

  1. Be sure TCP/IP native stack support (APAR PJ26683) is installed on your TPF 4.1 system. See TCP/IP Native Stack Support (APAR PJ26683) for more information.
  2. Install program update tape (PUT) 15.
  3. IPL the TPF 4.1 system and cycle to NORM state.
  4. Create the snmp.cfg SNMP configuration file and transfer (FTP) it into the /etc directory of the BSS file system.
  5. From the BSS, enter ZSNMP REFRESH to refresh the /etc/snmp.cfg SNMP configuration file and copy it into core storage.
  6. Define routing table entries, if necessary. See TPF Transmission Control Protocol/Internet Protocol for more information about defining routing table entries.
  7. Code the UCOM user exit to provide security and the UMIB user exit for enterprise-specific MIB variables.
  8. Define the SNMP server to the Internet daemon by entering the following command:

    ZINET ADD SERVER-SNMP PGM-CNMA PROTOCOL-UDP MODEL-WAIT PORT-161

  9. Enter ZINET START SERVER-SNMP to start the SNMP agent.

Additional Information: