OA59659: CQUERY UNFORMAT AND ANTPREXX FORMAT(PQMAP) NOT SUPPORTED FOR PPRC MULTI-TARGET PPRCMT

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Clients can receive incorrect output for CQUERY UNFORMAT and
  ANTPREXX FORMAT(PQMAP) when PPRC Multi-Target is enabled via
  SYS1.PARMLIB(DEVSUPxx) parameter ENABLE(PPRCMT).  Note that
  after OA56525, ENABLE(PPRCMT) is the default.
  
  Instead of CQUERY UNFORMAT, capture CQUERY via REXX OUTTRAP:
  
  /* REXX */
  
  CQUERY_PRINT. = ""
  CQUERY_PRINT.0 = 0
  OUTRAP_RETURN = OUTTRAP('CQUERY_PRINT.')
  "CQUERY DEVN(nnnn)"
  OUTRAP_RETURN = OUTTRAP('OFF')
  
  DO I = 1 TO CQUERY_PRINT.0
   SAY CQUERY_PRINT.I
  END
  
  EXIT 0
  
  Instead of ANTPREXX FORMAT(PQMAP) use ANTPREXX FORMAT(PQMP2):
  
  //ANTPREXX EXEC PGM=IKJEFT1B
  //SYSEXEC DD DISP=SHR,DSN=SYS1.DGTCLIB
  //SYSUDUMP DD SYSOUT=*
  //SYSTSPRT DD SYSOUT=*
  //SYSTSIN DD *
   ANTPREXX PQUERY DEVN(nnnn) SUBCHSET(0) QRYINFO() QRYSIZE(262)
  FORMAT(PQMP2)
  /*
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Users of Multi-Target PPRC.                                  *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * CQUERY UNFORMAT AND PQUERY                                   *
  * FORMAT=PQMAP|LONG may not provide an                         *
  * indication that incomplete query                             *
  * results are returned.                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

• Informational messages ANTP0280I will now be returned if a TSO
  CQUERY UNFORMAT command is issued to a system with
  ENABLE(PPRCMT) is specified in the DEVSUPxx member of PARMLIB.
  
  For an ANTRQST PQUERY FORMAT=PQMAP|LONG the following will be
  returned if ENABLE(PPRCMT) is specified in the DEVSUPxx member
  of PARMLIB:
  
  RQST_PQUERY_ADDITIONAL_MT_RELS EQU 7249 X'1C51'
  
  The following updates will be reflected in a future revision
  of z/OS MVS System Messages, Volume 1(ABA-AOM)(SA38-0668):
  
  New message will be added:
  
  ANTP0280I CQUERY UNFORMAT IS NOT COMPATIBLE WITH MULTI-TARGET
  PPRC
  
  Explanation
  ENABLE(PPRCMT) is specified in the DEVSUPxx member of PARMLIB.
  CQUERY UNFORMAT IS NOT COMPATIBLE WITH MULTI-TARGET PPRC.
  Additional relationships may exist that are not included in the
  query results. The UNFORMAT report is replaced by the
  FORMAT=PQMP2 on the ANTRQST PQUERY request.
  
  System action
  Incomplete query results may be returned.
  
  System programmer response
  Obtain information on a Multi-target PPRC environment with the
  FORMAT=PQMP2 option on the ANTRQST PQUERY request or issue a
  TSO CQUERY FORMAT query.
  
  Source
  Peer-to-peer remote copy (PPRC).
  
  
  In section "ANTRQST return codes and reason codes"
  
  Update the following return code description to:
  
  RQST_PQUERY_ADDITIONAL_MT_RELS EQU 7249 X'1C51'
  *
  * Meaning: Additional PPRC multi-target relationships
  * may exist, but are not included in the results.
  *
  * FORMAT(PQMAP) or FORMAT(LONG) was specified on the
  * request. These options are not compatible with a
  * multi-target PPRC environment.
  *
  * Action: To ensure all relationships are included
  * in the query results specify PQUERY with
  * FORMAT(PQMP2).
  *
  
  
  
  The following updates will be reflected in a future revision
  of the z/OS DFSMS Advanced Copy Services manual (SC23-6847):
  
  section on TSO CQUERY command syntax the keyword description
  of UNFORMAT will be updated to include the following note:
  
  UNFORMAT
  Note: this option is not compatible with multi-target PPRC.
  The UNFORMAT report is replaced by the FORMAT=PQMP2 on
  the ANTRQST PQUERY request or TSO CQUERY FORMAT query
  for multi-target environments.
  
   KEYWORDS: D/T2107 PPRC/K
  

Temporary fix

Comments

APAR Information

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

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

  UJ04577 UJ04578

Modules/Macros

• ANTRQSTL ANTS4904 ANTPPMSG ANTPCQRY
  

Fix information

• Fixed component name

  SYSTEM DATA MOV

• Fixed component ID

  5695DF117

Applicable component levels

• R230 PSY UJ04577

     UP20/12/18 P F012

• R240 PSY UJ04578

     UP20/12/18 P F012

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.