 |
» |
|
|
|
This command lists file and directory attributes through the
use of options. The LISTFILE
information is a superset of the LISTF
command information. Syntax | |
LISTFILE [[fileset=] { fileset (fileset [,fileset]...) }] [[;FORMAT=]format_opt]
[
[;SELEQ=]select_eq
| ^indir]
[ [;NAME=]pattern]
[
;PASS]
[
; {PERM} {;TEMP} [;PERMTEMP]]
[
;USENAME] [;TREE] [;NOTREE] Parameters | |
- fileset
Specifies the set of files to be listed. The default
for fileset is @,
meaning all MPE-named files in your current working directory (CWD).
If fileset includes more than one file,
be sure to separate the file names with commas and enclose the set
in parentheses, for example: :listfile (test1,test2,test3) |
The files named in the fileset
parameter can be either in MPE or HFS syntax (explained below).
The file names dot (.) and dot-dot (..) have special meaning, that
is, current directory and the parent of the current directory, respectively. Using Wildcards You may use wildcard characters in any position in the file
name. You may use the -
character as a wildcard in any position except as the first character of the file name.
These wildcards have the following meaning: - @
matches zero or more of any character - ?
matches one character - #
matches one digit - [ ]
matches one character specified between the brackets - -
if used within brackets ([ ]), the hyphen (-) means
a range of characters. For example, "[c - g]" means all the characters
between c and
g inclusive.
The character on the left must alphabetically precede the character
on the right. - -
If used immediately after the left bracket ([),
or just before the right bracket (]), hyphen (-) means the character
`-' itself.
For example, "[a-c]" means one of 'a', 'b',
or 'c', whereas "[-a-c]" or "[a-c-]" means one of 'a',
'b', 'c', or '-'. It is illegal to specify [c-a], or [a-A] because 'c'
does not alphabetically precede 'a' and uppercase 'A'
comes before lowercase 'a' (in ASCII character evaluation).
Also note that it is legal to specify [A-z] and any legal special
characters. MPE Syntax If fileset does not begin with
the dot or slash (indicating HFS syntax), it is parsed according
to MPE syntax and has the following form: filename[.groupname[.accountname] ] |
A LISTFILE
command using MPE syntax does not display files that do not follow
the traditional MPE naming conventions of up to eight character
names for files, groups and accounts. If the fileset parameter does not
specify groupname, all the files (with
uppercase names that have up to 8 alphanumeric characters) in the
current working directory (CWD) are listed irrespective of whether
CWD is an MPE group or not. For example, the following command lists
the files in all of the groups of the logon account: In contrast, the next command lists all the files in the CWD
(which may be different from the logon group). However, only those
files whose names are valid MPE names are displayed. If the CWD is not an MPE group, the information about the
file is displayed in an HFS format discussed below. You may have an MPE group that also contains files with HFS
syntax, for example, they are lowercase, have long names, or contain
special characters. To see both MPE and HFS files in a group, type, HFS Syntax If the fileset begins with a dot
(.) or a slash (/), it is assumed to be in HFS syntax. The characters
composing the name may be selected from the following set: a-z
A-Z
0 1 2 3 4 5 6 7 8 9 - _ . ' ~ $ % ^ * + \ { } :
|
If the fileset parameter begins
with a slash (/), the pathname is assumed to be an absolute pathname;
otherwise, it is considered to be CWD relative. If fileset ends in a slash, it
is treated as a directory name, and pattern
is used to determine the file names that match. All the directories
and files that match fileset are found,
and searched recursively to display the files and directories that
match pattern. For example, if fileset
is /SYS/@/, all
files and subdirectories within SYS,
and all files and directories within those subdirectories are displayed.
The default for pattern is @. If fileset does not end in a slash,
all of the files that match fileset are
displayed. For example, if fileset is
/SYS/@, you will
see a list of all files, subdirectories and groups in the SYS
directory, but not any files or subdirectories within those directories. If you have specified TREE,
a trailing slash is assumed at the end of the fileset.
For example, the command LISTFILE /SYS/@;TREE
behaves like LISTFILE /SYS/@/.
On the other hand, if you specify NOTREE,
the trailing slash, if present at the end of a fileset, is ignored.
Hence, the command LISTFILE /SYS/@/;NOTREE
behaves like LISTFILE /SYS/@. - format_opt
A format selection. This parameter has no effect
on the files selected for display, but affects the selection of
information about the files that you see. If fileset
begins with a dot (.) or slash (/), or if the CWD is different from
your current MPE group, or if you specify the ;TREE
option, then you will see the HFS output style. This, in part, means
that: Account, group, and
directory names will end in a slash (/). File names will appear at the end of the output
lines. Output begins in column two so that you can more
easily detect filename wraparound from the previous line (which,
if wrapping occurs, will begin in column one).
The following Table 5-1 “Format Options” displays
the format options available. Table 5-1 Format Options | Option | Name | Displayed Information |
|---|
| -2 | ACD | Displays the file's ACD (access
control definition). System Managers can view the ACD for any file.
Account Managers can view the ACD for files in that account. File
creators can view the ACD for their files. Other users can view
an ACD only if that ACD specifies that the user has RACD (read ACD)
access. | | -1 | LABEL | Shows only the file label in hexadecimal.
The hexadecimal display generated by this format option only serves
a diagnostic purpose in MPE/iX and is subject to change. | | 0 | FILES | For each directory, this option
displays PATH=The
name of the file is displayed in a multicolumn format. This is the
default. | | 1 | SUMMARY | Displays the file name, file code,
record size, record format, and other file characteristics such
as ASCII or binary records, carriage-control option, file type,
current end-of-file location, and the maximum number of records
allowed in the file. | | 2 | DISC | Displays the file name, file code,
record size, file type, current end-of-file location, and the maximum
number of records allowed in the file. It also displays the blocking
factor, number of sectors in use, number of extents currently allocated,
and the maximum number of extents allowed. | |
3 -3 | DETAIL DETAIL;PASS | Displays the file name,
record size, extent size, number of records, user's access rights,
and other file characteristics including the date created, modified,
and last accessed. The same information for MPE and HFS files is
displayed except for the following differences: Fully qualified MPE file name
is replaced by an absolute pathname. Creator field displays the fully qualified user
ID (user.acct) of the file owner. For MPE groups, the SECURITY field displays SAVE;
for entries other than MPE groups it is blank. All file access matrix
fields are blank for anything other than MPE accounts, MPE groups,
and files in an MPE group. The LOCKWORD field is omitted.
The
creator, group id, and label address are omitted in FORMAT=3.
These can be obtained by specifying -3 if you have sufficient capability
(AM or SM) | | 4 | SECURITY | Displays the security matrix
for the file. This includes account, group and file-level security,
and the access rights for the user. For MPE groups and
MPE accounts, the security matrix for group, account, and account-only
are displayed. The rest of the fields of the file access matrix
are blank. For HFS directories, and files within HFS
directories, all the fields of the file access matrix are blank.
In addition, LISTFILE
displays the message ACD EXISTS. | |
5 -5 | DATA DATA;PASS | Shows LISTFILE,3
data and all file-specific data in LISTFILE,3
type format (KSAM, SPOOL, and symbolic links). If a file has no
unique data, only the option 3 data is shown. | | 6 | QUALIFY | Shows the absolute pathname of
the file. | | 7 | UNIQUE | Shows all file specific data in
LISTFILE,5 type
format, but does not show LISTFILE,3
data. If a file has no unique data, only the file name is displayed.
Default = 0 (FILES). | | 8 | ACCESS | Shows all accessors of the files
listed. Restrictions apply. | | 9 | LOCKS | Shows level 8 information and details about
processes accessing the files including file locking data. Restrictions
apply. |
- select_eq
A selection equation. Use the selection equation
as a filter on fileset. From the set
of files matching the fileset, only files that match the select_eq
requirements are listed. You may select file types by using the
FTYPE option,
or you may select object types by using the OBJECT
option. Selection equations have the following format: [FTYPE = KSAMXL | SPOOL]
[OBJECT = ACCT | GROUP | FILE | DIR | HFSDIR | SYMLINK]
[CODE = number | |mnemonic | |PRIV
[ACCESS = INUSE | OPEN | LOCK| EXCL] |
You must enclose selection equations in square brackets. For
example: LISTFILE ./@ ;SELEQ=[OBJECT=DIR] |
You can also use your text editor to make a file that contains
the OBJECT or
FTYPE statement,
for example [OBJECT=DIR],
and save it with a filename. Thereafter, you can select this file
by entering the following command: LISTFILE ./@ ;SELEQ=^FILENAME |
The OBJECT
option applies to HFS files, and may have any one of the following
values. - ACCT
Lists only the MPE ACCOUNT
directory. You may use ACCTS,
ACCOUNT, ACCOUNTS
as synonyms for ACCOUNT. - GROUP
Lists only the MPE GROUP directory. You may use
GROUPS as a synonym
for GROUP. - FILE
Lists only the files and not directories/groups/accounts.
You may use FILES
as a synonym for FILE. - DIR
Lists only directories (including groups/accounts
and the system root directory /). You may use DIRS,
DIRECTORY, or
DIRECTORIES as
synonyms for DIRECTORY. - HFSDIR
Lists only directories other than root, accounts,
and groups. - SYMLINK
Lists onlyfiles that are symbolic links. - NUMBER
List only files matching the specified file code
number. - MNEMONIC
List only files matching the specified file code
mnemonic - PRIV
List only files with negative file code. - INUSE
Lists only files that are currently in use by users
or by MPE. - OPEN
Lists only files that are opened by progams. INUSE
is a superset of OPEN. - LOCK
List only files being locked by a program. - EXCL
List only files being closed exclusively
- pattern
When POSIX syntax is used in the fileset, pattern
is exactly the same as the filename components
of fileset as previously described. The
name parameter applies only to HFS syntax. The LISTFILE
command displays only those file names which match the pattern.
For example, displays all the files/groups/directories under the SYS
account that start with OFF,
off, Off,
and so on. If pattern is specified within
single or double quotes, it is case sensitive. For example, LISTFILE /SYS/;NAME=`OFF@' |
displays all the files/groups/directories under the SYS
account that start with OFF.
It will not display names that start with off,
Off, and so on.
The default for the pattern parameter
is @; that is,
it matches all names without regard to case. | | | |  | NOTE: You cannot use the NAME
parameter for an MPE fileset because
pattern can be specified as the part
of the fileset. So, for example, instead
of entering the command LISTFILE @.@.@;NAME=@DOC,
enter the command LISTFILE @DOC.@.@.
instead. | | | | |
- PASS
The PASS
option displays sensitive data. Using it depends on your access
rights to the data; that is if you are the owner or have AM or SM
capability. - PERM
The PERM
option displays permanent files only. "PERM'' is the default. - TEMP
The TEMP
option displays temporary files only. - PERMTEMP
The PERMTEMP
option displays both permanent and temporary files. The permanent
files are listed before the temporary files. - USENAME
The USENAME
option applies only to HFS-named filesets. This option indicates
that the name is to be used to determine how many levels to display.
If the fileset ends in a slash (/), then all files at all levels
below the target file are displayed. If the name does not end in
a slash (/), then only the files at the specified level are displayed.
For example, /@/@/@
indicates that all objects at the third level are to be displayed.
USENAME is the
default. - TREE
If the TREE
option is specified, objects at all lower directory levels are displayed. - NOTREE
Indicates that only objects at the specified level
are to be displayed. The NOTREE
option overrides an HFS fileset that ends in a slash.
Operation Notes | |
You can use LISTFILE
to list descriptions of one or more disk files at the level of detail
you select. You must have traverse directory entries (TD) and/or
read directory entries (RD) access for the directories in the pathname
of the files that will be displayed by LISTFILE.
(Refer to the ALTSEC
command for further information on directory permissions.) For example, if the fileset is
/dir1/dir@/@,
you must have TD access for the root directory (/) and dir1. Also,
you must have RD access for dir1
since the next name is wildcarded (dir@)
and have RD access to each directory within the path specified by
/dir1/dir@ since
the next (and final) name is a wildcard (@). You may list any file, but there are restrictions on the kinds
of information available to various users. A standard user may specify
a listlevel of 0, 1, 2, 3, 4, 5, 6 or
7. If you have account manager capability (AM), you may request
listlevel -1, -3 or -5, 8, 9 information
about files in your own account. If you have System Manager capability
(SM), you can specify any listlevel to
view all information for all files on the system. List levels 8
and 9 are also available if you are the owner of the files. A file
description is not listed unless the file's home volume set (PV)
is mounted. Use | |
This command may be issued from a session, a job, a program,
or in BREAK. Pressing Break aborts
execution. If the fileset is in MPE syntax,
LISTFILE only
displays file names that follow MPE naming syntax. For example,
LISTFILE @,2
will not display the file am_pm,
whereas LISTFILE ./@,2
will display the file. If fileset ends in a slash (/)
or the ;TREE
option, then the contents of every matching directory will be displayed
recursively. To see just a directory name, but not all the files
under it, use the ;NOTREE
option or omit the trailing slash. MPE Examples | |
LISTFILE @
FILENAME
FILE1
LISTFILE @.PUB.OFFICE,2
ACCOUNT= OFFICE GROUP= PUB
FILENAME CODE LOGICAL RECORD- SPACE
SIZE TYP EOF LIMIT R/B SECTORS #X MX
F4 80B AF 411 411 16 144 2 *
F5 80B AF 199 199 16 64 1 * |
HFS Examples | |
The following figure illustrates a hierarchical directory
structure. In this figure, directory names are shown as the character
d plus a number
(for example, d0),
and file names are shown as the character f
plus a number (for example, f1).
The examples assume the directory structure shown. They also assume
that the current working directory (CWD) is /ACCT/GROUP/d0. Example File System
/ACCT/GROUP/d0 = CWD
|
-|-
| | | | | |
d1 d2 d3 f1 f2 f3
| |
|- |
| | | | | | | | | | |
d4 f4 f5 d5 d6 f6 d7 f7 f8 f9 f10
| | | |
-| -| -| |-
| | | | | | | | | | | |
f11 f12 d8 f13 f14 f15 d9 f16 f17 f18 f19 f20
|
The first example below sets the `HPPROMPT'' variable to show
the current working directory, changes the CWD to d0,
and produces a listing of all files one level below the CWD. :hello manager.acct,group
:setvar hpprompt "hpcwd:"
/ACCT/GROUP:chdir ./d0
CWD is "/ACCT/GROUP/d0".
/ACCT/GROUP/d0:listfile ./@
PATH= /ACCT/GROUP/d0/
d1/ d2/ d3/ f1 f2 f3
|
The next example produces a listing of all files one level
below the CWD using FORMAT=2
(DISC) option. /ACCT/GROUP/d0:listfile ./@,2
PATH= /ACCT/GROUP/d0/./
CODE LOGICAL RECORD- SPACE FILENAME
SIZE TYP EOF LIMIT R/B SECTORS #X MX
16W HBD 4 67107839 1 64 2 * d1/
16W HBD 4 67107839 1 64 2 * d2/
16W HBD 4 67107839 1 64 2 * d3/
80B AF 12 12 1 16 1 1 f1
80B AF 12 12 1 16 1 1 f2
80B AF 12 12 1 16 1 1 f3 |
In the next example, specifying the absolute pathname produces
a listing of all entries one level below the group. /ACCT/GROUP/d0:listfile /ACCT/GROUP/@,2
PATH= /ACCT/GROUP/
CODE LOGICAL RECORD- SPACE FILENAME
SIZE TYP EOF LIMIT R/B SECTORS #X MX
16W HBD 4 67107839 1 64 2 * *d0/
|
In the next example, specifying the NAME
parameter produces a listing of all entries with names beginning
with a lower case "d". Using the FORMAT=6
(QUALIFY) option shows the absolute pathname of all HFS entries. /ACCT/GROUP/d0:listfile /;name=`d@';format=6
/ACCT/GROUP/d0/
/ACCT/GROUP/d0/d1/
/ACCT/GROUP/d0/d2/
/ACCT/GROUP/d0/d2/d4/
/ACCT/GROUP/d0/d2/d5/
/ACCT/GROUP/d0/d2/d5/d8/
/ACCT/GROUP/d0/d2/d6/
/ACCT/GROUP/d0/d3/
/ACCT/GROUP/d0/d3/d7/
/ACCT/GROUP/d0/d3/d7/d9/
|
The next example illustrates the use of the OBJECT=ACCT
parameter to show all accounts on the system. /ACCT/GROUP/d0:listfile /@,6; seleq=[object=acct]
/ACCT/
/SYS/
/TELESUP/
/TEST/
.
.
. |
The next example illustrates the OBJECT=GROUP
parameter to show all groups on the system. /ACCT/GROUP/d0:listfile /@/@;seleq=[object=group];format=qualify
/ACCT/GROUP/
/ACCT/PUB/
/SYS/ALINE925/
.
.
.
/TELESUP/PUB/
/TEST/PUB/
/TEST/SPOOL/
/TEST/SPOOLSTD/
/TEST/TEMPLATE/
/ACCT/GROUP/d0: |
The next example illustrates the use of the OBJECT=DIR
parameter to show all directories on the system. This is similar
to the FINDDIR
UDC.
/ACCT/GROUP/d0:listfile /, qualify;seleq=[object=dir];format=qualify
/
/ACCT/
/ACCT/GROUP/
/ACCT/GROUP/d0/
/ACCT/GROUP/d0/d1/
/ACCT/GROUP/d0/d2/
/ACCT/GROUP/d0/d2/d4/
/ACCT/GROUP/d0/d2/d5/
/ACCT/GROUP/d0/d2/d5/d8/
/ACCT/GROUP/d0/d2/d6/
/ACCT/GROUP/d0/d3/
/ACCT/GROUP/d0/d3/d7/
/ACCT/GROUP/d0/d3/d7/d9/
/ACCT/PUB/
/SYS/
/SYS/ALINE925/
/SYS/ALINK925/
.
.
.
/TELESUP/PUB/
/TEST/PUB/
/TEST/SPOOL/
/TEST/SPOOLSTD/
/TEST/TEMPLATE/
.
.
.
|
The next example illustrates a summary listing (format option
1) of all files in subdirectory d3. /ACCT/GROUP/d0:listfile d3/@,1
PATH= /ACCT/GROUP/d0/./d3/
CODE LOGICAL RECORD- FILENAME
SIZE TYP EOF LIMIT
16W DBH 4 67107839 d7/
80B AF 12 12 f10
80B AF 12 12 f7
80B AF 12 12 f8
80B AF 12 12 f9
|
The next example illustrates a detail listing (format option
3) of all files in subdirectory d3.
/ACCT/GROUP/d0:listfile ./d3/@,3
********************
FILE: /ACCT/GROUP/d0/d3/d7/
FILE CODE : 0 FOPTIONS: DIRECTORY
BLK FACTOR: 1 OWNER : **
REC SIZE: 32(BYTES) GROUP ID: **
BLK SIZE: 32(BYTES) SECURITYREAD :
EXT SIZE: 0(SECT) WRITE :
NUM REC: 4 APPEND :
NUM SEC: 64 LOCK :
NUM EXT: 2 EXECUTE :
MAX REC: 67107839 **SECURITY IS ON
FLAGS : NO ACCESSORS
NUM LABELS: 0 CREATED : TUE, JUL 21, 1992, 2:20 PM
MAX LABELS: 0 MODIFIED: TUE, JUL 21, 1992, 2:23 PM
DISC DEV #: 1 ACCESSED: WED, JUL 22, 1992, 12:05 PM
SEC OFFSET: 0 LABEL ADDR: **
VOLCLASS : MPEXL_SYSTEM_VOLUME_SET:DISC
********************
.
.
.
FILE: /ACCT/GROUP/d0/d3/f9
FILE CODE : 0 FOPTIONS: ASCII,FIXED,NOCCTL,STD
BLK FACTOR: 1 OWNER : **
REC SIZE: 80(BYTES) GROUP ID: **
BLK SIZE: 80(BYTES) SECURITYREAD :
EXT SIZE: 13(SECT) WRITE :
NUM REC: 12 APPEND :
NUM SEC: 16 LOCK :
NUM EXT: 1 EXECUTE :
MAX REC: 12 **SECURITY IS ON
MAX EXT: 1 FLAGS : NO ACCESSORS
NUM LABELS: 0 CREATED : TUE, JUL 21, 1992, 2:21 PM
MAX LABELS: 0 MODIFIED: TUE, JUL 21, 1992, 2:21 PM
DISC DEV #: 2 ACCESSED: TUE, JUL 21, 1992, 2:21 PM
SEC OFFSET: 0 LABEL ADDR: **
VOLCLASS : MPEXL_SYSTEM_VOLUME_SET:DISC
/ACCT/GROUP/d0:
|
The next example illustrates the use of the FORMAT=-3
option to show the owner. You must be the owner, or have AM or SM
capability to use this option.
/ACCT/GROUP/d0:listfile /ACCT/GROUP/@,-3
********************
FILE: /ACCT/GROUP/d0/
FILE CODE : 0 FOPTIONS: DIRECTORY
BLK FACTOR: 1 OWNER : MANAGER.ACCT
REC SIZE: 32(BYTES) GROUP ID: ACCT
BLK SIZE: 32(BYTES) SECURITYREAD :
EXT SIZE: 0(SECT) WRITE :
NUM REC: 4 APPEND :
NUM SEC: 64 LOCK :
NUM EXT: 2 EXECUTE :
MAX REC: 67107839 **SECURITY IS ON
FLAGS : 1 ACCESSOR,SHARED
NUM LABELS: 0 CREATED : TUE, JUL 21, 1992, 1:10 PM
MAX LABELS: 0 MODIFIED: TUE, JUL 21, 1992, 2:16 PM
DISC DEV #: 2 ACCESSED: WED, JUL 22, 1992, 11:40 AM
SEC OFFSET: 0 LABEL ADDR: $000000E1 $0009A220
VOLCLASS : MPEXL_SYSTEM_VOLUME_SET:DISC
/ACCT/GROUP/d0:
|
The next example illustrates the use of the FORMAT=4
(SECURITY) option to display the security matrix for all objects
one level below the group (in this case, d0). /ACCT/GROUP/d0:listfile /ACCT/GROUP/@,4
********************
FILE: /ACCT/GROUP/d0/
ACCOUNT READ :
WRITE :
APPEND :
LOCK :
EXECUTE :
GROUP READ :
WRITE :
APPEND :
LOCK :
EXECUTE :
SAVE :
FILE - READ : FCODE: 0
WRITE : **SECURITY IS ON
APPEND : ACD EXISTS
LOCK :
EXECUTE :
FOR MANAGER.ACCT: RACD, TD, RD, CD, DD |
The next example illustrates the use of the FORMAT=-2
(ACD) option to display the access contol definition (ACD) for file
f4 in subdirectory
d2. Note that
all users (@.@) have read ACD (RACD) access for this file.
/ACCT/GROUP/d0:listfile ./d2/f4,-2
PATH= /ACCT/GROUP/d0/d2/
-ACD ENTRIES- FILENAME
@.@ : RACD f4
/ACCT/GROUP/d0:
|
Related Information | |
- Commands
LISTF,
PLISTF (UDC),
LISTFTEMP, LISTSPF
(for spool files), FINDFILE
(UDC), FINDDIR
(UDC), LISTDIR
(UDC) - Manuals
None
|
