IT35775: DATABASE PROTECTION STOPS WITH CTGGA3090 '[... VALIDATION FAILEDREASON: [THE PARAMETER IS INCORRECT]]'

APAR status

• Closed as program error.

Error description

• Starting with version 10.1.6, the backup of Microsoft SQL or
  Exchange databases using IBM Spectrum Protect Plus might stop
  with the messages :
  CTGGA3090 ... '[... validation failed reason:
                 [The parameter is incorrect]]'
  
  Here is an example of job log messages for a first base backup
  attempt of a Microsoft Exchange database  :
  
  The database files are stored on volume C:\mnt\db
                  The log files on volume C:\mnt\db_log
  
  SUMMARY,<timestamp>CTGGA2398,Starting job for policy
                               exch_<SLAName> (ID:<SLA_ID>).
                               id -> <JobID>. IBM Spectrum
                               Protect Plus version 10.1.6-2045.
  ...
     INFO,<timestamp>,CTGGA2107,Performing backup of databases
                                [<DBName>] on application server
                                <ExchangeServerAddress>
  ...
   DETAIL,<timestamp>,CTGGA3714,[<ExchangeServerAddress>] Volume
                                (\\?\Volume{<GUID_vol1>}\
                                C:\mnt\db\) runs as Base Backup
                                reason: no prior USN information
   DETAIL,<timestamp>,CTGGA3714,[<ExchangeServerAddress>] Volume
                                (\\?\Volume{<GUID_vol2>}\
                                C:\mnt\db_log\) runs as Base
                                Backup reason: no prior USN
                                information
    ERROR,<timestamp>,CTGGA3090,[<ExchangeServerAddress>]
                                Group \ copy failed. Error:
                                [Source file [\\?\GLOBALROOT\
                                Device\HarddiskVolumeShadowCopy
                                <xx>\<filename>] validation
                                failed reason: [The parameter is
                                incorrect]]
    ERROR,<timestamp>,CTGGG1010,[<ExchangeServerAddress>] Failed
                                to copy files to the mounted
                                target volume.
    ERROR,<timestamp>,CTGGG1116,[<ExchangeServerAddress>] Agent
                                failed to properly finalize the
                                Exchange VSS backup.
  
  The above 'copy failed' message will be seen when there are
  database or log files located in the root of the used
  database/log volumes.
  The validation of the snapshot data used for backups is
  incorrectly done by the code and fails when encountering files
  in the root location of the database or log volumes from which
  the snapshot was taken.
  
  IBM Spectrum Protect Plus Versions Affected:
  IBM Spectrum Protect Plus 10.1.6 and higher
  
  | MDVREGR 10.1.5 5737SPLUS |
  
  Initial Impact: Medium
  
  Additional Keywords: SPP, SPPLUS, snapshot, diskshadow,
                       validation
  

Local fix

• Avoid database or log files to be located in the root location
  of a volume.
  

Problem summary

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

Problem conclusion

• After applying the fixing level, the backup completes regardless
  of whether there are files in the root of the volume.
  

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