IBM Support

PH39460: IGYOS4003-E ERROR OCCURS WHEN THE MSGEXIT MEMBER NAME BEGINS WITH A VALID SPECIAL CHARACTER.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • When a valid COBOL exit module name starts with a special
    character (as allowed by the z/OS PDS/PDSE member name rules)
    and the compiler uses that exit module via the
    EXIT(MSGEXIT(membername)) option, the compiler fails to open
    the exit member properly.  Instead, it reports an error:
    IGYOS4003-E Invalid option "membername" was found and discarded.
    where "membername" is the name of the exit module.
    
    For example:
    
    With compiler option EXIT(MSGEXIT(@MYEXIT)), the error returned
    is IGYOS4003-E Invalid option "@MYEXIT" was found and discarded.
    

Local fix

  • Rename the exit module member name to begin with an alphabetic
    character.
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of the Enterprise COBOL V6.2       *
    *                 compiler who are specifying the EXIT         *
    *                 compiler option and whose exit module names  *
    *                 have the allowed special characters '@',     *
    *                 '#', and '$' contained in them.              *
    ****************************************************************
    * PROBLEM DESCRIPTION: When the name of a user exit module is  *
    *                      not alphanumeric, then the EXIT         *
    *                      compiler option is rejected and a       *
    *                      message such as "IGYOS4003-E Invalid    *
    *                      option "@MSGEXIT" was found and         *
    *                      discarded." will be produced.           *
    ****************************************************************
    * RECOMMENDATION: Apply the IBM provided PTF and recompile     *
    *                 your COBOL programs                          *
    ****************************************************************
    The code in  the compiler option parser was only supporting
    names with alphanumeric characters.  This was a problem when
    the
    EXIT module names contained the '@', '#', and '$' special
    characters anywhere in the eight character name, which are
    allowed by the z/OS data set member naming conventions.
    

Problem conclusion

  • The parser was changed so that it now allows user exit module
    names to contain the '@', '#', and '$' special characters as
    well as all alphanumeric characters.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH39460

  • Reported component name

    ENT COBOL FOR Z

  • Reported component ID

    5655EC600

  • Reported release

    620

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2021-07-30

  • Closed date

    2021-08-19

  • Last modified date

    2021-09-22

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

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

    PH40826

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 IGYCLIBH IGYCLIBO IGYCLIBR IGYCLSTR IGYCLVL0
    IGYCLVL1 IGYCLVL2 IGYCLVL3 IGYCLVL8 IGYCMALL IGYCOPI  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  IGYZQDRV IGYZQENU IGYZQJPN
    

Fix information

  • Fixed component name

    ENT COBOL FOR Z

  • Fixed component ID

    5655EC600

Applicable component levels

  • R620 PSY UI76842

       UP21/08/27 P F108

  • R621 PSY UI76843

       UP21/08/27 P F108

  • R622 PSY UI76844

       UP21/08/27 P F108

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":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SS6SG3","label":"Enterprise COBOL for z\/OS"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"620","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Document Information

Modified date:
12 December 2023