Backup Options

-a

Include the domain ACL files in the backup.

-aonly

Only include the domain ACL files in the backup. No tables will be backed up.

-d

The SPD Server LIBNAME domain.

Note: The system that performs the backup must be able to access the physical path for the domain locally or through a network connection.

-f

The prefix filename for the backup data file. This filename is concatenated with _BK_ddmmmyyy_hhmmss.0.0.0.spds. The complete name identifies it as an SPD Server backup file. If the backup file exceeds the system's file size limit, spdsbkup automatically extends the file, separating it into multiple backup files with a unique SPD Server filename extension (the "0.0.0" portion of the filenames will be different).

-fibfact <n>

Increase the File Information Block (FIB) metadata space by a factor of n, where n is greater than or equal to 2. The -fibfact option is necessary only if a backup fails due to insufficient file information block metadata space (fibspace). File information block metadata space shortages occur when the domain that is being backed up contains an unusually large number of data sets.

-full

Performs only full backups of SPD Server tables. All of the table observations and attributes (indexes, definitions, partition size, compression, and sorted) are backed up. After each full table backup, it resets the last full backup date for the table. See the -n option for dependencies.

-h

The SPD Server host to use for the backup.

-hash

Prints the hash sign (#) to stdout for each 256K block that is compressed and written to the backup file.

-help

Prints the command-line usage syntax and option switch list for the spdsbkup utility.

-inc

Performs incremental backups of the SPD Server tables.

-n

Does not save index information for SPD Server tables when performing full backups. When the table is restored, the restore utility does not create indexes. Note that the index itself is not backed up, only the definition of the index is.

-nv6warn

Suppresses the 'Cannot back up v6 data set' warning. Spdsbkup 4.5 can only back up SPD Server and SPD Server data sets. Attempting to back up earlier versions of SPD Server data sets results in a warning message unless the -nv6warn option is invoked.

-p

The user password.

-proj <dir>

The domain project directory.

-q

Runs spdsbkup in quiet mode, which outputs only error messages and warning messages during a backup operation.

-r

The number of times spdsbkup should retry accessing a table that is not available to spdsbkup because it is being updated. A table that is being updated cannot be backed up. Spdsbkup 4.5 pauses five seconds, then retries the table if it was unavailable during the previous access attempt. The default retry count is one.

-s

The port number of the name server. If this is not specified, the default value is spdsname.

-t

The date/time of the last full system backup for the table that are to be backed up.

When the -t option is used with spdsbkup, the utility performs a full backup only if a table was created after the specified date/time. Otherwise, it sets the last full backup date for the table to the specified date/time and performs an incremental backup from the last full system backup date.

When the -t option is used with spdsbkup -inc, the utility prints a warning message if it encounters a table that was created after the specified date/time. The message states that the table will not be backed up until a full backup of the table is completed. If spdsbkup encounters a table that was created before the specified date/time (that is, it is in the last full system backup), spdsbkup sets the last full backup date for the table to the specified time and performs an incremental backup of the table using the last full system backup date.

The -t option cannot be used with spdsbkup -full.

-u

The user name.

-v

Includes the full name of the backup file and the backup's table of contents file as part of a spdsbkup note.

[Table ...]

The list of tables in the domain that you want to include in the backup. If no tables are specified, all of the eligible tables in the domain are backed up.

Note: The list of tables to be backed up must be the last option that you specify.