IBM Support

PH69726: IGYLI0020-W WARNING WHEN COPYLOC POINTS TO USS COPYBOOKS WITH NAMES LONGER THAN 8 CHARACTERS.

A fix is available

Subscribe

You can track all active APARs for this component.

 

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:

    PH66946

  • 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