TurboIMAGE/XL Database Management System Reference Manual (30391-90012)
Table Of Contents
- 1 Introduction
- 2 Database Structure and Protection
- 3 Defining a Database
- 4 Using the Database
- 5 TurboIMAGE/XL Library Procedures
- Using TurboIMAGE/XL Intrinsics
- DBBEGIN
- DBCLOSE
- DBCONTROL
- DBDELETE
- DBEND
- DBERROR
- DBEXPLAIN
- DBFIND
- DBGET
- DBINFO
- INTRINSIC NUMBER 402
- Syntax
- Parameters
- Discussion
- Mode 101: Item Number
- Mode 102: Item Name
- Mode 103: Items in Database
- Mode 104: Items in Data Set
- Mode 113: BTREEMODE1 and Wildcard Character
- Mode 201: Set Number
- Mode 202: Set Name
- Mode 203: Sets in Database
- Mode 204: Sets with Item
- Mode 205: Set Capacity
- Mode 206: Number of Data Set Chunks
- Mode 207: Size of Data Set Chunks
- Mode 208: Primary and Actual Capacity
- Mode 209: B-Tree Attachment
- Mode 301: Paths
- Mode 302: Key or Search Item
- Mode 401: Logging
- Mode 402: ILR
- Mode 403: Dynamic Roll-Back
- Mode 404: Logging Subsystem Information
- Mode 406: Database Information
- Mode 501: Subsystem Access
- Mode 502: Critical Item Update
- Modes 8nn: Third-Party Indexing
- Mode 901: Language
- DBLOCK
- DBMEMO
- DBOPEN
- DBPUT
- DBUNLOCK
- DBUPDATE
- DBXBEGIN
- DBXEND
- DBXUNDO
- 6 Host Language Access
- Model Program
- ORDERS Database Model Program
- Main Body of Program
- Opening the Database
- Retrieving All the Records on a Chain (with Item Level Locking)
- Retrieving a Data Entry Using a Record Number
- Retrieving Master Data Using a Key Value
- Retrieving Data Serially (with Set Level Locking)
- Adding an Entry
- Updating an Entry
- Deleting an Entry
- Rewinding a Data Set
- Obtaining Database Information
- Obtaining Error Messages and Explanations
- Closing the Database
- C
- COBOL II
- Defining Data Types, Variables, and Intrinsics
- Main Body of Program
- Opening the Database
- Retrieving All the Records on a Chain (with Item Level Locking)
- Retrieving a Data Entry Using a Record Number
- Retrieving Master Data Using a Key Value
- Retrieving Data Serially (with Set Level Locking)
- Adding an Entry
- Updating an Entry
- Deleting an Entry
- Rewinding a Data Set
- Obtaining Database Information
- Obtaining Error Messages and Explanations
- Closing the Database
- FORTRAN 77
- Pascal
- RPG
- 7 Logging and Recovery
- Database Utilities Used in Logging and Recovery
- Recovery Options
- Logical Transactions
- Dynamic Roll-Back Recovery
- Intrinsic Level Recovery
- Logging Preparation
- Step 1--Checking MPE/iX Logging Configuration
- Step 2--Acquiring Logging Capability
- Step 3--Logging to Tape or Disk
- Step 4--Building a Log File for Logging to Disk
- Step 5--Creating the Log Identifier
- Step 6--Setting the Log Identifier
- Step 7--Setting Flags for the Database Backup Copy
- Step 8--Making a Database Backup Copy
- TurboSTORE/iX 7x24 True-Online Backup
- Logging Status
- Logging Maintenance
- Roll-Forward Recovery
- Roll-Back Recovery
- DBRECOV Commands Used with Roll-Forward and Roll-Back Recovery
- Recovery Tables
- Post-Recovery Options
- The Mirror Database
- 8 Using the Database Utilities
- Restructuring the Database with TurboIMAGE/XL Utilities
- Summary of Utility Routines
- Utility Program Operation
- DBLOAD
- DBRECOV
- >CONTROL
- >EXIT
- >FILE
- >RECOVER
- >ROLLBACK
- >RUN
- DBRESTOR
- DBSTORE
- DBUNLOAD
- DBUTIL
- >>ACTIVATE
- >>ADDINDEX
- >>CREATE
- >>DEACTIVATE
- >>DETACH
- >>DISABLE
- >>DROPINDEX
- >>ENABLE
- >>ERASE
- >>EXIT
- >>HELP
- >>MOVE
- >>PURGE
- >>REBUILDINDEX
- >>REDO
- >>RELEASE
- >>SECURE
- >>SET
- >>SHOW
- Syntax
- Parameters
- Example (Show Users)
- Example Discussion
- Example (Show All)
- Example Discussion
- Example (Show Capacity)
- Format of Show Device List
- Example (Show Device)
- Format of Show Indices
- Example (Show Indices)
- Format of Show Locks List
- Example 1 (Show Locks)
- Example 1 Discussion
- Example 2 (Show Locks)
- Example 2 Discussion
- >>VERIFY
- 9 Using a Remote Database
- 10 Internal Structures and Techniques
- 11 B-Tree Indices
- A Error Messages
- B Results of Multiple Access
- C Database Design Considerations
- D Multiple Calls to DBLOCK
- E TurboIMAGE/XL Log Record Formats
- F MPE/iX Log Record Formats
- G Recovery and Logging Quick Reference
- H TurboIMAGE/XL versus TurboIMAGE/V

