Displays the status of status files.

(a) HiRDB/Single Server

Unit status file

pdls -d sts [{-x host-name | -u unit-identifier}] [{-n logical-filename | -f physical-filename|-a|-l|-p}]

Server status file

pdls -d sts -s server-name [{-n logical-filename | -f physical-filename|-a|-l|-p}]

(b) HiRDB/Parallel Server

Unit status file

pdls -d sts {-x host-name | -u unit-identifier} [{-n logical-filename | -f physical-filename|-a|-l|-p}]

Server status file

pdls -d sts -s server-name [{-n logical-filename | -f physical-filename|-a|-l|-p}]

(a) {-x host-name | -u unit-identifier}

For unit status file status display, specifies the identifier of the unit or the name of the host corresponding to the unit status file. This option can be omitted for a HiRDB/Single Server because the host and unit are fixed.

-x host-name ~<identifier> ((1-32))

Specifies the name of the host corresponding to the unit status file.

-u unit-identifier ~<identifier> ((4 characters))

Specifies the identifier of the unit corresponding to the unit status file.

(b) -s server-name ~<identifier> ((1-8))

Specifies the name of the server corresponding to the status files for the server whose status is to be displayed.

(c) {-n logical-filename|-f physical filename|-a|-l|-p}

Specifies how the status of the status files is to be displayed. When this option is omitted, the command displays the status of all status files being used by the specified unit or server.

-n logical-filename ~<identifier> ((1-8))

If the status of the status files for a specific logical file is to be displayed, specifies the name of the logical file.

-f physical-filename ~<path name> ((up to 167 characters))

If the status of the status files for a specific physical file is to be displayed, specifies the absolute path name of the physical file. The physical file name must be specified in the format HiRDB-file-system-area-name\HiRDB-file-name.

-a

Specifies that a summary of the status of all status files being used by the unit or server is to be displayed.

-l

Specifies that the status of each logical file being used by the unit or server is to be displayed.

-p

Specifies that the status of each physical file being used by the unit or server is to be displayed.

1. Return code 0 for the pdls -d sts command indicates normal termination, and return code 8 indicates abnormal termination.
2. Executing the pdstsinit or pdstsrm command for a status file whose logical file status is CLOSE, NONE, or BLOCKADE during HiRDB operation does not change the status information displayed by the pdls command. In this case, the current status of the status file can be displayed by executing the pdstsopen command prior to the pdls command.

 
 HOSTNAME : aa...a(bbccdd)
  Logical file L_Status Factor Available Manage   ......2
  ee...e       ff...f   ggg    hh...h    ii...i   ......2
 Sy  P_status R_length R_count P_name   ................1,2
  j  kk...k   ll...l   mm...m  nn...n   ................1,2
  j  kk...k   ll...l   mm...m  nn...n   ................1,2
 

Explanation

Item 1 displays the status of physical files, and item 2 displays the status of a logical file.

aa...a

Host name (up to 32 characters).

bbccdd

Time of pdls command execution (hour:minute:second).

ee...e

Name of logical file (up to 8 characters).

ff...f

Status of logical file (up to 8 characters):

ACTIVE

Current file

BLOCKADE

Error shutdown file

CLOSE

Reservation file

NONE

No physical file corresponds to the logical file

STANDBY

Reserve file

ggg

Record utilization in the file (%).

hh...h

Number of available consecutive records in the file (8 decimal digits).

ii...i

Number of management records in the file (8 decimal digits).

j

Whether the physical file is A or B:

A

A

B

B

kk...k

Displays a maximum of 11 characters denoting physical file status information; if fewer than 11 characters are displayed, the displayed characters are right-justified (up to 11 characters):

a

Current file

b

Error shutdown file

c

Closed file

i

Initialized status

l

Logical error

n

No physical file corresponds to the logical file

o

Open file

p

Physical error

r

Recovered from an error

s

Reserve file

u

Used file

ll...l

Record length (8 decimal digits).

mm...m

Number of records (8 decimal digits).

nn...n

Name of physical file (up to 63 characters).