A fix is available
APAR status
Closed as program error.
Error description
Compiler displays warning IGYLI0020-W when the COPYLOC compiler option points to USS copybooks with names that are longer than 8 characters.
Local fix
Ignore the IGYLI0020-W warning.
Problem summary
**************************************************************** * USERS AFFECTED: Users of Enterprise COBOL v6.5 compiling * * programs with the COPYLOC compiler option in * * effect and there exists a mix of data set * * and z/OS UNIX copybook locations to search * * (including possibly the SYSLIB ddname * * allocated in JCL) and where the program * * being compiled contains a COPY statement * * referring to a copybook with a name longer * * than 8 characters and/or contains characters * * that are illegal for data set members, but * * the copybook was never intended to be found * * in a data set and is actually located in one * * of the z/OS UNIX paths indicated by COPYLOC, * * where the original name is legal. * **************************************************************** * PROBLEM DESCRIPTION: Extraneous compile-time warning or * * error messages indicating that one or * * more data sets associated with the * * corresponding library were searched but * * the name of the copybook was modified * * for the search (truncated and/or * * illegal characters substituted with * * '0'). However, the copybook with full, * * original name was later found on z/OS * * UNIX so the warning/error was * * misleading and unnecessary (though not * * harmful). * * * * IGYLI0020-W Name "COPYBOOK1234" was * * processed as "COPYBOOK" * * * * GYLI0025-E Name "COP<COP<" was * * invalid. It was processed as * * "COP0COP0" * **************************************************************** * RECOMMENDATION: Apply the IBM-provided PTF. * **************************************************************** The compiler was allowing warnings and errors produced when searching an MVS data set concatenation with a copybook name that was truncated and/or had illegal characters substituted with '0' to be reported even when the copybook with full, original name was subsequently found in a z/OS UNIX path.
Problem conclusion
The compiler was updated so that when COPYLOC is in effect, errors/warnings relating to copybook names being too long, or containing characters that are not legal for MVS data set members, are suppressed if the copybook is not found in the MVS data set concatenation. If the modified copybook name does match an MVS data set member, the match will be accepted (as has always been the case in Enterprise COBOL) and warnings and/or errors will continue to be reported to let the user know that a match was made using a name that was modified (e.g., truncated and/or illegal characters substituted with '0'). If such a name does not match any MVS data set members, however, we no longer will report any errors or warnings when COPYLOC is in effect. If the copybook is ultimately not found in any copybook locations, that will be reported as normal.
Temporary fix
Comments
APAR Information
APAR number
PH69726
Reported component name
ENT COBOL FOR Z
Reported component ID
5655EC600
Reported release
650
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2026-01-19
Closed date
2026-01-20
Last modified date
2026-02-01
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
Modules/Macros
IGY8RWTU IGYCASMB IGYCCBE IGYCCCRT IGYCCICS IGYCCSRV IGYCDGEN IGYCDIAG IGYCDMAP IGYCEN$0 IGYCEN$1 IGYCEN$2 IGYCEN$3 IGYCEN$4 IGYCEN$5 IGYCEN$8 IGYCEN$D IGYCEN$R IGYCFGEN IGYCFREE IGYCINIT IGYCJA$0 IGYCJA$1 IGYCJA$2 IGYCJA$3 IGYCJA$4 IGYCJA$5 IGYCJA$8 IGYCJA$D IGYCJA$R IGYCJGEN IGYCLIBR IGYCLSTR IGYCLVL0 IGYCLVL1 IGYCLVL2 IGYCLVL3 IGYCLVL8 IGYCMALL IGYCOSCN IGYCPGEN IGYCRCTL IGYCRDPR IGYCRDSC IGYCREAL IGYCRWT IGYCSCAN IGYCSIMD IGYCUE$0 IGYCUE$1 IGYCUE$2 IGYCUE$3 IGYCUE$4 IGYCUE$5 IGYCUE$8 IGYCUE$D IGYCUE$R IGYCXREF IGYDRV IGYEQCWI IGYMSGE IGYMSGK IGYMSGT IGYQCBE IGYQSPLT IGYZQEN6 IGYZQENU IGYZQJP6 IGYZQJPN
Fix information
Fixed component name
ENT COBOL FOR Z
Fixed component ID
5655EC600
Applicable component levels
R650 PSY UO06512
UP26/01/27 P F601
R651 PSY UO06513
UP26/01/27 P F601
R652 PSY UO06514
UP26/01/27 P F601
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":"BU048","label":"IBM Software"},"Product":{"code":"SS6SG3","label":"Enterprise COBOL for z\/OS"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"6.5","Line of Business":{"code":"LOB70","label":"Z TPS"}}]
Document Information
Modified date:
01 February 2026