A fix is available
APAR status
Closed as program error.
Error description
Upon a z/OS FTP client connection attempt to a remote FTP server using FTP CLIENT API with debug enabled, the error message EZA2862I gets issued while processing a SOCKS configuration file with definitions containing DIRECT, and SOCKD, SOCKD4, or SOCKD5 statements that appear to be in correct syntaxes. For example: DIRECT a.a.a.a/nn ; FTP server definition SOCKD5 @=xxx.yyy.zzz a.a.a.a b.b.b.b ; socks server definition Message EZA2862I gets issued for the first statement in error follows: EZA2862I Error parsing SOCKS configuration file <socks_config_file> on line <nn> - use of SOCKS has been disabled. Message EZA2862I gets issued for the second statement after the first statement is commented out. With debug parameter -d specified on ftp command or DEBUG FLO option specified in FTP client's FTPDATA, the following debug messages will be seen for the processing errors: CY2837 get_destination: ip_V4_address or number of bits is incorrect or missing CY2953 get_server: socks server address is missing or incorrect in @=xxx.yyy.com x.x.x.x y.y.y.y These errors should not have occurred because the syntaxes of the statements appeared to be correct.
Local fix
None KEYWORDS: EZAFTPCY EZA2862I DIRECT SOCKD SOCKD4 SOCKD5 GET_DESTINATION GET_SERVER SOCKS
Problem summary
**************************************************************** * USERS AFFECTED: All users of IBM Communications * * Server for z/OS Version 1 * * Release 13: FTP client API. * * * * * **************************************************************** * PROBLEM DESCRIPTION: A FTP connection via a socks * * server to a FTP server fails * * when using the FTP API with * * debug enabled. * **************************************************************** * RECOMMENDATION: * **************************************************************** When a FTP client using FTP client API with debug enabled tries to connect to a FTP server via a socks server, the following error messages are thrown - EZA2862I Error parsing SOCKS configuration file NETPRD.TCPIP.DATA (SOCKS) on line 24 - use of SOCKS has been disabled. CY2837 get_destination: ip_V4_address or number of bits is incorrect or missing CY2953 get_server: socks server address is missing or incorrect in @=xxx.yyy.com x.x.x.x y.y.y.y +-------------------------------------------------------------+ + Please check our Communications Server for OS/390 homepages + + for common networking tips and fixes. The URL for these + + homepages can be found in Informational APAR II11334. + +-------------------------------------------------------------+
Problem conclusion
EZAFTPCY is changed to pass the correct string to strtok when FTP client API is used. * Cross Reference between External and Internal Names EZAFTPSM (FTPDMSG )
Temporary fix
Comments
APAR Information
APAR number
PI22486
Reported component name
TCP/IP V3 MVS
Reported component ID
5655HAL00
Reported release
1D0
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2014-07-22
Closed date
2014-10-21
Last modified date
2015-01-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
PI24371 UI21507
Modules/Macros
EZAFTPCY EZAFTPDM EZAFTPEH EZAFTPEP EZAFTPGM EZAFTPRM EZAFTPRX EZAFTPSM EZAFTPSR
Fix information
Fixed component name
TCP/IP V3 MVS
Fixed component ID
5655HAL00
Applicable component levels
R1D0 PSY UI21507
UP14/12/10 P F412
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":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"1D0","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SSCY4DZ","label":"DO NOT USE"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"1D0","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 January 2015