LTAPEDEV configuration parameter

Use the LTAPEDEV configuration parameter to specify the device or directory file system to which the logical logs are backed up when you use ontape for backups.

The LTAPEDEV configuration parameter also specifies the device to which data is loaded or unloaded when you use the -l option of onload or onunload. If you are using LTAPEDEV to specify a device for onunload or onload, the same information for TAPEDEV is relevant for LTAPEDEV.

onconfig.std value
On UNIX: /dev/tapedevOn Windows: NUL
if not present
On UNIX: /dev/nullOn Windows:NUL
takes effect
For ontape:
  • When you execute ontape, if set to a tape device.
  • When the database server is shut down and restarted, if set to /dev/null on UNIX or nul on Windows.
  • When you reset the value dynamically in your onconfig file by running the onmode -wf command.
  • When you reset the value in memory by running the onmode -wm command.
For onload and onunload: When the database server is shut down and restarted


Warning: Do not set LTAPEDEV to /dev/null or nul when you use ON-Bar to back up logical logs.
If you specify a tape device in the LTAPEDEV configuration parameter, ON-Bar ignores the value.
Important: Set LTAPEDEV to /dev/null or leave it blank on UNIX or NUL on Windows only if you do not want to back up the logical logs. You must take the database server offline before you change the value of LTAPEDEV to /dev/null.

When you set LTAPEDEV to /dev/null:

  • The database server frees the logical logs without requiring that you back up those logs. The logical logs do not get marked as free, but the database server can reuse them.
  • The ON-Bar activity log shows a warning and return code 152. Because the database server marks the logical logs as backed up when they are no longer current, ON-Bar cannot find logical logs to back up. All transactions in those logs are lost, and you are not able to restore them.

If you performed a whole-system backup with LTAPEDEV set to null, you must use the onbar -r -w -p command during restore to notify ON-Bar that you do not want to restore the logs. .