OA47115: NEW FUNCTION XRECOVER RC9014 RSN4077 RC=0397 ANTB8006W ANTX5002E ANTX5001E NRF ANTR5102E RC=9014 REAS=4077 ANTX8036I

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• New Function to require the XRC control data set to be increased
  to 1 CYL.
  
  Important: If preparing to install this new function, it is
  recommended to install OA47115, OA49548, OA51983, and OA52305
  together.
  
  If the control dataset is not defined, LPARs will receive both
  ANTB8006W and RC=0397:
  
  ANTB8006W XRC SESSION(SDM02) CONTROL DATA SET NOT ONE CYL OR NOT
  ON A CYL BOUNDARY
  
  ANTS5100E XRC ENCOUNTERED AN ERROR PROCESSING XSTART COMMAND FOR
  SESSION(SDM02), WITH HLQ(SYS1), RC=0397 REAS=0000 SRVC=4013
  
  If the control data set is defined on a cylinder boundry and has
  been used at the OA47115 level it will not be possible to do
  XRECOVER using that dataset on an earlier maintenance level.
  The earlier maintenance level will fail with:
  
  ANTX5002E ****,******,0004,0034,0008,0000
  ANTX5001E 4CC0,NRF,06,0003,0041,0E00,0008000000030000.
  0000000000000004.E55157E94CCB0F00.000040E200000300,XRBCC0,***
  ANTR5102E XRECOVER FAILED FOR SESSION(SDM29A) WITH HLQ(SYS1),
  RC=9014 REAS=4077 FUNC=4017 SRVC=0130
  
  You may also see a state save failure as a result:
  
  ANTX8036I 0000 STORAGE CONTROL STATE SAVE FAILED:I/O ERROR
  
  Ensure that all XRC and KSYS LPARs apply OA47115 together.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of Extended Remote Copy (XRC).     *
  ****************************************************************
  * PROBLEM DESCRIPTION: Conditioning for new function APAR      *
  *                      OA49548.                                *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

Temporary fix

Comments

