-j sys|cpd|jar|srf
Specifies the type of journal files:
sys: System journal files
cpd: Checkpoint dump files
jar: Archive journal file
srf: Server recovery journal file as OpenTP1 file
When "cpd" or "srf" is specified, this command can be executed only when the journal service is operating.
-s server-name~<identifier, 1-8 characters>
Specifies the name of a server that is to be subject to this processing when information about checkpoint dump files is being displayed.
When this option is omitted, information for all servers is output.
If a value other than cpd is specified in the -j option, the specification of the -s option is discarded.
-r resource-group-name~<1-8 character identifier>
Specifies the name of a resource group for the file whose information is to be displayed when jar is specified in the -j option. It must be the definition file name in the archive journal service definition specified by the definition command jnldfsv -a in the global archive journal service definition. If this option is omitted, information about all file groups is displayed. If a value other than jar is specified in the -j option, the specification of the -r option is discarded.
-g file-group-name~<identifier, 1-8 characters>
Specifies that information about a specific file group is to be displayed when information about system journal files is to be displayed.
When this option is omitted, information about all file groups is displayed.
-d
Displays element file information, together with system journal file, archive journal file or checkpoint dump file information.
When this option is omitted, element file information is not displayed.
If srf is specified with the -j option, specification of the -d option is ignored.
(1)"jnlls -j sys -d" or "jnlls -j jar -d" specified
- #1: The status of system B is displayed only when dual system journal files are used.
- 1. File group status
- 2. Element file status
- aaaaaaaa
- File group name
- bbb
- File type:
- sys: System journal file
- jar: Archive journal file
- cccccccc
- Resource group name (definition file name in the archive journal service definition specified in the global archive journal service definition)
- dddddddd
- Generation number (hexadecimal digits)
- e
- File group open/close status:
- o
- Open (element file that is a constituent of the corresponding file group is open)
- c
- Close (element file that is a constituent of the corresponding file group is closed)
- f
- File group status:
- c
- Current (file group consists of valid element file and is currently subject to journal output processing)
- s
- Standby (file group consists of valid element file, but is not currently subject to journal output processing)
- n
- Reserve (file group does not consist of valid element file)
- g
- File group unload status:#1
- u
- Waiting to be unloaded (contains a journal that was previously used in the current status, but has been swapped and needs to be unloaded)
- -
- Already unloaded
- h
- File group overwritable status:
- d
- Not overwritable (contains journal required for system recovery)
- -
- Overwritable (does not include journal required for system recovery)
- i
- File group status in OpenTP1:
- b
- Currently in use by the jnlunlfg or jnlchgfg command or involved in recovery processing
- -
- Currently not in use by jnlunlfg or jnlchgfg command or involved in recovery processing
- j
- File group compatibility status:
- c
- Element file whose management information is still on current status exists in the journal file, because an error occurred when it was previously being used on current status (e.g., a journal output error occurred in the journal group while on current status).
- -
- File was previously used on current status and has been processed correctly
- k
- File group archived status:#1
- u
- Waiting to be archived. The file group uses the multinode facility and contains journals that have not been output to an archive journal file.
- -
- Already archived
- llllllll
- Run ID (Run ID for the journal service or global archive journal service when a file is used; hexadecimal)
- mmmmmmmm
- Begin block number (hexadecimal)
- nnnnnnnn
- End block number (hexadecimal)
- oooooooo
- Element file name
- p
- Element file open/close status:
- o
- Open (physical file that is a constituent of the corresponding element file is open)
- c
- Close (physical file that is a constituent of the corresponding element file is closed)
- q
- Element file usable status:
- n
- Element file does not consist of a physical file that can be used in online mode
- u
- Element file consists of a physical file that can be used in online mode
- r
- Element file unload status:#2
- u
- Waiting to be unloaded (contains a journal that needs to be unloaded)
- -
- Already unloaded
- s
- Element file archived status:#1
- u
- Waiting to be archived. The element file uses the multinode function and contains journals that have not been output to an archive journal file.
- -
- Already archived
- t
- Element file shutdown status:
- h
- Shutdown (corresponding element file contains a physical file whose journal output has been suspended due to a journal output error in the physical file or due to a journal file header I/O error)
- -
- Not shut down (normal element file)
- u
- Element file readable status:
- r
- Physical file that is a constituent of the corresponding element file cannot be read
- (Full recovery or partial recovery cannot be performed, because the journal has been erased (initialized) and cannot be read. This status occurs if an error occurs in the system journal file and the physical file is re-created and opened after eliminating the cause of the error)
- -
- Physical file that is a constituent of the corresponding element file can be read
- vvvvvvvv
- Number of records already used in the corresponding file (in hexadecimal)#3, #4
- This is the number of records in the OpenTP1 file system to which the journal can be output.
- wwwwwwww
- Total number of records in the corresponding file (in hexadecimal)#4, #5
- This is the number of records in the OpenTP1 file system to which the journal can be output.
- A
- Physical file open/close status:
- o
- Open (corresponding physical file has been opened by the journal service)
- c
- Close (corresponding physical file has not been closed by the journal service)
- B
- Physical file status:
- c
- Current (if the file group status is current, it is subject to journal output operation; if the file group status is not current, an error occurred while it was on current status, and the status is retained in the journal file header, because the error has not been recovered. The physical file cannot be used unless its status is recovered by the jnlunlfg or jnlchgfg command or it is initialized by the jnlinit command)
- s
- Standby
- C
- Physical file unload status:#2
- u
- Waiting to be unloaded (corresponding physical file contains a journal that needs to be unloaded)
- -
- Already unloaded (corresponding physical file does not contain a journal that needs to be unloaded)
- D
- Physical file archived status:#1
- u
- Waiting to be archived. The physical file uses the multinode facility and contains journals that have not been output to an archive journal file.
- -
- Already archived
- E
- Physical file shutdown status:
- h
- Shutdown (journal output error or journal file header I/O error occurred, and no journal has been output thereafter)
- -
- Not shut down (journal can be output)
- F
- Physical file readable status:
- r
- Cannot be read (full recovery or partial recovery cannot be performed, because the journal has been erased (initialized) and cannot be read. This status occurs if an error occurs in the system journal file and the physical file is re-created and opened after eliminating the cause of the error)
- -
- Can be read
- #1: u is displayed if the file group is:
- A system journal file not using the multinode facility, or
- An archive journal file.
When the file group uses the multinode facility and its archived status is '-' (already archived), the file group is not archived even if the archived status of the element file and physical file is 'u' (waiting to be archived). Status mismatch would be caused by an error with the physical file leading to failure to update the status.
- #2: If the file group is already unloaded, there is no need to execute the jnlunlfg or jnlchgfg command even if the element file or physical file is on unload wait status. If an error occurred during execution of the jnlunlfg or jnlchgfg command, their statuses will not match because the status will not have been rewritten.
- #3: If 0 is displayed, no journal has been output. If the status is not current after completion of full recovery, the number of used records may not be correct.
- #4: The total number of records in a file is the number of records in the OpenTP1 file to which the journal service or global archive journal service can output journal blocks, and is equal to the number of records specified with the -n option of the jnlinit command minus 4.
- #5: One record is a 4096-byte area in the OpenTP1 file system managed by the journal service or global archive journal service.
(2)"jnlls -j cpd" specified
- aaaaaaaa
- Server name
- bbbbbbbb
- File group name
- cccccccc
- Generation number (hexadecimal digits)
- d
- Generation status:
- a: Non-overwritable
- u: Overwritable or involved in a write operation
- r: Reserve status
- eeeeeeee
- Journal file group name for the overwrite pointer
- ffffffff
- Journal block number for the overwrite pointer (hexadecimal digits)
(3)"jnlls -j cpd -d" specified
For aaaaaaaa-ffffffff, see (2) above.
- g
- System A or B file status
- o: Open
- c: Close
- h: Error shutdown
- -: Physical file not allocated
(4)"jnlls -j srf" specified
- aaaaaaaa
- Server name
- bbbbbbbbbbbbbbb
- File name (file group name of a server recovery journal file specified in the checkpoint dump service definition)
- ccccc
- Number of server recovery journal file blocks
- ddd
- File utilization percentage (percent ratio of server recovery journals as OpenTP1 files to the file size initialized by the jnlinit command)
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.