OneDB Primary Storage Manager file-naming conventions

When creating files that store your backup data, the HCL OneDB™ Primary Storage Manager uses specific file-naming conventions.

For the DBSPOOL and LOGPOOL device pools, the path name of the storage file consists of:
  1. Category information:
    • For space backups, the category consists of the device name, the database server name, and the space name
    • For log backups, the category consists of the device name, the database server name, server number, and a log file number
  2. For space backups, the backup level, either: 0, 1, or 2
  3. A version number, which is an integer that starts at 1 for an object of that category and is incremented for each subsequent backup of an object of that category.
  4. An ID that identifies a piece of the backed up object

For space backups, file names have this format:

/device/DBSERVERNAME/dbspace/backup_level/DBSERVERNAME.version.piece
For example, the name of the file for the third piece of a second level 0 backup of the dbspace rootdbs for the server named SERVER1 is:
/my_device/SERVER1/rootdbs/0/SERVER1.2.3

For log backups, file names have this format:

/device/DBSERVERNAME/SERVERNUM/LOG_UNIQUE_ID/DBSERVERNAME.version.piece 

If you use the onsmsync utility with the -E option to export a backup generation in the OneDB Primary Storage Manager, the onsmsync utility creates and places the backup files in a subdirectory of the storage manager EXTPOOL device. You must provide a prefix (the name of a subdirectory) when you use the onsmsync utility with the -E or -I options. ON-Bar uses the specified path as a key to communication with the storage manager to store and retrieve objects.