Skip to main content

Software  >  Networking  >  Communications Server  >  

z/OS V1R11 Communications Server: IP Programmer's Guide and Reference

 Technote (troubleshooting)
 
Problem(Abstract)
Publication updates for z/OS V1R11 Communications Server: IP Programmer's Guide and Reference
 
Resolving the problem
=================================================================
In Chapter 5, SNMP manager API, make the following changes:

In the section called SNMP manager API functions, remove three functions: snmpValueCreateBits, snmpValueCreateUnsignedInteger32, and snmpValueCreateNSApAddrs. Add a note before section "snmpAddVarBind – Adds a VarBind to the SnmpVarBinds structure":

Note: The functions snmpValueCreateBits, snmpValueCreateUnsignedInteger32, and snmpValueCreateNSApAddrs are removed. If these functions are used, SNMP_MGR_RC_DEPRECATED is returned.

In the section called SNMP manager API configuration file, update the HMAC-SHA sample:

#------------------------------------------------------------------------------------------------------------
# Format of entries (SNMPv1 and SNMPv2c):
##
targetAddr targetPort version communityName
#
#------------------------------------------------------------------------------------------------------------
# Community-based security (SNMPv1 and SNMPv2c)
#------------------------------------------------------------------------------------------------------------
9.1.1.1 161 snmpv1 -
9.1.1.2 - snmpv2c public
#------------------------------------------------------------------------------------------------------------
# Format of entries (SNMPv3):
##
targetAddr targetPort version userName password secLevel authProto authKey privProto privKey
#
#------------------------------------------------------------------------------------------------------------
# User-based security (SNMPv3)
#------------------------------------------------------------------------------------------------------------
9.8.0.1 162 snmpv3 userid - AuthPriv HMAC-SHA 40b19aa7c2d3b685655ba74d7771522faa3571c DES f40b19aa7c2d3b6856 55ba74d7771522faa3571c

In the section called SNMP manager API statement syntax, add an introductory paragraph under the heading:

This section describes the configuration entry parameters. The term target refers to a target SNMP agent or to an application that receives a trap or inform sent by an SNMP manager application.

In the section called Steps for compiling and linking SNMP manager API applications, insert a paragraph before the "Make sure to include ..." paragraph in step 1:

To enable the use of MVS-specific data structures, you must define the MVS constant using either a compile option (-DMVS) or a compiler directive (#define MVS) in your application.

=================================================================
In Chapter 13, FTP Client Application Programming Interface (API), under the section called FTP client API for REXX function, update the second paragraph in section Handling of SIGCHLD signals:

If the REXX program is running in a POSIX environment and does not have a SIGCHLD signal handler when it invokes the first CREATE request, then the FTP client API for REXX requests that the SIGCHLD signal be ignored. The REXX parent program resets the signal handler to the default state only after every FTP client instance that is used in the REXX program has ended. If the REXX program has a SIGCHLD handler, no change is made by the FTP client API.

=================================================================
In Chapter 14, Network management interfaces, under the section called TCP/IP callable NMI (EZBNMIFR), update the Invoke NMI service part of Example 3 in section TCP/IP NMI examples:

***********************************************************************
* *
* Invoke NMI service *
* *
***********************************************************************
CALL EZBNMIFR, *
(TcpipJobName,(R13),NMIalet,NMIlength,RV,RC,RSN)
STORAGE RELEASE,LENGTH=@DYNSIZE,ADDR=(R13)
DROP R13

=================================================================
In Chapter 14, Network management interfaces, under the section called TCP/IP callable NMI (EZBNMIFR), update the GetProfile (NWMProfileType) description in section Format and details for poll-type requests:
  • GetProfile (NWMProfileType) -- obtain information about the current TCP/IP profile statement settings. This request does not support filtering. To detect changes to the profile statement settings, callers can use this callable request to obtain an initial set of current profile settings, and then do one of the following:
    • Repeat the request, over a time interval, comparing returned data from a previous response to the returned data from the last response.
    • Obtain the SMF Type 119 subtype 4 TCP/IP profile event records. These records provide information about changes to the profile settings that were made using VARY TCPIP,,OBEYFILE command processing. The records are created if they are requested on the SMFCONFIG or NETMONITOR profile statements. If the records are requested on the SMFCONFIG profile statement, they are written to the MVS SMF data sets. If the records are requested on the NETMONITOR profile statement, they can be obtained from the real-time SMF data network management interface (NMI). For more information about the real-time SMF data NMI see Real-time TCP/IP network monitoring NMI. For more information about the TCP/IP profile SMF record, see the TCP/IP profile event record (subtype 4) information in z/OS Communications Server: IP Configuration Reference. The SMF record might be created even if some errors occurred during the VARY TCIP,,OBEYFILE command processing. Application programs that process these records must compare the sections of changed information to the previous profile settings, to determine whether profile changes actually occurred.
 
 
 

Copyright and trademark information
IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.
Rate this page
Please take a moment to complete this form to help us better serve you.
This material provides me with the information I need.




This material is clear and easy to understand.




Did the information help you to achieve your goal?
What updates, improvements, or related information would you like to see in this document?
Your response will be used to improve our document content. Requests for assistance, if applicable, should be submitted through your normal support channel as we cannot respond from this site.
Input the verification number to submit feedback:
Document information
 Product categories:
 Software
 Networking
 Enterprise Connectivity
 z/OS Communications Server
 All
 Operating system(s):
  z/OS
 Software version:
  1.11
 Reference #:
  1402567
 IBM Group:
 Software Group
 Modified date:
 2009-09-16

Translate My Page
 
 

Rate this page

Help us improve this page. Your response will be used to improve our document content. Requests for assistance, if applicable, should be submitted through your normal support channel as we cannot respond from this site.