IBM Support

PQ65303: IMS HP SYSGEN TOOLS CONFLICT WITH BMC PRODUCTS DELTA/IMS & XPF. MAY RESULT IN ABEND0C4 OR BMC PRODUCT INITIALIZATION FAILURE.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • =========================
    PROBLEM SYMPTOMS:
    =========================
    IMS HIGH PERFORMANCE SYSGEN TOOLS CONFLICT WITH
    BMC PRODUCTS DELTA/IMS AND XPF.  MAY RESULT IN
    ABEND0C4 OR BMC PRODUCT INITIALIZATION FAILURE.
    =========================
    USERS AFFECTED:
    =========================
    IMS HIGH PERFORMANCE SYSGEN TOOLS USERS WHO ALSO
    USE PRODUCTS WITH DEPENDANCIES ON DFSXCIC0.
    =========================
    RECOMMENDATION:
    =========================
    INSTALL THE PTF THAT CORRECTS THIS APAR.
    =========================
    PROBLEM RESOLUTION:
    =========================
    CHANGED THE HP SYSGEN TOOLS INITIALIZATION PROCESS FROM
    AN INTERCEPT OF IMS MODULE DFSXCIC0 TO USE THE IMS
    PARTNER PRODUCT INITIALIZATION EXIT DFSPPUE0.
    =========================
    NOTES:
    =========================
    THIS MAINTENANCE REQUIRES THE REMOVAL OF LOAD MODULE
    IOHXCIC0 AND IT'S ALIAS DFSXCIC0 FROM THE SIOHLOAD
    LIBRARY.  TWO NEW CSECTS (IOHPPUE0, IOHFSCD), ONE
    LOAD MODULE (IOHPPUE0) AND ONE ALIAS (DFSPPUE0).
    =========================
    DOCUMENTATION CHANGES:
    =========================
    PROGRAM DIRECTORY:
    SECTION 5.2.3.  THE WARNING BOX (DO NOT COPY THE TARGET LIBRARY
    INTO THE IMS TARGET LIBRARY.  THIS WILL CAUSE THE IMS CONTROL
    REGION TO ABNORMALLY TERMINATE WITH A U4021 ABEND ON THE NEXT
    RESTART OF IMS) NO LONGER APPLIES.
    USER'S GUIDE:
    CHAPTER 2, "FASTGEN CONTROL CARDS".  ADDITIONAL CONTROL CARD
    INFORMATION FOLLOWING THE SECRPT CONTROL CARD ON PAGE 8.
    DFSPPUE0 CONTROL CARD
    THE DFSPPUE0 CONTROL CARD CONSISTS OF THE OPERATION CODE
    'DFSPPUE0' AND ONE REQUIRED KEYWORD, NAME=.  THIS CONTROL
    CARD IS ONLY PROCESSED DURING IMS CONTROL REGION
    INITIALIZATION, AND IS IGNORED FOR BATCH EXECUTION OF THE
    HP SYSGEN TOOLS FASTGEN PROCESS.
    NAME=
    THIS KEYWORD SPECIFIES ADDITIONAL IMS PARTNER PRODUCT
    INITIALIZATION EXIT ROUTINE (DFSPPUE0) MODULE NAME(S).
    THE DEFAULT IS TO HAVE NO OTHER EXIT ROUTINES CALLED
    DURING HP SYSGEN TOOLS ONLINE INITIALIZATION. IF MORE
    THAN ONE MODULE NAME IS TO BE INVOKED, THE MODULE NAMES
    MAY BE INCLUDED ON MULTIPLE DFSPPUE0 STATEMENTS, OR
    ON A SINGLE CONTROL CARD WITH THE NAMES ENCLOSED IN
    PARENTHESIS.
    CHAPTER 2, "CUSTOMIZING THE IMS ONLINE ENVIRONMENT".
    REPLACE THE "FAST SYSGEN DATASET PLACEMENT AND AUTHORIZATION"
    SECTION WITH THE FOLLOWING.
    FAST SYSGEN IMS ONLINE INSTALLATION
    ONCE THE FAST SYSGEN CONTROL CARDS HAVE BEEN PROPERLY
    DEFINED, THE SOFTWARE CAN BE ACTIVATED TO ALLOW THE
    IMS CONTROL REGION TO DYNAMICALLY GENERATE AND MODIFY
    RESOURCE DEFINITIONS.
    CARE SHOULD BE TAKEN TO IDENTIFY ANY OTHER USERS OF THE
    IMS PARTNER PRODUCT INITIALIZATION EXIT, DFSPPUE0.  FAST
    SYSGEN REQUIRES THE USE OF THIS EXIT ROUTINE.  IF OTHER
    DFSPPUE0 EXIT ROUTINES ARE PRESENT IN THE INSTALLATION,
    THE OTHER EXIT ROUTINES CAN BE RENAMED AND INVOKED USING
    THE DFSPPUE0 CONTROL CARD.  NOTE THAT AMONG THE OTHER
    USERS OF THIS EXIT ARE THE IBM IMS NETWORK COMPRESSION
    FACILITY, WHICH HAS A SIMILIAR FACILITY, AND SEVERAL OTHER
    VENDOR PRODUCTS.  NOTE THAT IMS WILL ONLY INVOKE THE FIRST
    DFSPPUE0 MODULE FOUND IN THE IMS STEPLIB, SO IT IS
    IMPORTANT TO IDENTIFY ANY OTHER USERS OF THIS EXIT
    ROUTINE AND DETERMINE THE BEST WAY TO HAVE ALL DFSPPUE0
    EXIT ROUTINES INVOKED DURING IMS INITIALIZATION.
    FAST SYSGEN SENDS MESSAGE IOH401I TO THE MVS SYSTEM CONSOLE
    AND SYSLOG WHEN IT'S DFSPPUE0 EXIT ROUTINE IS SUCCESSFULLY
    INVOKED DURING IMS INITIALIZATION.
    FASTGEN ALSO SUPPORTS BEING INVOKED BY OTHER PRODUCTS.
    FOR EXAMPLE, IMS NETWORK COMPRESSION FACILITY HAS A
    SIMILIAR FEATURE TO THE DFSPPUE0 CONTROL CARD.  IF IMS
    NETWORK COMPRESSION FACILITY'S LOAD LIBRARY IS PLACED
    AHEAD OF THE SIOHLOAD DATASET, JUST ENSURE THAT IMS
    NETWORK COMPRESSION FACILITY INVOKES MODULE NAME IOHPPUE0.
    NO MODULES IN THE SIOHLOAD LIBRARY WOULD NEED TO BE
    DELETED OR RENAMED.
    CHAPTER 2, "CUSTOMIZING THE IMS ONLINE ENVIRONMENT".
    REPLACE THE "IMS CONTROL REGION JCL CHANGES" SECTION WITH
    THE FOLLOWING.
    IMS CONTROL REGION JCL CHANGES
    ONCE THE DFSPPUE0 EXIT ROUTINE UPDATES TO THE FASTGEN
    CONTROL CARDS ARE COMPLETE, THE SOFTWARE CAN BE ACTIVATED
    IN THE ONLINE IMS CONTROL REGION.  THIS MAY REQUIRE SOME
    JCL CHANGES IN THE IMS CONTROL REGION JCL.
    IF THE FASTGEN CONTROL CARDS SPECIFY A DDNAME FOR EITHER
    THE IMSGEN OR SECGEN STATEMENTS, THEN THOSE DDNAME(S) MUST
    BE ADDED TO THE IMS CONTROL REGION JCL.  NOTE THAT APAR
    PQ56512 ADDED DYNAMIC ALLOCATION SUPPORT FOR THE IMSGEN
    AND SECGEN SOURCE STATEMENTS, WHICH ALLOWS THE DDNAME=
    SPECIFICATION TO BE REPLACED WITH THE DSN= KEYWORD.  IF
    DATASET NAMES ARE SPECIFIED IN THE FASTGEN CONTROL CARDS,
    THEN NO IMS CONTROL REGION JCL CHANGE IS REQUIRED FOR
    THE GEN SOURCE.
    FASTGEN REQUIRES ACCESS TO THE MATRIX AND MODBLKS DATASETS
    (THE STAGING DATASETS - THOSE WITHOUT THE A OR B SUFFIX)
    THAT ARE NOT NORMALLY INCLUDED IN THE IMS CONTROL REGION
    JCL.  THESE DATASETS MUST BE ADDED TO THE IMS CONTROL
    REGION JCL WITH DDNAMES MATRIX AND MODBLKS.
    NOTE THAT THE DATASETS REFERENCED IN THE IMS CONTROL REGION
    JCL FOR THE MATRIXA/MATRIXB AND MODBLKSA/MODBLKSB MUST
    ALLOCATE THE A AND B VERSIONS OF THOSE LIBRARIES.  FASTGEN
    DOES NOT SUPPORT HAVING BOTH THE A AND B DDNAMES POINT TO
    THE SAME DATASET (SUCH AS THE STAGING DATASET).
    PRIOR TO THIS APAR, AN IOHRESLB DD STATEMENT WAS REQUIRED.
    THIS DD IS NO LONGER REQUIRED.
    THE ONLY OTHER JCL CHANGE REQUIRED IS TO ADD THE SIOHLOAD
    DATASET TO THE IMS CONTROL REGION STEPLIB CONCATENATION.
    ENSURE THAT THE PLACEMENT OF THE SIOHLOAD DATASET IS
    CONSISTENT WITH DFSPPUE0 CONTROL CARDS AND THE LOCATION
    OF OTHER DFSPPUE0 EXIT ROUTINES.
    NOTE THAT THE DATASETS REFERENCED IN THE IMS CONTROL REGION
    STEPLIB AND THE MATRIXA/MATRIXB AND MODBLKSA/MODBLKSB DD
    STATEMENTS MUST BE APF AUTHORIZED.  THIS WOULD INCLUDE THE
    SIOHLOAD DATASET IF IT IS PLACED IN THE IMS CONTROL REGION
    STEPLIB.  THE STAGING MATRIX AND MODBLKS DD LIBRARIES DO NOT
    REQUIRE APF AUTHORIZATION.
    APPENDIX - "MESSAGES" SECTION.
    NEW OR UPDATED MESSAGES.
    IOH382E FIND SCD FAILED IN IOHPPUE0
    EXPLANATION: THE PARTNER PRODUCT INITIALIZATION
    EXIT WAS UNABLE TO LOCATE THE SCD FOR THIS IMS
    SUBSYSTEM.
    MODULE: IOHPPUE0
    SYSTEM ACTION: THE IMS CONTROL REGION ABENDS
    WITH A U4021 ABEND.
    USER RESPONSE: CONTACT THE SUPPORT CENTER FOR
    ASSISTANCE.  TO CIRCUMVENT THE ERROR, REMOVE
    THE IMS HP SYSGEN TOOLS LIBRARY FROM THE IMS
    CONTROL REGION STEPLIB (OR AT LEAST MODULE
    IOHPPUE0 AND IT'S ALIAS DFSPPUE0).
    IOH383E INVALID KEYWORD IN DFSPPUE0 STATEMENT - XXXXXXXX
    EXPLANATION: AN UNIDENTIFIED KEYWORD WAS FOUND
    IN A DFSPPUE0 STATEMENT IN THE IOHPIMID MEMBER
    OF PROCLIB.
    MODULE: IOHPPUE0
    SYSTEM ACTION: THE KEYWORD AND PARAMETER(S) ARE
    SKIPPED.
    USER RESPONSE: REVIEW THE DFSPPUE0 STATEMENT(S)
    IN THE IOHP PARAMETER MEMBER OF PROCLIB.  THE
    ONY VALID KEYWORD ALLOWED ON THIS STATEMENT IS
    NAME=.
    IOH384E CONTROL CARD SYNTAX ERROR - UNATCHED PARENS
    EXPLANATION: A DFSPPUE0 STATEMENT IN THE IOHP
    PARAMETER MEMBER OF PROCLIB CONTAIN AN UNMATCHED
    OPEN OR CLOSE PARENTHESIS.
    MODULE: IOHPPUE0
    SYSTEM ACTION: THE REMAINDER OF THE STATEMENT IS
    IGNORED.
    USER RESPONSE: REVIEW THE DFSPPUE0 STATEMENT(S)
    IN THE IOHP PARAMETER MEMBER OF PROCLIB.  ENSURE
    THAT EACH STATEMENT HAS THE PROPER PARENTHESIS
    IN THE PROPER ORDER.
    IOH385E MODULE NAME EXCEEDS 8 CHARACTERS
    EXPLANATION: A DFSPPUE0 STATEMENT IN THE IOHP
    PARAMETER MEMBER OF PROCLIB INCLUDED A MODULE
    NAME THAT WAS LONGER THAN 8 CHARACTERS.
    MODULE: IOHPPUE0
    SYSTEM ACTION: THE MODULE NAME IS IGNORED.
    USER RESPONSE: ENSURE THAT MODULE NAMES INCLUDED
    IN THE DFSPPUE0 NAME= SPECIFICATION ARE PROPERLY
    SPECIFIED.
    IOH386I INVOKING USER SPECIFIED DFSPPUE0 EXIT ROUTINE XXXXXXXX
    EXPLANATION: IMS HP SYSGEN INITIALIZATION IS
    INVOKING THE SPECIFIED DFSPPUE0 EXIT ROUTINE
    AS REQUESTED ON A DFSPPUE0 STATEMENT IN THE
    IOHP PARAMETER MEMBER OF PROCLIB.
    MODULE: IOHPPUE0
    SYSTEM ACTION: NONE.
    USER RESPONSE: NONE.
    IOH387E LOAD FOR USER SPECIFIED DFSPPUE0 EXIT
    ROUTINE MMMMMMMM FAILED RC=RR ABEND=AAAA
    EXPLANATION: THE NAMED MODULE, AS SPECIFIED
    ON A DFSPPUE0 STATEMENT, FAILED TO LOAD.
    MODULE: IOHPPUE0
    SYSTEM ACTION: THE NAMED MODULE IS NOT INVOKED
    DURING IMS INITIALIZATION.
    USER RESPONSE: ENSURE THE PROPER NAME WAS
    SPECIFIED ON THE DFSPPUE0 STATEMENT, AND THAT
    THE MODULE IS AVAILABLE TO THE IMS CONTROL
    REGION.
    IOH388E IMS CTL RGN ABEND U4021 DUE TO
    INITIALIZATION ERROR IN IOHPPUE0
    EXPLANATION: IMS HP SYSGEN TOOLS INITIALIZATION
    FAILED.
    MODULE: IOHPPUE0
    SYSTEM ACTION: THE IMS CONTROL REGION ABENDS.
    USER RESPONSE: INVESTIGATE PRIOR IOH MESSAGES
    TO DETERMINE THE CAUSE OF THE INITIALIZATION
    FAILURE.
    IOH389W IOHPPUE0 INVOKED MORE THAN ONCE-BYPASSING INITIALIZATION
    EXPLANATION: THE FASTGEN PARTNER PRODUCT INITIALIZATION EXIT
    WAS CALLED TWICE DURING IMS RESTART.
    MODULE: IOHPPUE0
    SYSTEM ACTION: THE SECOND CALL TO INITIALIZE IS IGNORED, SINCE
    FASTGEN WAS ALREADY INITIALIZED.
    USER RESPONSE: THIS MESSAGE CAUSES NO PROBLEMS, BUT INDICATES
    THAT ANOTHER USER OF TE IMS PARTNER PRODUCT INITIALIZATION EXIT
    CALLED IOHPPUE0.  THE MESSAGE WILL GO AWAY WHEN ANOTHER PPUE0
    EXIT IS UPDATED TO NOT CALL FASTGEN'S EXIT A SECOND TIME.
    IOH390E CSVQUERY FAILED RC=XX
    EXPLANATION: A CSVQUERY REQUEST FROM THE PARTNER PRODUCT
    INITIALIZATION EXIT RECEIVED AN UNEXPECTED RETURN CODE.
    MODULE: IOHPPUE0
    SYSTEM ACTION: FASTGEN INITIALIZATION CONTINUES.  PROBLEMS
    MAY OCCUR IF THE PPUE0 EXIT IS CALLED MORE THAN ONCE DURING
    IMS RESTART PROCESSING.
    USER RESPONSE: CONTACT THE SUPPORT CENTER TO REPORT THE INCIDENT
    =========================
    MODULES/MACROS:
    =========================
    MODULES:
    ADDED:   IOHFSCD  IOHPPUE0 DFSPPUE0
    DELETED: IOHXCIC0 DFSXCIC0
    UPDATED: IOHINIT  IOHPARM
    JCLIN:
    //*
    //IEWL1   EXEC PGM=IEWL,PARM='LIST,LET,XREF,REUS,NCAL'
    //OBJDSET  DD  DSN=IOH.OBJDSET,DISP=SHR
    //SYSLMOD  DD  DSN=IOH.AIOHMOD1,DISP=SHR
    //SYSLIN   DD  *
    INCLUDE OBJDSET(IOHFSCD)
    ENTRY IOHFSCD
    NAME IOHFSCD(R)
    INCLUDE OBJDSET(IOHPPUE0)
    ENTRY IOHPPUE0
    NAME IOHPPUE0(R)
    //*
    //IEWL2   EXEC PGM=IEWL,PARM='LIST,LET,XREF,REUS,NCAL'
    //AIOHMOD1 DD  DSN=IOH.AIOHMOD1,DISP=SHR
    //SYSLMOD  DD  DSN=IOH.SIOHLOAD,DISP=SHR
    //SYSLIN   DD  *
    INCLUDE AIOHMOD1(IOHPPUE0)
    INCLUDE AIOHMOD1(IOHFSCD)
    ENTRY IOHPPUE0
    ALIAS DFSPPUE0
    NAME IOHPPUE0(R)
    //
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: IMS HIGH PERFORMANCE SYSGEN TOOL USERS       *
    *                 WHO ALSO USE PRODUCTS WITH DEPENDANCIES      *
    *                 ON DFSXCIC0.                                 *
    ****************************************************************
    * PROBLEM DESCRIPTION: IMS HIGH PERFORMANCE SYSGEN TOOLS       *
    *                      CONFLICT WITH BMC PRODUCTS DELTA/IMS    *
    *                      AND XPF. MAY RESULT IN ABEND0C4 OR      *
    *                      BMC PRODUCT INITIALIZATION FAILURE.     *
    ****************************************************************
    * RECOMMENDATION: INSTALL CORRECTIVE SERVICE FOR APAR/PTF      *
    ****************************************************************
    IMS HP SYSGEN TOOLS CONFLICT WITH BMC PRODUCTS DELTA/IMS & XPF.
    MAY RESULT IN ABEND0C4 OR BMC PRODUCT INITIALIZATION FAILURE.
    

Problem conclusion

  • THE HIGH PERFORMANCE SYSGEN TOOLS INITIALIZATION PROCESS HAS
    BEEN CHANGED FROM AN INTERCEPT OF IMS MODULE DFSXCIC0 TO NOW
    USE THE IMS PARTNER PRODUCT INITIALIZATION EXIT DFSPPUE0.
    
    ===========================
       NOTES:
    ===========================
    
    THIS MAINTENANCE REQUIRES THE REMOVAL OF LOAD MODULE IOHXCIC0
    AND IT'S ALIAS DFSXCIC0 FROM THE SIOHLOAD LIBRARY. TWO NEW
    CSECTS (IOHPPUE0, IOHFSCD), ONE LOAD MODULE (IOHPPUE0) AND
    AND ONE ALIAS (DFSPPUE0).
    
    ===========================
       DOCUMENTATION CHANGES:
    ===========================
    
    PROGRAM DIRECTORY:
    SECTION 5.2.3.  THE WARNING BOX (DO NOT COPY THE TARGET LIBRARY
     INTO THE IMS TARGET LIBRARY.  THIS WILL CAUSE THE IMS CONTROL
     REGION TO ABNORMALLY TERMINATE WITH A U4021 ABEND ON THE NEXT
     RESTART OF IMS) NO LONGER APPLIES.
    
     USER'S GUIDE:
      CHAPTER 2, "FASTGEN CONTROL CARDS".  ADDITIONAL CONTROL CARD
      INFORMATION FOLLOWING THE SECRPT CONTROL CARD ON PAGE 8.
    
      DFSPPUE0 CONTROL CARD
    
     THE DFSPPUE0 CONTROL CARD CONSISTS OF THE OPERATION CODE
     'DFSPPUE0' AND ONE REQUIRED KEYWORD, NAME=.  THIS CONTROL
     CARD IS ONLY PROCESSED DURING IMS CONTROL REGION
     INITIALIZATION, AND IS IGNORED FOR BATCH EXECUTION OF THE
     HP SYSGEN TOOLS FASTGEN PROCESS.
    
     NAME=
    
     THIS KEYWORD SPECIFIES ADDITIONAL IMS PARTNER PRODUCT
     INITIALIZATION EXIT ROUTINE (DFSPPUE0) MODULE NAME(S).
     THE DEFAULT IS TO HAVE NO OTHER EXIT ROUTINES CALLED
     DURING HP SYSGEN TOOLS ONLINE INITIALIZATION. IF MORE
     THAN ONE MODULE NAME IS TO BE INVOKED, THE MODULE NAMES
     MAY BE INCLUDED ON MULTIPLE DFSPPUE0 STATEMENTS, OR
     ON A SINGLE CONTROL CARD WITH THE NAMES ENCLOSED IN
     PARENTHESIS.
    
     CHAPTER 2, "CUSTOMIZING THE IMS ONLINE ENVIRONMENT".
    
     REPLACE THE "FAST SYSGEN DATASET PLACEMENT AND AUTHORIZATION"
     SECTION WITH THE FOLLOWING.
    
     FAST SYSGEN IMS ONLINE INSTALLATION
    
     ONCE THE FAST SYSGEN CONTROL CARDS HAVE BEEN PROPERLY
     DEFINED, THE SOFTWARE CAN BE ACTIVATED TO ALLOW THE
     IMS CONTROL REGION TO DYNAMICALLY GENERATE AND MODIFY
     RESOURCE DEFINITIONS.
    
     CARE SHOULD BE TAKEN TO IDENTIFY ANY OTHER USERS OF THE
     IMS PARTNER PRODUCT INITIALIZATION EXIT, DFSPPUE0.  FAST
     SYSGEN REQUIRES THE USE OF THIS EXIT ROUTINE.  IF OTHER
     DFSPPUE0 EXIT ROUTINES ARE PRESENT IN THE INSTALLATION,
     THE OTHER EXIT ROUTINES CAN BE RENAMED AND INVOKED USING
     THE DFSPPUE0 CONTROL CARD.  NOTE THAT AMONG THE OTHER
     USERS OF THIS EXIT ARE THE IBM IMS NETWORK COMPRESSION
     FACILITY, WHICH HAS A SIMILIAR FACILITY, AND SEVERAL OTHER
     VENDOR PRODUCTS.  NOTE THAT IMS WILL ONLY INVOKE THE FIRST
     DFSPPUE0 MODULE FOUND IN THE IMS STEPLIB, SO IT IS
     IMPORTANT TO IDENTIFY ANY OTHER USERS OF THIS EXIT
     ROUTINE AND DETERMINE THE BEST WAY TO HAVE ALL DFSPPUE0
     EXIT ROUTINES INVOKED DURING IMS INITIALIZATION.
     FAST SYSGEN SENDS MESSAGE IOH401I TO THE MVS SYSTEM CONSOLE
     AND SYSLOG WHEN IT'S DFSPPUE0 EXIT ROUTINE IS SUCCESSFULLY
     INVOKED DURING IMS INITIALIZATION.
    
     FASTGEN ALSO SUPPORTS BEING INVOKED BY OTHER PRODUCTS.
     FOR EXAMPLE, IMS NETWORK COMPRESSION FACILITY HAS A
     SIMILIAR FEATURE TO THE DFSPPUE0 CONTROL CARD.  IF IMS
     NETWORK COMPRESSION FACILITY'S LOAD LIBRARY IS PLACED
     AHEAD OF THE SIOHLOAD DATASET, JUST ENSURE THAT IMS
     NETWORK COMPRESSION FACILITY INVOKES MODULE NAME IOHPPUE0.
     NO MODULES IN THE SIOHLOAD LIBRARY WOULD NEED TO BE
     DELETED OR RENAMED.
    
    CHAPTER 2, "CUSTOMIZING THE IMS ONLINE ENVIRONMENT".
    
     REPLACE THE "IMS CONTROL REGION JCL CHANGES" SECTION WITH
     THE FOLLOWING.
    
     IMS CONTROL REGION JCL CHANGES
    
     ONCE THE DFSPPUE0 EXIT ROUTINE UPDATES TO THE FASTGEN
     CONTROL CARDS ARE COMPLETE, THE SOFTWARE CAN BE ACTIVATED
     IN THE ONLINE IMS CONTROL REGION.  THIS MAY REQUIRE SOME
     JCL CHANGES IN THE IMS CONTROL REGION JCL.
    
     IF THE FASTGEN CONTROL CARDS SPECIFY A DDNAME FOR EITHER
     THE IMSGEN OR SECGEN STATEMENTS, THEN THOSE DDNAME(S) MUST
     BE ADDED TO THE IMS CONTROL REGION JCL.  NOTE THAT APAR
     PQ56512 ADDED DYNAMIC ALLOCATION SUPPORT FOR THE IMSGEN
     AND SECGEN SOURCE STATEMENTS, WHICH ALLOWS THE DDNAME=
     SPECIFICATION TO BE REPLACED WITH THE DSN= KEYWORD.  IF
     DATASET NAMES ARE SPECIFIED IN THE FASTGEN CONTROL CARDS,
     THEN NO IMS CONTROL REGION JCL CHANGE IS REQUIRED FOR
     THE GEN SOURCE.
    
     FASTGEN REQUIRES ACCESS TO THE MATRIX AND MODBLKS DATASETS
     (THE STAGING DATASETS - THOSE WITHOUT THE A OR B SUFFIX)
     THAT ARE NOT NORMALLY INCLUDED IN THE IMS CONTROL REGION
     JCL.  THESE DATASETS MUST BE ADDED TO THE IMS CONTROL
     REGION JCL WITH DDNAMES MATRIX AND MODBLKS.
    
     NOTE THAT THE DATASETS REFERENCED IN THE IMS CONTROL REGION
     JCL FOR THE MATRIXA/MATRIXB AND MODBLKSA/MODBLKSB MUST
     ALLOCATE THE A AND B VERSIONS OF THOSE LIBRARIES.  FASTGEN
     DOES NOT SUPPORT HAVING BOTH THE A AND B DDNAMES POINT TO
     THE SAME DATASET (SUCH AS THE STAGING DATASET).
     PRIOR TO THIS APAR, AN IOHRESLB DD STATEMENT WAS REQUIRED.
     THIS DD IS NO LONGER REQUIRED.
    
     THE ONLY OTHER JCL CHANGE REQUIRED IS TO ADD THE SIOHLOAD
     DATASET TO THE IMS CONTROL REGION STEPLIB CONCATENATION.
     ENSURE THAT THE PLACEMENT OF THE SIOHLOAD DATASET IS
     CONSISTENT WITH DFSPPUE0 CONTROL CARDS AND THE LOCATION
     OF OTHER DFSPPUE0 EXIT ROUTINES.
    
     NOTE THAT THE DATASETS REFERENCED IN THE IMS CONTROL REGION
     STEPLIB AND THE MATRIXA/MATRIXB AND MODBLKSA/MODBLKSB DD
     STATEMENTS MUST BE APF AUTHORIZED.  THIS WOULD INCLUDE THE
     SIOHLOAD DATASET IF IT IS PLACED IN THE IMS CONTROL REGION
     STEPLIB.  THE STAGING MATRIX AND MODBLKS DD LIBRARIES DO NOT
     REQUIRE APF AUTHORIZATION.
    
     APPENDIX - "MESSAGES" SECTION.
    
              NEW OR UPDATED MESSAGES.
    
     IOH382E FIND SCD FAILED IN IOHPPUE0
    
     EXPLANATION: THE PARTNER PRODUCT INITIALIZATION EXIT WAS
     UNABLE TO LOCATE THE SCD FOR THIS IMS SUBSYSTEM.
     MODULE: IOHPPUE0
     SYSTEM ACTION: THE IMS CONTROL REGION ABENDS WITH
     A U4021 ABEND.
     USER RESPONSE: CONTACT THE SUPPORT CENTER FOR ASSISTANCE. TO
     CIRCUMVENT THE ERROR, REMOVE THE IMS HP SYSGEN TOOLS LIBRARY
     FROM THE IMS CONTROL REGION STEPLIB (OR AT LEAST MODULE
     IOHPPUE0 AND IT'S ALIAS DFSPPUE0).
    
     IOH383E INVALID KEYWORD IN DFSPPUE0 STATEMENT - XXXXXXXX
    
     EXPLANATION: AN UNIDENTIFIED KEYWORD WAS FOUND IN A DFSPPUE0
     STATEMENT IN THE IOHPIMID MEMBER OF PROCLIB.
     MODULE: IOHPPUE0
     SYSTEM ACTION: THE KEYWORD AND PARAMETER(S) ARE SKIPPED.
     USER RESPONSE: REVIEW THE DFSPPUE0 STATEMENT(S) IN THE IOHP
     PARAMETER MEMBER OF PROCLIB.  THE ONLY VALID KEYWORD ALLOWED
     ON THIS STATEMENT IS NAME=.
    
     IOH384E CONTROL CARD SYNTAX ERROR - UNATCHED PARENS
    
     EXPLANATION: A DFSPPUE0 STATEMENT IN THE IOHP PARAMETER MEMBER
     OF PROCLIB CONTAIN AN UNMATCHED OPEN OR CLOSE PARENTHESIS.
     MODULE: IOHPPUE0
     SYSTEM ACTION: THE REMAINDER OF THE STATEMENT IS IGNORED.
     USER RESPONSE: REVIEW THE DFSPPUE0 STATEMENT(S) IN THE IOHP
     PARAMETER MEMBER OF PROCLIB.  ENSURE THAT EACH STATEMENT HAS
     THE PROPER PARENTHESIS IN THE PROPER ORDER.
    
     IOH385E MODULE NAME EXCEEDS 8 CHARACTERS
    
     EXPLANATION: A DFSPPUE0 STATEMENT IN THE IOHP PARAMETER MEMBER
     OF PROCLIB INCLUDED A MODULE NAME THAT WAS LONGER THAN 8
     CHARACTERS.
     MODULE: IOHPPUE0
     SYSTEM ACTION: THE MODULE NAME IS IGNORED.
     USER RESPONSE: ENSURE THAT MODULE NAMES INCLUDED IN THE
     DFSPPUE0 NAME= SPECIFICATION ARE PROPERLY SPECIFIED.
    
     IOH386I INVOKING USER SPECIFIED DFSPPUE0 EXIT ROUTINE XXXXXX
    
     EXPLANATION: IMS HP SYSGEN INITIALIZATION IS INVOKING THE
     SPECIFIED DFSPPUE0 EXIT ROUTINE AS REQUESTED ON A DFSPPUE0
     STATEMENT IN THE IOHP PARAMETER MEMBER OF PROCLIB.
     MODULE: IOHPPUE0
     SYSTEM ACTION: NONE.
     USER RESPONSE: NONE.
    
     IOH387E LOAD FOR USER SPECIFIED DFSPPUE0 EXIT ROUTINE
     MMMMMMMM FAILED RC=RR ABEND=AAAA
    
     EXPLANATION: THE NAMED MODULE, AS SPECIFIED ON A DFSPPUE0
     STATEMENT, FAILED TO LOAD.
     MODULE: IOHPPUE0
     SYSTEM ACTION: THE NAMED MODULE IS NOT INVOKED DURING IMS
     INITIALIZATION.
     USER RESPONSE: ENSURE THE PROPER NAME WAS SPECIFIED ON THE
     DFSPPUE0 STATEMENT, AND THAT THE MODULE IS AVAILABLE TO THE
     IMS CONTROL REGION.
    
     IOH388E IMS CTL RGN ABEND U4021 DUE TO INITIALIZATION ERROR
     IN IOHPPUE0
    
     EXPLANATION: IMS HP SYSGEN TOOLS INITIALIZATION FAILED.
     MODULE: IOHPPUE0
     SYSTEM ACTION: THE IMS CONTROL REGION ABENDS.
     USER RESPONSE: INVESTIGATE PRIOR IOH MESSAGES TO DETERMINE
     THE CAUSE OF THE INITIALIZATION FAILURE.
    
     IOH389W IOHPPUE0 INVOKED MORE THAN ONCE-BYPASSING
     INITIALIZATION
    
     EXPLANATION: THE FASTGEN PARTNER PRODUCT INITIALIZATION EXIT
     WAS CALLED TWICE DURING IMS RESTART.
     MODULE: IOHPPUE0
     SYSTEM ACTION: THE SECOND CALL TO INITIALIZE IS IGNORED, SINCE
     FASTGEN WAS ALREADY INITIALIZED.
     USER RESPONSE: THIS MESSAGE CAUSES NO PROBLEMS, BUT INDICATES
     THAT ANOTHER USER OF THE IMS PARTNER PRODUCT INITIALIZATION
     EXIT CALLED IOHPPUE0.  THE MESSAGE WILL GO AWAY WHEN ANOTHER
     PPUE0 EXIT IS UPDATED TO NOT CALL FASTGEN'S EXIT A SECOND TIME.
    
     IOH390E CSVQUERY FAILED RC=XX
    
     EXPLANATION: A CSVQUERY REQUEST FROM THE PARTNER PRODUCT
     INITIALIZATION EXIT RECEIVED AN UNEXPECTED RETURN CODE.
     MODULE: IOHPPUE0
     SYSTEM ACTION: FASTGEN INITIALIZATION CONTINUES.  PROBLEMS
     MAY OCCUR IF THE PPUE0 EXIT IS CALLED MORE THAN ONCE DURING
     IMS RESTART PROCESSING.
     USER RESPONSE: CONTACT THE SUPPORT CENTER TO REPORT THE
     INCIDENT.
    

Temporary fix

  • *********
    * HIPER *
    *********
    

Comments

APAR Information

  • APAR number

    PQ65303

  • Reported component name

    IMS COMMAND CTL

  • Reported component ID

    5655F4000

  • Reported release

    110

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    YesHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2002-08-15

  • Closed date

    2002-08-26

  • Last modified date

    2002-10-02

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

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

    UQ69306

Modules/Macros

  • H24Q110J IOHFSCD  IOHINIT  IOHPARM  IOHPPUE0
    

Publications Referenced
GI10827200SC27117000   

Fix information

  • Fixed component name

    IMS HP SYSGEN T

  • Fixed component ID

    5655F4300

Applicable component levels

  • R110 PSY UQ69306

       UP02/09/05 P F209 Ž

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.

[{"Line of Business":{"code":null,"label":null},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCX89J","label":"IMS HP System Generation Tools"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"110"}]

Document Information

Modified date:
22 October 2020