IBM Support

IT12391: EDITING A DATASET TRANSFER ITEM DATASET WITH ATTRIBUTES CAUSES INVALID NAME

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • When editing a transfer item, defined within a resource monitor
    or transfer template, that contains a data set with optional
    attributes separated by semicolons, the entire definition is
    added to the "Data set" name field.  This included the name of
    the data set and all of the attributes, for example
    "//TRANS.FILE.TXT;RECFM(V,B);BLKSIZE(6144);LRECL(1028);SPACE(5,1
    )".  The optional data set attributes list remained empty.
    
    This resulted in the WebSphere MQ Explorer Managed File Transfer
    plug-in "Add Transfer Item" wizard reporting the error:
    
    Data set name
    //TRANS.FILE.TXT;RECFM(V,B);BLKSIZE(6144);LRECL(1028);SPACE(5,1)
     is invalid.
    
    and preventing the user from clicking "Okay" after editing the
    transfer item.
    

Local fix

  • Delete all of the attributes from the data set name field such
    that, for example, the entry is changed from:
    
    //TRANS.FILE.TXT;RECFM(V,B);BLKSIZE(6144);LRECL(1028);SPACE(5,1)
    
    to
    
    //TRANS.FILE.TXT
    
    and redefine all of the data set attributes using the add
    attribute wizard on the transfer item page.
    

Problem summary

  • ****************************************************************
    USERS AFFECTED:
    This issue affects users of the:
    
      - WebSphere MQ v7.5 Explorer Managed File Transfer plug-in
      - IBM MQ v8.0 Explorer Managed File Transfer plug-in
    
    who create and then edit transfer items within a Resource
    Monitor or Transfer Template definition that contains a data set
    (sequential or partitioned) which also includes one or more
    optional attributes.
    
    
    Platforms affected:
    MultiPlatform
    
    ****************************************************************
    PROBLEM DESCRIPTION:
    Resource Monitor and Transfer Template definitions, after being
    created, are stored in an XML format.  When a Resource Monitor
    or Transfer Template is subsequently edited via the WebSphere MQ
    Explorer, the XML definition is parsed to create the internal
    Java objects for that Resource Monitor or Transfer Template.
    
    If the XML definition for the included transfer item was a data
    set (either a sequential or partitioned data set) the WebSphere
    MQ Explorer did not parse the data set item to remove any
    optional attributes and list them in the dedicate attributes
    list for the transfer item.  For example, in the following XML
    definition for a destination transfer item that is a data set:
    
            <destination exist="error" type="dataset">
    
    <file>//TRANS.FILE.TXT;RECFM(V,B);BLKSIZE(6144);LRECL(1028);SPAC
    E(5,1)</file>
            </destination>
    
    the WebSphere MQ Explorer would populate the data set name field
    with the value:
    
    
    //TRANS.FILE.TXT;RECFM(V,B);BLKSIZE(6144);LRECL(1028);SPACE(5,1)
    
    This then resulted in the WebSphere MQ Explorer showing an error
    at the top of the "Add Transfer Item" wizard page stating the
    data set name was invalid.
    

Problem conclusion

  • The WebSphere MQ Explorer Managed File Transfer plug-in has been
    updated such that, when editing a transfer item in a Resource
    Monitor or Transfer Template, any optional attributes included
    on a data set transfer item are now parsed.  The name of the
    data set, without the optional attributes, is populated within
    the "Data set:" field in the "Add Transfer Item" wizard page and
    the individual attributes are listed within the "Data set
    attributes" section.
    
    For more information about this APAR, please see the following
    video : https://www.youtube.com/watch?v=lKGdyRsxrlU
    
    ---------------------------------------------------------------
    The fix is targeted for delivery in the following PTFs:
    
    Version    Maintenance Level
    v7.5       7.5.0.7
    v8.0       8.0.0.5
    
    The latest available FTE maintenance can be obtained from
    'Fix List for WebSphere MQ File Transfer Edition 7.0'
    http://www-01.ibm.com/support/docview.wss?uid=swg27015313
    
    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

    IT12391

  • 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

    2015-11-23

  • Closed date

    2015-12-16

  • Last modified date

    2016-04-29

  • 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

[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSCUHLE","label":"WMQ Managed File Transfer"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"7.5","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
29 April 2016