• The XRC control data set required size is increased to 1 CYL.
  Once the control data set has been used at the OA47115 level it
  will not be possible to do XRECOVER using that dataset on an
  earlier maintenance level.
  
  The following updates will be reflected in a future revision
  of z/OS MVS System Messages, Volume 1(ABA-AOM)(SA38-0668):
  
  
  In Chapter 15. ANT messages, the following messages will be
  added:
  
  Messages:
  ANTI1042I PARAMETER parameter1 VALUE value LIMITED TO new-value
  Explanation: The value of the specified parameter
  parameter1 in parmlib is greater than the allowed limit
  and has been changed to new-value.
  System action: The new value for the parameter that is shown
  in the message is used instead of the value found in parmlib.
  System programmer response: No action is needed if the new
  value new-value is acceptable. Otherwise, change the value in
  parmlib to a value that is supported by this maintenance level.
  Source: Extended Remote Copy (XRC)
  
  ANTR5029E UNSUPPORTED PARAMETER parameter FOUND FOR
  SESSION(session_id)
  Explanation: A PARMLIB parameter was specified for the session
  session_id but is not supported on this release or PTF level.
  System action: The XRECOVER or XADVANCE operation fails.
  System programmer response: Perform the XRECOVER or XADVANCE
  operation on a system where the parameter is supported.
  Source: Extended remote copy (XRC).
  
  
  In the SDM and XRC return codes section of
  Chapter 15. ANT messages, the following return codes will
  be added:
  
  Return codes:
  395 The control data set that is associated with the specified
  session name is fragmented. The control data set must be
  allocated as contiguous storage. See the topic about specifying
  the control data set in z/OS DFSMS Advanced Copy Services for
  the attributes to allocate or reallocate the control data set.
  If any XRC session is coupled, issue either an XCOUPLE PURGE
  or XCOUPLE DELETE command (depending on the status of the XRC
  session) for all sessions before proceeding. After reallocating
  the control data set, issue the original command again.
  
  396 The control data set that is associated with the specified
  session name is not on a cylinder boundary. The control data
  set must be allocated with the primary allocation specified as
  CYL. See the topic about specifying the control data set in
  z/OS DFSMS Advanced Copy Services for the attributes to
  allocate or reallocate the control data set. If any XRC
  session is coupled, issue either an XCOUPLE PURGE
  or XCOUPLE DELETE command (depending on the status of the XRC
  session) for all sessions before proceeding. After reallocating
  the control data set, issue the original command again.
  
  397 The control data set that is associated with the specified
  session name was allocated with insufficient space. See the
  topic about specifying the control data set in z/OS DFSMS
  Advanced Copy Services for the attributes to allocate or
  reallocate the control data set. If any XRC session is
  coupled, issue either an XCOUPLE PURGE
  or XCOUPLE DELETE command (depending on the status of the XRC
  session) for all sessions before proceeding. After reallocating
  the control data set, issue the original command again.
  
  4200 The XRECOVER or XADVANCE command failed because
  the state data set information indicates that the
  session previously used a PARMLIB parameter that is
  not supported on this release or PTF level. Perform the
  XRECOVER or XADVANCE on a system at the same or later
  release or PTF level that the session was active on.
  
  
  The following updates will be reflected in a future revision
  of the z/OS DFSMS Advanced Copy Services manual (SC23-6847):
  
  Section  Specifying the control data set  of Chapter 4
  ( Setting up the extended remote copy environment ) needs to
  be changed as follows.
  
  Change from:
    Prior to its first use, initialize the data set with IEBDG.
    This is sample JCL for allocation and initialization:
    //STEP1    EXEC PGM=IEBDG
    //SYSPRINT DD SYSOUT=*
    //DD1      DD DISP=(NEW,CATLG),
    //            DSN=SYS1.XCOPY.TPC.CONTROL,
    //            STORCLAS=(JRNLSTD),
    //            DCB=(RECFM=FB,LRECL=15360,BLKSIZE=15360,
    //            DSORG=PS),SPACE=(TRK,(1,0))
    //SYSIN    DD *
      DSD OUTPUT=(DD1)
      CREATE QUANTITY=2
      END
    /*
  
  to:
    Prior to its first use, initialize the data set with
    IEFBR14. This is sample JCL for allocation:
    //STEP1    EXEC PGM=IEFBR14
    //DD1      DD DISP=(NEW,CATLG),
    //            DSN=SYS1.XCOPY.TPC.CONTROL,
    //            UNIT=3390,
    //            VOL=SER=JUS002,
    //            STORCLAS=JRNLSTD0,
    //            DCB=(RECFM=FB,LRECL=15360,BLKSIZE=15360,
    //            DSORG=PS),
    //            SPACE=(CYL,(1,0))
    /*
  
  
  Change from:
    Notes: Any valid combination of RECFM, LRECL and BLKSIZE
    that results in two single-record blocks on the track may
    be used.
  
  to:
    Notes: Any valid combination of RECFM, LRECL and BLKSIZE
    that results in one single-record block on the track may
    be used.
   KEYWORDS: XRC/K
  ×**** PE17/02/03 FIX IN ERROR. SEE APAR OA52001  FOR DESCRIPTION
  

APAR Information

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

  OA44674

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

  UA83296 UA83297

Modules/Macros

• ANTS4013 ANTS4042 ANTS4912 ANTS5015 ANTS5017
  ANTXJNTR ANTXJRCD ANTXJRCF ANTXJRCG ANTXJRIN ANTXJRMM ANTXJTIN
  ANTXJTI5 ANTXJTRM ANTXJTSK ANTXJWBM ANTXJWCF ANTXJWMM ANTXJWSF
  ANTXKHNG ANTXSMID ANTXTUN1 ANTXTUN2 ANTXTUN3
  

Fix information

• Fixed component name

  SYSTEM DATA MOV

• Fixed component ID

  5695DF117

Applicable component levels

• R210 PSY UA83296

     UP16/11/19 P F611

• R220 PSY UA83297

     UP16/11/19 P F611

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.