 |
» |
|
|
|
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]...)} ]
|
where option is:
[ [;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 @. The fileset parameter can be either in MPE or HFS syntax. MPE Syntax (MPE Groups containing only MPE files) 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] ]
|
Wildcards may be used with the MPE syntax. Patterns are the same as for SHOWVAR. "[a-dq]#x" means search for all files beginning with a, b, c, d, or q followed by one digit (any digit from 0 - 9), followed by x. A LISTFILE command using MPE syntax does not display MPE 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, lists the files in all of the groups of the logon account; whereas: 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 the new format as discussed below. MPE Syntax (MPE Groups containing HFS files) You may have an MPE group that also contains files with HFS syntax, for
example, they begin with a dot (.), a slash (/), or an underscore (_). To see both MPE and
HFS files in a
group, type,
This displays all file names with upper and lower case letters that reside under the current group and account. In a directory, file names can consist of
1 to 255 characters, but in a group, file names cannot have more than
16 characters. HFS Syntax If the fileset begins with a dot (.) or a slash (/), it is parsed according to the HFS syntax. In this case,
the fileset parameter that you type at the command line (including
command name, keywords and options) can have, at most,
511 characters. It has an optional beginning slash followed by zero or more names separated by slashes. 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 - _ .
|
The file names cannot begin with a hyphen (-). The following wildcards may also be used: - @
matches 0 to 255 characters
- ?
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, 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'. [-a-c] or
[a-c-] means one of `a', `b', `c', or `-'.
Note that 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.
The file names dot (.) and dot-dot (..) have special meaning, that is, current directory and the parent of the current directory, respectively.
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. In this case @ is assumed for pattern.
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 and subdirectories in the SYS directory, but not
any files or directories within those subdirectories.
If you have specified TREE, a trailing slash is assumed at the end of the fileset (if not present).
For example, behaves like:
On the other hand, if you specifyNOTREE, the
trailing slash, if present at the end of a fileset, is ignored. Hence, behaves like: In the above examples, it is assumed that name=@. - 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 (/),
and the CWD is different than the directory, then
one of the following occurs: For MPE accounts, MPE groups, and HFS directories, the filename ends in a slash.
The information about each file begins at column 2 (after 1 space). If the file name or pathname is long and the information cannot fit on one record of the output file, it continues from column 1 of the next record.
MPE accounts, MPE groups, and HFS directories have file labels associated with them just like files; hence, LISTFILE, 2 and LISTFILE, 3, and so on, display relevant information for them. For accounts, groups, and directories, however, some of the information (like eof) is not maintained (it is 0).
The following table displays the format options available. Table 2-2 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 canview an ACD only if that ACD specifies that the user has RACD (read ACD) access.
For each directory, it displays
PATH=absolute directory
name ending in a slash. Next, for each HFS file within the
directory, it displays the same information as MPE, except that it
displays the file name (at most 255 characters) at the end of all other information. | | -1 | LABEL | Shows only the file label in hexadecimal. | | 0 | FILES | For each directory, this option displays
PATH=absolute directory name ending in a slash. Next, for
each HFS file within the directory, it shows only the file name. This
is the default. For each file, the name of the file (at most 255 characters) is displayed in a multicolumn format. | | 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. For each directory, it displays PATH=absolute directory name ending in a slash. For each HFS file within the directory, it displays the same information as MPE, except that it displays the file name (at most 255 characters) at the end of all other information. | | 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. For each directory, it displays PATH=absolute directory name ending in a slash. For each HFS file within the directory, it displays the same information as MPE except that it displays the file name (at most 255 characters) at the end of all other information. | | 3
-3
| DETAIL;PASS
DETAIL
| Displays the file name, record size,
extent size, number of records, access rights for the user, 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.
The SECURITY field contains an additional field SAVE for MPE group entries. It is blank for entries other than MPE groups.
All file access matrix fields are blank for anything other than MPE account, MPE group, and a file in an MPE group.
The LOCKWORD field is omitted from the display.
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: | | 5
-5 | DATA;PASS
DATA | Shows LISTFILE,3 data and all file-specific data in LISTFILE,3 type format (that is, KSAM, SPOOL, and symbolic links). | | 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 (the file name is shown). |
Format options 5 and 7 are "data driven" outputs that show file
specific information such as KSAM keys, spooled device or symbolic links. When you use option 5 and a file has no unique data, only the option 3 data is shown. When you use option 7 and a file has no unique data, only the file name is displayed. Default = 0 (FILES). - 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]
|
Selection equations must be surrounded by 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:
LISTFILE ./@ ;SELEQ=^FILENAME
|
In the above example, the filename represents [OBJECT=DIR]. The OBJECT option applies to HFS files, and may have any one of the following values. - ACCT
Lists only the MPE ACCOUNT directory.
- GROUP
Lists only the MPE GROUP directory.
- FILE
Lists only the files and not directories/groups/accounts.
- DIR
Lists only directories (including groups/accounts and the system root directory /).
Synonyms may be used for these values as shown in the following table. | Value | Synonyms |
|---|
| ACCT | ACCTS, ACCOUNT, ACCOUNTS | | GROUP | GROUPS | | FILE | FILES | | DIR | DIRS, DIRECTORY, DIRECTORIES
|
The OBJECT option cannot be used for an MPE fileset. (The LISTFILE command displays only files for the MPE filesets.)
- 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. - 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 the lower level objects (based on select_eq) are to be displayed. If the name does not end in a slash (/), then only the objects 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 (TD) entries and/or read directory
(RD) entries 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@/@ and NAME=@, you must have TD access for the CWD. Also, you must have TD and/or RD access for dir1 and any directories in dir1 that match the pattern dir@.
You do not need TD access on the directories in dir1 to display
the names of the files, that is, if you use format options 0 or 6. For format options -1, -2, -3, and -5, you must have either SM or AM capability for the file.
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 mode. Pressing Break aborts execution. If the fileset is in MPE syntax, LISTFILE does not display
file names that do not follow MPE naming syntax. For example, LISTFILE @,2 will not display the file am_pm, LISTFILE ./@,2 will display the file. If the fileset is in HFS syntax, and it ends in a slash (or the TREE option is specified), first all the nodes (files and directories) are displayed that match the fileset parameter (horizontal cut).
Those files that match the pattern of pattern are the ones that are displayed using the format_opt specified. If the HFS syntax fileset does not end in a slash (or the NOTREE option is specified), all the nodes (files and directories) that match the pattern of fileset (horizontal cut) and the pattern of pattern are displayed using the format_opt specified. In both the above cases, a final filter of SELEQ is applied, if present, to further restrict the names to be displayed. 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 | |
Figure 2-5 “Example File System” 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 following Figure 2-5 “Example File System” assume the directory structure shown. They also assume that the current working directory (CWD) is /ACCT/GROUP/d0.
Figure 2-5 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
|
In this first example, the HPPROMPT variable has been set to show the current working directory, changes directories using the CHDIR command, and requests 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
/ACCT/GROUP/d0:
|
In the next example, a listing of all files one level below the CWD using FORMAT=2 (DISC) option has been requested. Note that for each directory entry, the absolute directory name ending in a slash, is shown.
/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, a listing of all entries one level below the group by specifying the absolute pathname has been requested.
/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/
/ACCT/GROUP/d0:
|
In the next example, the user specifies the NAME parameter to request
a listing of all entries with names beginning with a lower case "d". The FORMAT=6 (QUALIFY) option is used to show 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 /@; seleq=[object=acct];format=6
/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.
/ACCT/GROUP/d0:listfile /;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/
/ACCT/GROUP/d0:
|
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 HBD 4 67107839 d7/
80B AF 12 12 f10
80B AF 12 12 f7
80B AF 12 12 f8
80B AF 12 12 f9
/ACCT/GROUP/d0:
|
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) SECURITY--READ :
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) SECURITY--READ :
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) SECURITY--READ :
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
/ACCT/GROUP/d0:
|
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 Commands | |
LISTF
LISTF (UDC)
LISTFTEMP
|
|
