LTAPESIZE configuration parameter

Use the LTAPESIZE configuration parameter to specify the maximum tape size of the device to which the logical logs are backed up when you use ontape for backups.

The LTAPESIZE configuration parameter also specifies the maximum tape size of the device to which data is loaded or unloaded when you use the -l option of the onload or onunload utility. If you are using onload or onunload, you can specify a different tape size on the command line. If you want to use the full capacity of a tape, set LTAPESIZE to 0.

onconfig.std value
LTAPESIZE 0
units
KB
range of values
0 - 4294967296 (4 TB)
0 - 9223372036854775807 (9 ZB)
takes effect
For the ontape utility:
  • When you run an ontape command.
  • When you reset the value dynamically in your onconfig file by running the onmode -wf command.
For the onload and onunload utilities: When the database server is shut down and restarted

Usage

LTAPESIZE specifies the maximum tape size of the device to which the logical logs are backed up when you run the ontape utility for backups. LTAPESIZE also specifies the maximum tape size of the device to which data is loaded or unloaded when you use the -l option of the onload or onunload utility. If you are using the onload or onunload utility, you can specify a different tape size on the command line. If you want to use the full capacity of a tape, set LTAPESIZE to 0.

Note: If the BACKUP_FILTER parameter is set in the ONCONFIG file, the LTAPESIZE cannot be set to 0. Otherwise the ontape utility returns an error when backing up logical logs to a directory on disk. The error message is:
The LTAPESIZE configuration parameter cannot be set to 0 when the BACKUP_FILTER
configuration parameter is set; change the value of LTAPESIZE.
Program over.

A workaround is to set the LTAPESIZE configuration parameter to a very high value. Log files are not much higher than the LOGSIZE configuration parameter. Use the value in the LOGSIZE as the upper limit for this database.

If you specify a LTAPESIZE value, ON-Bar ignores the value.