IT33027: APPLICATION BACKUP CAN FAIL WITH "APPMETADATA.JSON(1): EXPECTED VALUE"

APAR status

• Closed as program error.

Error description

• During an IBM Spectrum Protect Plus application backup,
  it can fail if the appMetadata.json file contains no data
    or information within the file. The message encountered
    in the joblog appears as the following:
  
    JOBLOG:
    DETAIL,...,CTGGA2245,SPP log dir:
      /data/log/guestdeployer/<DATE>/<EPOCH>/<EPOCH>/<HOSTNAME>
    ERROR,...,[HOSTNAME] Exception caught: err:
      [c:\ProgramData\SPP\mnt\SPPB_spp_xxx\appMetadata.json(1):
      expected value]
  
    Just prior to the error message, is the path to the
    application log file that may show additional information in
    a file called the command.log. Reviewing the command.log
    file, you see the following:
  
    COMMAND.LOG:
    DEBUG winagent - Command output [Parsing exception:
      [c:\ProgramData\SPP\mnt\SPPB_spp_xxx\appMetadata.json(1):
      expected value]]
    DEBUG winagent- Command output [ERR: [Exception caught: err:
      [c:\ProgramData\SPP\mnt\SPPB_spp_xxx\appMetadata.json(1):
      expected value]]]
    DEBUG winagent - Command output [Creating output format of
      CAL backup]
    DEBUG winagent - Command output [Exit [-7]]
  
    What you can see is there was an attempt to parse the
    appMetadata.json file but it failed. At this point, review
    the contents of the file to determine if the file is valid.
    There should be content in the file besides spaces.
  
  IBM Spectrum Protect Plus Versions Affected:
    10.1.x
  
  Initial Impact:
    Low
  Additional Keywords:
    TS003613005 SPP ISPP SQL
  

Local fix

•   Remove the appMetadata.json file in the location specified.
    During the next backup the file will be recreated.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * IBM Spectrum Protect Plus level 10.1.5 and 10.1.6            *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * Apply fixing level when available. This problem is currently *
  * projected to be fixed in 10.1.6 ifix2 and 10.1.7. Note that  *
  * this is subject to change at the discretion of IBM           *
  ****************************************************************
  

Problem conclusion

• Fixed an issue with a backup after upgrade from an older
  version.
  

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

  SP PLUS

• Fixed component ID

  5737SPLUS

Applicable component levels