PI50270: POSSIBLE FALSE RC=8 WITH GEO064E, GEO117I, GEO317A DURING 'SYSPLEX='CF NORMAL' OPERATION

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• During 'SYSPLEX='CF NORMAL' operation GDPS may experience false
  RC=8 and messages GEO064E, GEO117I, and GEO317A. This may take
  place if message IXC545I is delivered by z/OS to a system other
  than the one where z/OS command "SETXCF START,REALLOCATE" is
  submitted.
  SYSPLEX='CF NORMAL' STARTED STARTED
  GEO064E (56893) COMMAND REALLOCATE UNSUCCESSFUL, CHECK IN
   IXC359I MESSAGE RESULTS
  GEO066I (56893) SETXCF START,REALLOCATE NOT OK'
  GEO117I GDPS SCRIPT EXECUTION ERROR
  GEO317A SYSPLEX CF NORMAL RC=8
          REPLY 'ACCEPT' TO CONTINUE
          OR 'CANCEL' TO CANCEL ACTION/SCRIPT
  nnn GEO118A REPLY 'ACCEPT','CANCEL' OR 'REPEAT'(QUESTION)
  GEO066I (56893) END COUPLING FACILITY MANAGEMENT WITH STATUS
  FAILED
  SYSPLEX='CF NORMAL' ENDED RC=8
  

Local fix

• Check other participating members of sysplex for IXC545I. If
  Exceptions reported on that message is zero, processing can
  continue (REPLY ACCEPT to GEO317A). If Exceptions is nonzero,
  find any IXC546I messages in the log to determine the name of
  the CF structures for which REALLOCATE processing could not
  complete, or use DISPLAY XCF,REALLOCATE,REPORT for the same
  purpose to determine what CF structures might need manual
  attention.
  ADDITIONAL SYMPTOMS:
  Customer attempting CF NORMAL with a deactivated backup CF lpar
  defined may experience following as well:
  VPCESPM4: CFname not available, check attempt #
  'GEO066I END COUPLING FACILITY MANAGEMENT WITH STATUS FAILED'
  IRX0026I Error running VPCESPM4, line 402: Invalid whole number
  'SYSPLEX='CF NORMAL' ENDED RC=8
  This apar will also address the rexx error and RC8 from CF
  NORMAL where a defined backup CF is found deactivated during
  execution of the script.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: GDPS Coupling Facility Management            *
  *                 GDPS/PPRC GDPS/MTMM                          *
  *                 GDPSPPRC/K GDPSMTMM/K                        *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR addresses two GDPS Coupling   *
  *                      Facility management related issues      *
  *                      with the SYSPLEX='CF NORMAL' script     *
  *                      statement.                              *
  *                      1-During SYSPLEX='CF NORMAL' script     *
  *                        statement processing GDPS may fail    *
  *                        with RC=8 even though the action      *
  *                        completes correctly.                  *
  *                        This may occur if message IXC545I     *
  *                        is issued by z/OS on a system other   *
  *                        than the one where the command        *
  *                        SETXCF START,REALLOCATE is entered    *
  *                        and the GDPS script statement is run. *
  *                      2-A customer executing a script         *
  *                        SYSPLEX='CF NORMAL' with a            *
  *                        deactivated CF defined in the GDPS    *
  *                        Sysplex Resource Management panel     *
  *                        will experience following as well:    *
  *                        VPCESPM4: CFname not available,       *
  *                        IRX0026I Error running VPCESPM4,      *
  *                        line 402: Invalid whole number        *
  *                      Messages GEO117I, GEO317A and GEO118A   *
  *                      are also issued to indicate the script  *
  *                      statement has failed                    *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

• GDPS code has been changed as follows:
  1- processing of the z/OS response to SETXCF START,REALLOCATE
     has been modified to ensure the results are captured.
  2- processing is changed to ignore CFs that are deactivated at
     the time the SYSPLEX='CF NORMAL' is executed.
  

Temporary fix

• Missing message IXC545I:
  Check other participating members of sysplex for IXC545I. If
  Exceptions reported on that message is zero, processing can
  continue (REPLY ACCEPT to GEO317A). If Exceptions is nonzero,
  find any IXC546I messages in the log to determine the name of
  the CF structures for which REALLOCATE processing could not
  complete, or use DISPLAY XCF,REALLOCATE,REPORT for the same
  purpose to determine what CF structures might need manual
  attention.
  Deactivated CF defined:
  Remove deactivated CF from GDPS Sysplex definition panel
  before running the script and add it after.
  

Comments

APAR Information

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

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

  UI36256 UI36257

Modules/Macros

• VPCESPM4
  

Fix information

• Fixed component name

  GDPS-GEO DISP P

• Fixed component ID

  694235B00

Applicable component levels

• R3BC PSY UI36256

     UP16/04/23 P F604

• R3CC PSY UI36257

     UP16/04/23 P F604

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.