IBM Support

IJ25369: PREFETCH FAILS WHEN LIST FILE WITH SAME NAME PRESENT

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

  • While prefetching files with AFM a file containing a list
    of files to be prefetched is provided to the mmafmctl
    prefetch command. But if the prefetch command is
    initiated
    on a application node and a file with similar name and in
    the same path is present on the gateway node, the file
    list
    on gateway is actually queued instead of file list passed
    to the prefetch command. This file on the gateway may be
    completely unrelated to the prefetch and hence the
    prefetch
    will fail.
    

Local fix

  • If an unrelated file list is present on the gateway node
    with same name and path as the one passed to the prefetch
    command then delete that file from the gateway node and
    retry the prefetch command
    

Problem summary

  • Prefetch enhancements in 5.0.2
    introduced a minor internal check
    such that if the list file is present
    in an NFS mount common
    across the application and
    Gateway nodes, AFM skips
    copying this list file from app to
    GW and uses the list file
    as is on GW node.
    But sometimes the same path
    and file name can exist and
    have 2 entirely unrelated files.
    

Problem conclusion

  • Benefits of the solution:
    Ability for AFM prefetch to be able to decide whether
    or not to copy the list file from app node to gateway
    node, if the same list file is available on the
    gateway node also.
    Work around:
    Rename the list file on the Application
    node to have a unique name
    such that it doesn't match any
    similar file on the Gateway node.
    Or remove/rename similar named list
    files on the gateway node
    so that AFM prefetch doesn't detect
    the same named list file
    from the Application node that its
    present on the gateway node.
    Problem trigger:
    Have same named list file
    on the gateway node and the application
    node. These files should
     have a different list of files.
     Try running prefetch with this list file
     from the application node.
    Symptom:
    Unexpected Results/Behavior
    Platforms affected:
    All Linux Gateway nodes and
     Linux and AIX OS nodes application nodes.
    Functional Area affected:
    AFM
    Customer Impact:
    High Importance.
    

Temporary fix

Comments

APAR Information

  • APAR number

    IJ25369

  • Reported component name

    SPEC SCALE STD

  • Reported component ID

    5737F33AP

  • Reported release

    504

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2020-06-03

  • Closed date

    2020-06-17

  • Last modified date

    2020-06-17

  • 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

    SPEC SCALE STD

  • Fixed component ID

    5737F33AP

Applicable component levels

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"STXKQY","label":"IBM Spectrum Scale"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"504","Line of Business":{"code":"LOB26","label":"Storage"}}]

Document Information

Modified date:
18 June 2020