gtpm2m35 | Migration Guide: Program Update Tapes |
The following section discusses the migration considerations for Simple Network Management Protocol (SNMP) agent support.
See the APEDIT for APAR PJ27932 for information about prerequisite APARs.
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:
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.
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.
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.
There are no hardware requirements.
The following section contains information about software requirements.
The following section summarizes the communication changes.
SNMP agent support requires an SNMP manager application that supports SNMP Version 1 on a remote platform.
The following section summarizes interface changes.
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.
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). |
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 |
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 |
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.
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 |
There are no changes.
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). |
Table 1136 summarizes changes to members. This information is presented in alphabetic order by the name of the member.
Notes:
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). |
There are no changes.
There are no changes.
There are no changes.
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. |
There are no changes.
The following section summarizes the macro changes. This information is presented in alphabetic order by the type of macro.
There are no changes.
There are no changes.
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 |
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 |
There are no changes.
There are no changes.
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 |
There are no changes.
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 |
There are no changes.
There are no changes.
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 |
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. |
The are no changes.
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.
There are no changes.
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). |
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.
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. |
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 |
There are no changes.
There are no changes.
There are no changes.
There are no changes.
There are no 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. |
There are no changes.
SNMP agent support provides the following new APIs:
See TPF C/C++ Language Support User's Guide for more information about these APIs.
There are no changes.
There are no changes.
There are no changes.
To install SNMP agent support on your existing TPF 4.1 system, do the following:
ZINET ADD SERVER-SNMP PGM-CNMA PROTOCOL-UDP MODEL-WAIT PORT-161
Additional Information: