OpenTP1 Version 7 Operation

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

fills (Display contents of an OpenTP1 file system)

Format

fills {[-[H] [L] [{t|u}] ] OpenTP1-file-system-area-name
       [/OpenTP1-file-name]|[-X] OpenTP1-file-system-area-name
       [/OpenTP1-file-name]}

Function

The fills command outputs to the standard output the contents of an OpenTP1 file system.

If only an OpenTP1 file system area name is specified in the command arguments, all OpenTP1 files in the specified OpenTP1 file system are output in alphabetical order. If an OpenTP1 file name is also specified, only the specified OpenTP1 file is output.

Options

-H

Specifies the header for the information to be displayed. The information is displayed vertically in alphabetical order of the file names.

-L

Specifies that the lock status of the files is to be displayed vertically in alphabetical order of the file names.

-{t|u}

-t
Specifies that the OpenTP1 file system contents are to be displayed sequentially beginning with the file with the most recent update date and time.

-u
Specifies that the OpenTP1 file system contents are to be displayed sequentially beginning with the most recent access date and time.

The -t and -u options cannot both be specified together with the -H and -L options. The order of displaying the information is governed by the -t or the -u option specification.

-x

Specifies that only the file names are to be displayed, listed horizontally in alphabetical order.

When this option is omitted, the OpenTP1 file system contents are displayed vertically in alphabetical order of the file names.

Command arguments

OpenTP1-file-system-area-name~<path name>

Specifies the name of the character special file or ordinary file containing the OpenTP1 file system.

OpenTP1-file-name~<OpenTP1 file name>

Specifies the name of an OpenTP1 file.

Output format

(1)-H option specified

MODE     UID    GID   RSIZE  RNUM    TIME   FILE
aabbcc  dd...dd   ee...ee   ffff    ggggg   hh...hh   ii...ii

aa
Owner's access right:
r: Has the read right
w: Has the write right
-: Does not have the read or write right

bb
Group's access right:
r: Has the read right
w: Has the write right
-: Does not have the read or write right

cc
Others' access right:
r: Have the read right
w: Have the write right
-: Do not have the read or write right

dd...dd
Owner name (up to 9 characters)

ee...ee
Owner's group name (up to 9 characters)

ffff
Record length

ggggg
Number of records

hh...hh
Last update date and time (in the format hour: minute [Figure]month-day-year)

ii...ii
OpenTP1 file name

(2)-H and -L options specified

MODE     UID   GID   PID   L  TIME   FILE
aabbcc  dd...dd  ee...ee  pppp  q  hh...hh   ii...ii

aa
Owner's access right:
r: Has the read right
w: Has the write right
-: Does not have the read or write right

bb
Group's access right:
r: Has the read right
w: Has the write right
-: Does not have the read or write right

cc
Others' access right:
r: Have the read right
w: Have the write right
-: Do not have the read or write right

dd...dd
Owner name (up to 9 characters)

ee...ee
Owner's group name (up to 9 characters)

pppp
ID of the locked process (if no process has been locked, "-" is displayed)

q
Lock status identifier flag:
E: Exclusive lock
S: Shared lock
-: No lock

hh...hh
Last update date and time (in the format hour: minute [Figure]month-day-year)

ii...ii
OpenTP1 file name

Output messages

Message ID Description Output destination
KFCA01503-I Help message Standard output, standard error output
KFCA01533-E File was not found. Standard error output
KFCA01536-E Specification of a command argument is invalid. Standard error output
KFCA01537-E No option flag is specified or the combination of option flags is invalid. Standard error output
KFCA01570-E File versions do not match. Standard error output
KFCA01571-E User does not have access right to the file. Standard error output
KFCA01572-E An upper bound was exceeded during open processing. Standard error output
KFCA01573-E Specified OpenTP1 file system area was not found. Standard error output
KFCA01574-E Specified file name is too long. Standard error output
KFCA01575-E Specified file is not a character special file or ordinary file; or, specified file was found, but there is no corresponding device. Standard error output
KFCA01576-E Specified file is not an OpenTP1 file system. Standard error output
KFCA01578-E Locking of OpenTP1 file system failed. Standard error output
KFCA01582-E Memory is inadequate. Standard error output
KFCA01583-E I/O error occurred. Standard error output
KFCA01599-E Error occurred. Standard error output