IBM Support

OA68868: Z COMMON DATA PROVIDER COBOL API SUPPORT FOR IPV4

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • ZCDP COBOL API supports only IPv6 connections.
    
    
    Error message when using IPv4 connections:
    
    HBOCBOPN:SOCKET INIT IS SUCCESSFULL
    10353297 HBOCBOPN: INITAPI RETCODE=00000000 ERRNO= 00000000
    ===============================================
    HBOCBOPN:CREATE SOCKET IS UNSUCCESSFULL
    10353297 HBOCBOPN: SOCKET RETCODE=0000000J ERRNO= 00000047
    ===============================================
    FUNCTION=SOCKET RETCODE= -01 ERRORNO= 47 INITAPI FAILED
    10353297 HBOCBOPN: TERMAPI RETCODE= 00000000 ERRNO= 00000000
    10353297 HBOCBOPN: SOCKET RETCODE=00000000 ERRNO= 00000000
    ===============================================
    CDPTEST: Return code from socket open: +00000008
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: IBM Z Configuration Data Provider customers  *
    *                 who use the COBOL API.                       *
    ****************************************************************
    * PROBLEM DESCRIPTION: The COBOL API fails to connect to the   *
    *                      Data Streamer using TCP/IP IPv4 and     *
    *                      returns the following error:            *
    *                                                              *
    *                      HBOCBOPN: CREATE SOCKET IS UNSUCCESSFUL *
    *                      (An IPv6 socket call is being used on   *
    *                      an IPv4-only socket).                   *
    ****************************************************************
    * RECOMMENDATION: Users of the COBOL API should APPLY this     *
    *                 PTF and follow the ++HOLD instructions.      *
    ****************************************************************
    TCP/IP IPv4 traffic was not allowed and the ability to use
    IPv4 had to be added.
    

Problem conclusion

  • A configuration option was added to enable support for both
     IPv4 and IPv6 when using the COBOL APIs.
    

Temporary fix

Comments

APAR Information

  • APAR number

    OA68868

  • Reported component name

    CDP BASE

  • Reported component ID

    5698ABJ00

  • Reported release

    510

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2025-12-10

  • Closed date

    2026-02-02

  • Last modified date

    2026-03-02

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

    UJ98937

Modules/Macros

  • HBO2CCMF HBO2CD53 HBO2CD54 HBO2CD55 HBO2CD56 HBO2CD61 HBO2CD62
    HBO2CDIC HBO2CIST HBO2COMP HBO2S030 HBO2S042 HBO2S070 HBO2S078
    HBO2S080 HBO2S100 HBO2S101 HBO2S102 HBO2S104 HBO2S113 HBO2S30A
    HBO2S30O HBO2S42V HBO2S701 HBO2S702 HBO2TS77 HBO3CCMF HBO3CIST
    HBO3S701 HBOCBAPI HBOCBCLS HBOCBOPN HBOCBSND HBOCDEDE HBOCMAIN
    HBOCMDTA HBOCSDTA HBODEPS  HBODSDBG HBODSPCE HBOFLGX0 HBOGTDBG
    HBOJIMS  HBOPASDI HBOPBLVL HBOPCDBI HBOPCGAA HBOPCGB1 HBOPCGB2
    HBOPCGCM HBOPCGCW HBOPCGGC HBOPCGGF HBOPCGGP HBOPCGGX HBOPCGJA
    HBOPCGJC HBOPCGJE HBOPCGLO HBOPCGLW HBOPCGNN HBOPCGNO HBOPCGO1
    HBOPCGO2 HBOPCGO3 HBOPCGO4 HBOPCGP1 HBOPCGP2 HBOPCGPA HBOPCGPC
    HBOPCGPF HBOPCGPN HBOPCGPP HBOPCGRC HBOPCGSF HBOPCGSM HBOPCGSW
    HBOPCGWD HBOPCGXC HBOPCGXF HBOPCGXI HBOPCGXS HBOPCGXT HBOPCGXV
    HBOPCGZA HBOPCGZC HBOPCGZG HBOPCGZM HBOPCGZP HBOPCGZS HBOPCGZZ
    HBOPCIBM HBOPCICP HBOPCMAA HBOPCMCR HBOPCMEV HBOPCMFP HBOPCMRN
    HBOPCMSC HBOPCMSP HBOPCMST HBOPCMSU HBOPCMSV HBOPCMZZ HBOPCOAS
    HBOPCOBF HBOPCOBI HBOPCOBU HBOPCOCF HBOPCOCR HBOPCOCS HBOPCODB
    HBOPCODI HBOPCOHA HBOPCOIT HBOPCOLL HBOPCOLX HBOPCOME HBOPCOMM
    HBOPCOMR HBOPCOOT HBOPCORE HBOPCORX HBOPCOSF HBOPCOST HBOPCOUR
    HBOPCOUT HBOPCPRE HBOPCSVD HBOPCXAA HBOPCXCA HBOPCXCC HBOPCXCT
    HBOPCXFC HBOPCXFI HBOPCXIC HBOPCXID HBOPCXLD HBOPCXLO HBOPCXNN
    HBOPCXNU HBOPCXO1 HBOPCXO2 HBOPCXO3 HBOPCXO4 HBOPCXPX HBOPCXSE
    HBOPCXUS HBOPCXVA HBOPCXVR HBOPDBRC HBOPDE   HBOPDELO HBOPDERE
    HBOPDERP HBOPDETA HBOPDETP HBOPDEUP HBOPDICA HBOPDICC HBOPDICD
    HBOPDICF HBOPDICI HBOPDICR HBOPDICS HBOPEN36 HBOPFRFA HBOPFRFL
    HBOPFRFM HBOPFRFN HBOPFRFT HBOPFRLX HBOPFRSA HBOPFRSL HBOPFRSN
    HBOPFRSS HBOPIFAQ HBOPIMID HBOPIMS  HBOPIMSD HBOPIMSN HBOPIO
    HBOPIO31 HBOPLIPR HBOPLLPR HBOPLODT HBOPLOEX HBOPLOG  HBOPLOOI
    HBOPLOOK HBOPLOOU HBOPLOPE HBOPLOPF HBOPLOPR HBOPLOST HBOPLSMC
    HBOPLSPR HBOPMG   HBOPMG00 HBOPMG01 HBOPMG02 HBOPMG03 HBOPMG04
    HBOPMG05 HBOPMG21 HBOPMG29 HBOPMG50 HBOPMG52 HBOPMG80 HBOPMG81
    HBOPMG82 HBOPNCCI HBOPNCCR HBOPNCCS HBOPNCDF HBOPNCFD HBOPOLDS
    HBOPPACO HBOPPAER HBOPPAEX HBOPPAFI HBOPPARS HBOPPCOL HBOPPHFS
    HBOPPVER HBOPRECO HBOPRECS HBOPRECX HBOPREEX HBOPREIX HBOPRENX
    HBOPREXX HBOPRFSH HBOPRGST HBOPRPRO HBOPSCAN HBOPSCRT HBOPSECF
    HBOPSECN HBOPSECT HBOPSEG  HBOPSET  HBOPSMFG HBOPSMFQ HBOPSOCK
    

Fix information

  • Fixed component name

    CDP BASE

  • Fixed component ID

    5698ABJ00

Applicable component levels

  • R510 PSY UJ98937

       UP26/02/06 P F602

Fix is available

  • Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.

[{"Business Unit":{"code":"BU011","label":"Systems - zSystems software"},"Product":{"code":"SG19M"},"Platform":[{"code":"PF054","label":"z Systems"}],"Version":"510"}]

Document Information

Modified date:
02 March 2026