EZY1309E IBM runtime error on mainframe using CICS MS Link programming model and TCP/IP transport with authentication (221533)

SUMMARY

A runtime error can occur on the mainframe when one is using COMTI with the CICS MS Link programming model and TCP/IP data transmission to the mainframe.

The error involves the IBM Listener program that runs in the CICS region. The following error message appears in the CICS CSMT message log:

EZY1309E mm/dd/yy hh:mm:ss GIVESOCKET FAILURE TRANS tttt TASKID= nnnn ERRNO= 46 INET ADDR= iii.iii.iii.iii PORT= pppp

Explanation of variables

tttt: CICS transaction identifier
nnnn: CICS task number
iii.iii.iii.iii: IP address of the TCP/IP stack on the mainframe
pppp: TCP port number for the IBM Listener program in the CICS region

MORE INFORMATION

The ERRNO=46 socket error has the following explanation:

EPFNOSUPPORT: The specified protocol family is not supported or the specified domain for the client identifier is not AF_INET=2.

A customer solved this problem by applying the IBM PTF (Program Temporary Fix) number UQ20701 to their TCP/IP system on the mainframe. This PTF fixes a problem in the IBM Listener program, EZACIC02.

REFERENCES

Information about the error message can be found in the following two IBM manuals:

OS/390 eNetwork Communications Server IP Messages: Volume 3 Version 2 Release 7, Document Number SC31-8674-02
IBM TCP/IP for MVS CICS TCP/IP Socket Interface Guide and Reference, Document Number SC31-7131-03

The third-party products that this article discusses are manufactured by companies that are independent of Microsoft. Microsoft makes no warranty, implied or otherwise, regarding the performance or reliability of these products.