358 Chapter7
Logging and Recovery
Roll-Back Recovery
For recovery to succeed, you must have access to the log file. This implies either knowing
the maintenance word and having system manager (SM) or operator (OP) capability, or
being the creator of the log identifier with read access to the log file if it resides in a
different logon group and account. If the log file is on tape, you must know the volume
identifier.
NOTE
If the operator is unsure of the volume identifier, it is displayed on the console
when the tape is mounted.
If the database creator and the creator of the log identifier are not the same, and if the disk
log file and the database are in two separate accounts, follow the steps listed below for
recovery to proceed:
1. Assign a maintenance word to the database.
2. Logon as the creator of the log identifier.
3. Fully qualify the database name when issuing the >ROLLBACK command.
4. Specify the maintenance word.
MPE/iX Cleanup Mode and Roll-Back Recovery
In the event of a system failure and subsequent start recovery operation, MPE/iX attempts
to clean up any user log files that were open at the time of the failure. The cleanup
procedure involves writing any records left in the system log file disk buffer to the user log
file. Note that for roll-back recovery without this cleanup, transactions are not lost during
a start recovery operation because they are not held in the memory buffer. You should not
cancel (from the console) this cleanup procedure if the log file is on tape. Canceling the
start recovery operation for tape log files will cause rollback recovery to fail.
The advantage of the cleanup procedure is that fewer user log records written just prior to
the failure are lost. For tape files, the disadvantage is the time it takes for the tape to be
rewound and sequentially scanned until the end-of-file is detected so that the remaining
records can be appended to the end.
The TurboIMAGE/XL recovery program DBRECOV does not require the cleanup to be
performed. If it is not performed, however, DBRECOV most likely will report a sequence or
checksum error when the discrepancy caused by the failure is encountered. This would
cause DBRECOV to assume the end-of-file has been reached.
DBRECOV Abort Message
If DBRECOV aborts before recovery completes, the following information is printed:
Abort occurred on database:
dbname dbgroup dbaccount
Total database open count:
#open
Current open count:
#open
Process user is:
dbuser dbgroup dbaccount
Running program:
progname
Log file name:
logfilename
Logging ID:
logid
Log file record number:
nnnnnnnn
Transaction type:
xx
Transaction date/time from log record:
day, month, dd, year, time
Last successful transaction #:
nn
First log record # of last successful transaction:
nn
Record the information, set the log file, locate the database store, and contact your HP
support representative.