IT19997: fteCreateTransfer missing option to remove single quotes from around source and destination file specifications.

APAR status

• Closed as program error.

Error description

• IBM MQ Managed File Transfer v8 and later removes single quotes
  from around source and destination file specifications.
  
  WebSphere MQ 7.5 does not remove these single quotes, leading to
  file specifications such as
  
  /home/fteuser/'/test/jobs/myFile.data'
  

Local fix

Problem summary

• ****************************************************************
  USERS AFFECTED:
  This issue affects users of:
  
  - The WebSphere MQ V7.5 Managed File Transfer component
  
  who run the fteCreateTransfer command, specifying:
  
  - A source_specification surrounded by single quotes (').
  - And one of the following parameters to specify the destination
  specification, surrounded by single quotes ('):
      - A destination_file, via the -df parameter
      - A destination directory, using the -dd parameter.
      - A destination queue, using the -dq parameter.
      - A destination filespace, via the -du parameter.
  
  and do not want the single quotes to be part of the
  source_specification or destination specification for the
  managed transfer request created by the command.
  
  
  Platforms affected:
  MultiPlatform
  
  ****************************************************************
  PROBLEM DESCRIPTION:
  The WebSphere MQ Managed File Transfer (MFT) command
  fteCreateTransfer is used to submit managed transfer requests to
  an agent and generate transfer templates. The command takes a
  number of parameters, including:
  
  - The source_specification, which defines the source, or
  sources, for the file transfer.
  - A destination specification, which can be one of the
  following:
      - A destination_file, specified via the -df parameter
      - A destination directory, specified using the -dd
  parameter.
      - A destination queue, specified using the -dq parameter.
      - A destination filespace, specified via the -du parameter.
  
  These values for these parameters can be included in double
  quotes, as shown in the example below
  
  fteCreateTransfer -sa AGENT1 -da AGENT2 -dd C:\import -df "c
  d.txt" "a b.txt"
  
  If the shell where the command is being executed from passes the
  leading and trailing double quotes to the freCreateTransfer
  command, the command will remove them from the
  source_specification and destination specification before either
  submitting the managed transfer request to the appropriate agent
  or generating the transfer template.
  
  However:
  
  - If the command contained a source_specification and/or a
  destination specification that were surrounded in single quotes
  (').
  - And the shell where the command was being executed from passed
  the leading and trailing single quotes to the fteCreateTransfer
  command
  
  then the command would include the single quotes in the managed
  transfer request submitted to the agent or the transfer template
  that was generated.
  

Problem conclusion

• The WebSphere MQ V7.5 Managed File Transfer component has been
  updated to allow leading and single quotes to be removed from a
  source_specification and a destination specification before the
  fteCreateTransfer command submits a managed transfer request to
  an agent or generates a transfer template. To enable this
  behaviour, the parameter:
  
    -rsq
  
  needs to be added to the fteCreateTransfer command.
  
  Note that the MQ V8 and V9 Managed File Transfer component, and
  MQ Managed File Transfer for z/OS V8 and V9, will remove leading
  and trailing single quotes from a source_specification and
  destination specification if they are passed to the
  fteCreateTransfer command from the shell where the command is
  run from. This APAR provides a mechanism for the WebSphere MQ
  V7.5 Managed File Transfer component to have the same behaviour
  if required.
  
  ---------------------------------------------------------------
  The fix is targeted for delivery in the following PTFs:
  
  Version    Maintenance Level
  v7.5       7.5.0.8
  
  The latest available MQ maintenance can be obtained from
  'WebSphere MQ Recommended Fixes'
  http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006037
  
  If the maintenance level is not yet available information on
  its planned availability can be found in 'WebSphere MQ
  Planned Maintenance Release Dates'
  http://www-1.ibm.com/support/docview.wss?rs=171&uid=swg27006309
  ---------------------------------------------------------------
  

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

  WMQ MFT

• Fixed component ID

  5724H7242

Applicable component levels

• R750 PSY

     UP