Windows operating systems

The Journal Database Viewing utility

Edit online

The Journal Database Viewing utility provides valuable information to help in problem determination of journal-based backups.

The Journal Database Viewing utility provides the following information:
  • The current state of the journal
  • The file system that is tracked by the journal
  • The journal activation time stamp
  • The journal validation time stamp
  • The maximum supported journal size
  • The node and server for which the journal is valid
  • The number of entries currently in the journal
Note: For backup-archive clients that are older than Version 6.3.1, you cannot view the contents of open journals with the viewing utility. An open journal is one that is opened by another process, such as the journal daemon. You can, however, view the contents of an open journal control record. The viewing utility is available with V6.3.1 and newer backup-archive clients. For more information about the viewing utility, see the following technote: Run the dbviewb.exe utility in batch mode.

This utility also allows searching, inserting, or deleting specific entries in a journal database.

The syntax of this utility is as follows: 
dbviewb <fully qualified journal database basefile name> 
dbviewb <fully qualified journal database basefile name> <i>
D:\tsm540c\debug\bin\winnt_unicode>dbviewb c:\tsmjournal\tsmh__.jdb
IBM
Storage Protect
Journal Database Viewing Utility
Version 5, Release 4, Level 0.0
Last Update: Nov 28 2006
Querying Journal DB ...
Journal Database Information:
Database File c:\tsmjournal\tsmh__.jdb
Database File Disk Size 81 KB (83754 Bytes)
Journal File System H:
Journal Activation Date Tue Nov 28 11:49:05 2006
Journal Validation Date Wed Nov 29 16:41:11 2006
Maximum Journal Size 8191 PB (9223372036854775807 Bytes)
Journal Type Change Journal
Journal State Valid
Valid for Server GSHLAGER2_SERVER1
Valid for Node GSHLAGER3
Number of DB Entries 22
D:\tsm540c\debug\bin\winnt_unicode>

D:\tsm540c\debug\bin\winnt_unicode>dbviewb c:\tsmjournal\tsmh__.jdb i
IBM
Storage Protect
Journal Database Viewing Utility
Version 5, Release 4, Level 0.0
Last Update: Nov 28 2006
Querying Journal DB ...
Journal Database Information:
Database File c:\tsmjournal\tsmh__.jdb
Database File Disk Size 81 KB (83754 Bytes)
Journal File Syst em H:
Journal Activation Date Tue Nov 28 11:49:05 2006
Journal Validation Date Wed Nov 29 16:41:11 2006
Maximum Journal Size 8191 PB (9223372036854775807 Bytes)
Journal Type Change Journal
Journal State Valid
Valid for Server GSHLAGER2_SERVER1
Valid for Node GSHLAGER3
Number of DB Entries 22
Enter request on a single line, in the following format:
Req-Type [Entry-key]
Req-type might be one of the following:
Del Delete a row from the database. The fully-qualified case sensitive 
file name is required.
Find Find the entry whose key is the argument.
List Print all the entries to stdout. No arguments are required.
Quit
Please enter your request: find H:\dbview.example\Dir3Depth1\F2.txt
Located Journal Database Record:
-----------------------------------------
Object Name : H:\dbview.example\Dir3Depth1\F2.txt
Action : Modify
Object Type : File
Inserted : Fri Dec 01 10:15:28 2006
Object Time : Fri Dec 01 14:15:28 2006
Hit Count : -2110169276
-----------------------------------------
Please enter your request: quit