OpenTP1 Version 7 Operation

[Contents][Index][Back][Next]

jnlls (Display journal files information)

Format

jnlls -j sys|cpd|jar|srf [-s server-name]
      [-r resource-group-name] [-g file-group-name] [-d]

Function

The jnlls command outputs information about journal files to the standard output.

Options

-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.

Output format

(1)"jnlls -j sys -d" or "jnlls -j jar -d" specified

[Figure]

#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

[Figure]

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

[Figure]

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

[Figure]

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)

Output messages

Message ID Description Output destination
KFCA01141-E The command cannot be executed because OpenTP1 is running in journal fileless mode. Standard error output
KFCA01280-E jnlls command processing failed. Standard error output
KFCA01281-E jnlls command input format is invalid. Standard error output
KFCA01282-E Specified item was not found. Standard error output
KFCA02128-E Specified server name is invalid. Standard error output
KFCA02130-E -s option specification is invalid. Standard error output
KFCA02132-E jnlls command processing was cancelled due to an error. Standard error output
KFCA02171-E Work area cannot be allocated. Standard error output
KFCA02172-I There is no checkpoint dump file information to be displayed. Standard error output
KFCA01291-I Help message Standard output,
standard error output

Notes

Y: Displayed

N: Not displayed

(Y): Displayed but different from while OpenTP1 is active

#1: ? is displayed for the file groups other than the current one.

#2: This information is not displayed for the current file group. This information may not be displayed for a file group where an error occurred.
  • The jnlls command reads a physical file and displays the journal status when OpenTP1 is inactive. The jnlls command analyzes the journal-related definition files to determine which physical file it should read. Therefore, do not change the following definitions:
  • Journal service definition
  • System journal service definition
  • Global archive journal service definition
  • Archive journal service definition
When a definition is changed, the result cannot be assured. However, a definition can be changed at restart.
  • Take care when displaying the following journal files when OpenTP1 is inactive:
  1. System journal file and archive journal file
    When OpenTP1 is inactive, the jnlls command displays file information, reading the journal-related definition files and physical files. Therefore, it must be executed by the OpenTP1 administrator.
  2. Checkpoint dump file and server recovery journal file converted to OpenTP1 file
    Executing the jnlls command while OpenTP1 is inactive results in a command error.