Dump DNS Journal File (DMPDNSJRNF)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Dump DNS Journal File (DMPDNSJRNF) command dumps the contents of a zone journal file in a human-readable form.
Journal files are automatically created by DNS server when changes are made to dynamic zones (e.g., by NSUPDATE command). They record each addition or deletion of a resource record, in binary format, allowing the changes to be re-applied to the zone when the server is restarted after a shutdown or crash. By default, the name of the journal file is formed by appending the extension .jnl to the name of the corresponding zone file.
This command converts the contents of a given journal file into a human-readable text format. Each line begins with add or del, to indicate whether the record was added or deleted, and continues with the resource record in master-file format.
Restrictions:
- You must have execute (*X) authority to the directories in the path of the output file.
- You must have write (*W) authority to the output file if it already exists.
- You must have read, write and execute (*RWX) authority to the output file's parent directory if the output file does not already exist.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| JRNFILE | Journal file | Path name | Required, Positional 1 |
| TOSTMF | Output file | Path name, *STDOUT | Optional, Positional 2 |
| Top |
Journal file (JRNFILE)
Specifies the journal file which is used to dump the zone journal.
This is a required parameter.
- path-name
- Specify the path name for the zone journal file where the journals dump to.
| Top |
Output file (TOSTMF)
Specifies the name of a stream file where all command output is written.
- *STDOUT
- All command output goes to the standard output device (normally the display).
- path-name
- Specify the path name for a stream file where output should be written.
| Top |
Examples
DMPDNSJRNF JRNFILE('/qibm/userdata/os400/dns/ns/example.com.db.jnl')
This command shows how to dump one journal file. Output from the command is sent to stdout and will look like the following:
add W2.EXAMPLE.COM. 3600 IN A 12.12.12.2 del EXAMPLE.COM. 172800 IN SOA EXAMPLE.COM. postmaster.EXAMPLE.COM. 4 10800 3600 604800 86400 add example.COM. 172800 IN SOA EXAMPLE.COM. postmaster.EXAMPLE.COM. 5 10800 3600 604800 86400 add W3.EXAMPLE.COM. 3600 IN A 12.12.12.3
| Top |
Error messages
*ESCAPE Messages
- DNS0013
- Error processing command parameters.
- DNS0065
- Option 33 of i5/OS is required, but is not installed.
- TCP7124
- Program &1 in library &2 type *PGM ended abnormally.
| Top |