IBM Support

PH67717: A NEW OPTION FOR HANDLING NON-ZERO RETURN CODE OF COBOL AND PL/I COMPILER IN THE COPYBOOK IMPORT FUNCTION

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • IMS Administration Tool enhances IMS Resource Change and Import
    Objects to specify post-processing after COBOL and PL/I compiler
    returns non-zero return code during importing copybook. 
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: Users of IMS Administration Tool for z/OS    *
    *                 (FMID=HALC110).                              *
    ****************************************************************
    * PROBLEM DESCRIPTION: IMS Administration Tool enhances IMS    *
    *                      Resource Change and Import Objects to   *
    *                      specify post-processing after COBOL     *
    *                      and PL/I compiler returns non-zero      *
    *                      return code during importing copybook.  *
    ****************************************************************
    * RECOMMENDATION: Apply the maintenance for this APAR.         *
    ****************************************************************
    By this APAR, users can specify how IMS Administration Tool
    handles non-zero return codes returned by the COBOL or PL/I
    compiler during copybook import in IMS resource change
    (database and application administration function) and import
    objects (IMS catalog and directory management function).
    This option allows users to configure the following behaviors:
      - Whether to stop processing immediately when a non-zero
        return code is returned.
      - Whether to complete DBDGEN for all remaining DBDs before
        stopping.
      - Whether to treat return codes of 4 or 8 as errors.
    
    ========================
    = DOCUMENTATION CHANGE =
    ========================
    IMS Administration Tool for z/OS Version 1 Release 1 User's
    Guide and Reference (SC27-9011) is updated.
    Refer to topic "What's new in IMS Administration Tool"
    (https://www.ibm.com/docs/en/ims-admintool/1.1?topic=overview
    -whats-new-in-ims-administration-tool) in IBM Documentation
    for doc changes associated with this APAR.
    

Problem conclusion

Temporary fix

Comments

APAR Information

  • APAR number

    PH67717

  • Reported component name

    IMS ADMIN TOOL

  • Reported component ID

    5655CAT00

  • Reported release

    110

  • Status

    CLOSED UR1

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    YesSpecatt / New Function / Xsystem

  • Submitted date

    2025-08-12

  • Closed date

    2025-09-30

  • Last modified date

    2025-11-03

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

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

    UO05156

Modules/Macros

  • ATY#EMSG ATY#MENU ATY$B000 ATY$BRSC ATY$BSET ATY$DBDG ATY$M100
    ATY$MIMP ATY$MSET ATY@OBJU ATY@PRSB ATY@SKEL ATYHBRCD ATYHBSE0
    ATYHM400 ATYHRNOP ATYHRNU1 ATYHRNU2 ATYHRNU3 ATYHRNU4 ATYHRNU5
    ATYHRNU6 ATYHRNU7 ATYKEYS  ATYPBRCD ATYPBRCG ATYPM400 ATYPRNOP
    ATYPRNU5 ATYPRNU6 ATYPRNU7 ATYR01
    

Fix information

  • Fixed component name

    IMS ADMIN TOOL

  • Fixed component ID

    5655CAT00

Applicable component levels

  • R110 PSY UO05156

       UP25/10/02 P F510  

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":"SSCD9F6","label":"IMS Administration Tool"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"110"}]

Document Information

Modified date:
03 November 2025