IBM Support

IT29135: THE VSNAP IS NOT PROPERLY ADDED TO THE INVENTORY JOB IF ITS ASSOCIATED SITE NAME CONTAINS ESCAPE CHARACTERS

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • Special characters like escape characters('\n', '\r', '\t',
    '\b') are included to the site name. For example, the space
    characters are added at the beginning of site name. Spectrum
    Protect Plus is not configured to support these special
    characters in the name of the site. Hence an exception is
    thrown by failing to add the vSnap server to the inventory job
    as following:
    
    Storage server has error: Adding node to catalog job failed,
    e=Illegal unquoted character ((CTRL-CHAR, code 9)): has to be
    escaped using backslash to be included in string value at
    [Source:
    {"href":"http://localhost:8082/api/storage/2105","resourceType":
    "storage","name":"hos-sppvsnapdb03.hosting.interconnect.nl","id"
    :"2100","include":true,"metadata":{"path":"  site name:2100",
    "name":"vsnap host name"}}; line: 1, column: 174]
    
    Even with above exception message, the vSnap is added. But
    it is not displayed in vSnap Storage Utilization report.
    

Local fix

  • 1. remove escape characters from site name
    2. un-register vSnap
    3. re-register vSnap
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED:                                              *
    * IBM Spectrum Protect Plus level 10.1.0, 10.1.1, 10.1.2 and   *
    * 10.1.3                                                       *
    ****************************************************************
    * PROBLEM DESCRIPTION:                                         *
    * See ERROR DESCRIPTION                                        *
    ****************************************************************
    * RECOMMENDATION:                                              *
    * Apply fixing level when available. This problem is currently *
    * projected to be fixed IBM Spectrum Protect Plus level        *
    * 10.1.4. Note that this is subject to change at the           *
    * discretion of IBM                                            *
    ****************************************************************
    

Problem conclusion

  • Parsing logic of site names were enhanced to handle escape
    characters.
    

Temporary fix

  • Use a name that does not have escape characters
    

Comments

APAR Information

  • APAR number

    IT29135

  • Reported component name

    SP PLUS

  • Reported component ID

    5737SPLUS

  • Reported release

    A13

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2019-05-14

  • Closed date

    2019-06-12

  • Last modified date

    2019-06-12

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

Modules/Macros

  • api
    

Fix information

  • Fixed component name

    SP PLUS

  • Fixed component ID

    5737SPLUS

Applicable component levels

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

Document Information

Modified date:
30 January 2024