PH62626: ITX MAP ENDS WITH 'SHADOW FILE RENAME FAILED' ERROR WHEN RUNNING MAP ON Z/OS USS 3.1, IF WRITING TO A NATIVE DATASET

APAR status

• Closed as program error.

Error description

• When running ITX on z/OS USS with a simple map execution with an
  output override:
  
  -OF2 [ALLOC DD(OUT1)
  DSN('USER.TEST.OUTPUT.BASIC.S999999.XYZ01.F01') OLD /VX0A]
  
  On a previous version of z/OS, which was 2.4, the results was:
  
  <TargetReport  card="2"  adapter="File"  bytes="5627"
  adapterreturn="0"> <Message>Data written successfully</Message>
  <Settings>//'USER.TEST.OUTPUT.BASIC.S999999.XYZ01.F01'</Settin
  gs> <TimeStamp>08:06:52 July 12, 2024</TimeStamp>
  </TargetReport>
  
  Whereas with z/OS 3.1, you might see:
  
  <TargetReport  card="2"  adapter="File"  bytes="0"
  adapterreturn="-99998"> <Message>Shadow file rename
  failed</Message>
  <Settings>//'USER.TEST.OUTPUT.BASIC.S999999.XYZ01.F01') OLD
  </Settings>
  </TargetReport>
  
  Note how the file name has some extra data on it.
  

Local fix

• ITXCQ - ITX00062590
  PB / PB
  Circumvention: None
  

Problem summary

• Users Affected:
  IBM Transformation Extender users z/OS 3.1 USS users writing to
  native MVS files.
  
  Problem Description:
  ITX map ends with 'Shadow file rename failed' error when running
  map on z/OS 3.1 if writing to a native dataset.
  
  Platforms Affected:
  z/OS
  

Problem conclusion

• Corrected error that ITX map ends with 'Shadow file rename
  failed' error when running map on USS z/OS 3.1 and writing to a
  native dataset. Problem was that there was extra data in the
  fopen that was previously ignored in earlier z/OS releases but
  caused a failure in z/OS 3.1.
  
  Applies to:
  10.1.2.1, 11.0.0.0, 11.0.1.0
  
  Fixed in the next service packs and releases.
  
  To obtain the fix for this APAR:
  
  To see if the next fix pack or product release is available,
  check the IBM Transformation Extender product Release Notes
  page:
  https://www.ibm.com/support/pages/node/318755
  
  If a fix pack release is available, download it from Fix
  Central:
  http://www.ibm.com/support/fixcentral/
  
  If a new product release is available, download it from Passport
  Advantage:
  https://www.ibm.com/software/passportadvantage/pao_customer.html
  
  
  If the fix pack or product release is not available and you
  require the APAR fix immediately, request a Limited Availability
  Interim Fix (LAIF) by opening a support Case:
  https://www.ibm.com/mysupport
  

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:

Fix information

• Fixed component name

  TX Z/OS

• Fixed component ID

  5655RA100

Applicable component levels