OA45135: LISTDATA CC12 WHEN RUNNING FDRPAS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• While running Innovation's FDRPAS product to SWAP a space
  efficient DASD volume concurrently with IDCAMS LISTDATA
  EXTENTPOOLCFG/SPACEEFFICIENTVOL commands, IDCAMS receives
  RC=12 with no error message other than the following:
  
  IDC3003I FUNCTION TERMINATED. CONDITION CODE IS 12
  
  IDC0002I IDCAMS PROCESSING COMPLETE. MAXIMUM CONDITION CODE WAS
  12
  
  If LISTDATA is run during a configuration change, the job can
  potentially end with a condition code 12 without any prior
  messages indicating the error.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: D/T2107 users of the IDCAMS LISTDATA         *
  *                 functions.                                   *
  ****************************************************************
  * PROBLEM DESCRIPTION: LISTDATA gives RC12 with no describing  *
  *                      message while running Innovation's      *
  *                      FDRPAS product to SWAP a DASD volume    *
  *                      concurrently with execution of IDCAMS   *
  *                      LISTDATA EXTENTPOOLCFG and              *
  *                      SPACEEFFICIENTVOL commands.             *
  ****************************************************************
  * RECOMMENDATION: LISTDATA software will:                      *
  *                 1. Retry call to UCB Locate routine once if  *
  *                    return code is nonzero.                   *
  *                 2. Add new reason codes to message IDC31559I *
  *                    if UCB Locate service fails retry.        *
  *                 3. Check for device swap condition if I/O    *
  *                    successful and report an informational    *
  *                    message.                                  *
  ****************************************************************
  

Problem conclusion

• Failing scenario is a result of LISTDATA software detecting an
  IO reconfig condition due to device swap.  Error occurs in UCB
  Locate routine which builds the subsystem workarea ucb list that
  matches the caller's request.  Client expects its SWAP run to
  pass but also expects a more descriptive message as to reason
  run failed.
  
  Retry UCB Locate routine once if it fails. If it fails again,
  report the following message:
  
  IDC31559I ASYNCHRONOUS OPERATIONS MANAGER RC=08 REASON=052
  IDC3003I FUNCTION TERMINATED. CONDITION CODE IS 12
  
  IDC0002I IDCAMS PROCESSING COMPLETE. MAXIMUM CONDITION CODE
  WAS 12
  
  Return Code of 8 indicates operation failed. Reason Code of 52
  indicates I/O config token mismatch or in the middle of I/O
  reconfig. In addition, there are other reasons for failure
  that will be documented for IDC31559I.
  
  - 48 (NO UCBS FOUND TO MATCH CALLER'S REQUEST)
  - 52 (RECONFIG OR TOKEN MISMATCH)
  - 56 (SPACE EFFICIENT VOLUME REQUEST FOR ONLINE DEVICE THAT
        HAS AN UNINITIALIZED DCE)
  
  If I/O is successful and results are valid, they could be for
  an extent pool on a different storage box due to device swap.
  If the swap had resulted in an I/O failure, we would have
  reported an error. If the swap does not result in an I/O
  failure, it is appropriate to identify this case and report an
  informational message indicating that the data returned is
  from a different storage device (box).
  
  IDC31559I ASYNCHRONOUS OPERATIONS MANAGER RC=00 REASON=004
  < Data Report >
  IDC0001I FUNCTION COMPLETED, HIGHEST CONDITION CODE WAS 0
  
  IDC0002I IDCAMS PROCESSING COMPLETE. MAXIMUM CONDITION CODE
  WAS 0
  
  Return Code of 0 indicates service completed without error.
  Reason Code of 4 indicates data provided is for swapped
  device.
   KEYWORDS: D/T2107
  

Temporary fix

Comments

• ×**** PE15/01/21 FIX IN ERROR. SEE APAR OA46943  FOR DESCRIPTION
  

APAR Information

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

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

  UA74429 UA74430

Modules/Macros

• AOMCTFMT IDCSS01  IDCSS02  IDCSS04  IDCSS05
  IDCSS06
  

Fix information

• Fixed component name

  DEV SUPPORT SER

• Fixed component ID

  5695DF113

Applicable component levels

• RD10 PSY UA74429

     UP14/08/12 P F408

• R210 PSY UA74430

     UP14/08/12 P F408

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.