PH15517: INCORRECT ERROR MESSAGE RETURNED WHEN MAP FILE IS NOT AVAILABLE AND A SINGLE QUOTE IS USED IN THE COMMAND LINE

APAR status

• Closed as program error.

Error description

• In IBM Transformation Extender 9.0.0, when running a map through
  the Command Server, the map fails with incorrect error code when
  the map is not available and the parameters include a single
  quote.  The error code should be 3 but the Command Server
  instead returns 56.  This error only occurs when the map is not
  available in the current / specified directory location.
  

Local fix

• ITXCQ - ITX00059900
  PB / AD
  Circumvention: None
  

Problem summary

• Users Affected:
  IBM Transformer Extender customers who use the command server
  
  Problem Description:
  If map not present in the current directory, command server
  should give error.
  
  Map could not complete (3):  Could not open map (0 seconds).
  But command server is giving usage error for below command,
  > dtxcmdsv map.lnx "-IMMQS1 '-QMN stuff -QN stuff'"
  
  Platforms Affected:
  All
  

Problem conclusion

• Command server first checks for all the argument and then try to
  open the map.
  
  The argument to command server,
  > dtxcmdsv map.lnx "-IMMQS1 '-QMN stuff -QN stuff'"
  
  -IMMQS1 To Override input card
  
  But when digit in the argument is bad card number then all next
  char should get ignored until next argument (in our case '-QMN
  stuff -QN stuff' this should get ignored).
  
  Current code just ignores '-QMN stuff char and continues
  processing from -QN stuff' and as -Q is not a valid argument for
  dtxcmdsv it gives usage error.
  
  Code has been changed to ignore character in the single quote if
  it is BadCard. (BardCard- card number in the argument is greater
  than map card count)
  
  Note: BadCard=Code somehow gets the card count (If the map does
  not present then count will be zero) and compare with the
  overriding card in the argument.
  
  
  Applies to:
  9.0.0.3, 10.0.0.0, 10.0.0.1
  
  Fixed in the next service packs and releases.
  
  To obtain the fix for this APAR:
  
  To see if the next service pack or product release is available,
  check the IBM Transformation Extender Release Notes page:
  https://www.ibm.com/support/docview.wss?uid=swg27008337
  
  If the service pack or product release is available, download it
  from Fix Central:
  http://www.ibm.com/support/fixcentral/
  
  If the service pack or product release is not available and you
  require the APAR fix immediately, request a Limited Availability
  Interim Fix (LAIF) by opening a case:
  https://www.ibm.com/mysupport/
  
  Prior to version 9.0.0, IBM Transformation Extender was called
  IBM WebSphere Transformation Extender.
  

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

  ITX

• Fixed component ID

  5724Q2300

Applicable component levels