IBM Support

PI28991: RATIONAL DEVELOPER FOR SYSTEM Z (RDZ): CICS WEB SERVICE GETTING MESSAGE IRZ9999S

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • In RDz v9.0.1, the user compiles the RDZ generated Webservice
    Cobol program. At runtime, the webservice receives
    the IRZ9999S message.
    
    The following message is issued in the CICS log:
    "
    IRZ9999S Failed to retrieve the text of a Language Environment
    runtime
    message. Verify that the Language Environment runtime message
    module for facility IRZ is installed in DFHRPL or STEPLIB.
    "
    The user has defined SFEKLOAD and SFEKLMOD in the STEPLIB as
    well as DFHRPL.
    
    The reason is that the CICS is unable to load these programs
    because they are not defined
    and auto-install of programs is not configured.
    
    
    The Installation instructions must include the requirement to
    define the programs.
    

Local fix

  • User can have auto-install of programs configured to CICS,
    or  define the programs to CICS.
    
    For example define these in MYGROUP and install MYGROUP before
    running webservices.
    DEFINE PROGRAM(IIRZMSGT )  GROUP(MYGROUP) LANGUAGE(COBOL)
    USELPACOPY(NO) CONCURRENCY(T)
    DEFINE PROGRAM(IRZMENG)  GROUP(MYGROUP) LANGUAGE(COBOL)
    USELPACOPY(NO) CONCURRENCY(T)
    DEFINE PROGRAM(IRZMUEN )  GROUP(MYGROUP) LANGUAGE(COBOL)
    USELPACOPY(NO) CONCURRENCY(T)
    DEFINE PROGRAM(IRZCLCNV)  GROUP(MYGROUP) LANGUAGE(COBOL)
    USELPACOPY(NO) CONCURRENCY(Q)
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: 01.RDz users generating CICS code            *
    ****************************************************************
    * PROBLEM DESCRIPTION: 01.CICS code generated by RDz relies    *
    *                         on IRZ* load modules for error       *
    *                         messages. These load modules must    *
    *                         be defined to the CICS region.       *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    01.CICS code generated by Developer for System z relies on IRZ*
       load modules for error messages. These load modules must be
       defined to the CICS region, either via AUTOINSTALL of via
       the new SFEKSAMP(IRZCSD) sample JCL.
    

Problem conclusion

  • 01.New SFEKSAMP(IRZCSD) sample JCL provided to define IRZ* load
       modules in CICS CSD.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI28991

  • Reported component name

    RATL DEV FOR SY

  • Reported component ID

    5724T0700

  • Reported release

    900

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt

  • Submitted date

    2014-11-04

  • Closed date

    2015-06-04

  • Last modified date

    2015-06-08

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

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

Modules/Macros

  • FEKSETUP IRZCSD
    

Fix information

  • Fixed component name

    RD/Z HOST

  • Fixed component ID

    5724T0723

Applicable component levels

  • R900 PSY UI28242

       UP15/06/08 I 1000

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.



Document information

More support for: Rational Developer for System z

Software version: 9.0

Reference #: PI28991

Modified date: 08 June 2015