IBM Support

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

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

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.9
    
    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 number

    IT19997

  • Reported component name

    WMQ MFT

  • Reported component ID

    5724H7242

  • Reported release

    750

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2017-03-31

  • Closed date

    2017-11-30

  • Last modified date

    2017-11-30

  • 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



Document information

More support for: WebSphere MQ
WMQ File Transfer Edition

Software version: 7.5

Reference #: IT19997

Modified date: 30 November 2017


Translate this page: