 |
» |
|
|
|
Lists file information. The LISTFILE command displays file information for files residing in hierarchical directories. For more information about the LISTFILE command, refer to MPE/iX Commands Reference Manual Volumes 1 and 2 (32650-60115) | | | |  | NOTE: Spool files, which reside in IN.HPSPOOL or in OUT.HPSPOOL, are named according to MPE conventions and appear in a hierarchical listing only to the extent that all MPE files do so. | | | | |
Syntax | |
LISTFILE [fileset
(fileset[,fileset ][,...])]
[[;FORMAT=]format_opt][ [;SELEQ=]select_eq]
[;PASS][;{PERM
TEMP
PERMTEMP}] [;USENAME
;TREE
;NOTREE]
|
Parameters | |
- fileset
Specifies the set of files to be listed. If fileset does not begin with a dot or a slash, it is parsed according to the MPE syntax and has the form:
filename[.groupname[.accountname] ]
|
If fileset begins with a dot (.) or a slash (/), it is parsed according to the Hierarchical File Syntax (HFS). Refer to MPE/iX Commands Reference Manual Volumes 1 and 2 (32650-60115). Wildcards may be used. Patterns are the same as those for LISTF and SHOWVAR. "[a-dq]#x" means search for all of files beginnning with a, b, c, d, or q followed by any number followed by x. Default is @. - format_opt
A format selection. This parameter has no effect on the files selected for display. The following numbers/mnemonics are recognized: Table 4-1 Format Selection | Option | Name | Displayed Information |
|---|
| -3 | (DETAIL) | Shows LISTF, 3 data plus the lockword, creator, and label address. AM or SM capability required.
| | -2 | ACD | Shows only the access control definition (ACD) . | | -1 | LABEL | Shows only the file label in hex. | | 0 | FILES | Shows only the file name. | | 1 | SUMMARY | Shows LISTF,1 data. | | 2 | DISC | Shows LISTF,2 data. | | 3 | DETAIL | Shows LISTF,3 data. | | 4 | SECURITY | Shows LISTF,4 data. | | 5 | DATA | Shows LISTF,3 data and all file specific data in LISTF, 3 type format (KSAM and SPOOL). | | 6 | QUALIFY | Shows only fully qualified file name. | | 7 | UNIQUE | Shows all file-specific data in LISTF,3 type format, but does not show LISTF,3 data. |
Format options 5 and 7 are "data driven" outputs that show file specific information such as KSAM keys, or target print devices. When you use option 5 and a file has no unique data, only the LISTF,3 data is shown. When you use option 7 and a file has no unique data, only the file name is displayed. Default = 0. - select_eq
A selection equation. Use the selection equation to filter the fileset. From the set of files matching the file set, only files that match the filter requirements are listed. Valid selection equations may only select on file types by using the FTYPE parameter and may only use the "=" operator. Selection equations have the following format:
select_eq ::= [FTYPE = mnemonic]
mnemonic ::= {KSAMXL
SPOOL }
|
Selection equations must be surrounded by square brackets. - PASS
An option that is used to refer to sensitive data. The use of this option depends on your access rights to the data. - PERM
An option that is used to display permanent files only. This is the default. - TEMP
An option that is used to display temporary files only. - PERMTEMP
An option that is used to display both permanent and temporary files. Temporary files are listed after the permanent files. - USENAME
Applies only to Hierarchical File Syntax (HFS) named files. 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 seleq) are to be displayed. If the name does not end in a slash, the only the objects at the specified level are displayed. For example, /@/@/@ indicates that all objects at the third level are to be displayed. This is the default Refer to MPE/iX Commands Reference Manual Volumes 1 and 2 (32650-60115) for more information on listing hierarchical files. - TREE
If TREE is specified, objects at all lower directory levels are displayed. This is the only way to have all levels displayed if the fileset is in MPE syntax. - NOTREE
If NOTREE is specified, only objects at the specified level are to be displayed. NOTREE overrides an HFS fileset that ends in a slash. Refer to MPE/iX Commands Reference Manual Volumes 1 and 2 (32650-60115) for more information on listing hierarchical files.
Operation notes | |
The LISTFILE command is a functional superset of the LISTF and LISTTEMP commands. Unlike the LISTF command, the LISTFILE command supports standard native mode scanning/parsing that can be easily expanded. Instead of using difficult to remember numbers, mnemonic keywords and options are supported. This command lists descriptions of one or more disk files at the level of detail that 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. If you are a standard user, you may list any level of information on files that you create, but you may not use the ;PASS options on files that you do not own. If you have AM capability, you may use the ;PASS options for any file within the account. If you have SM capability, you may use the ;PASS options for any file on the system. 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 or a job, in program, or in BREAK. It is breakable. (You may abort its execution.) If the fileset is in MPE syntax, LISTFILE will not display any directories, or any files that do not follow MPE naming syntax (LISTFILE @,2, for example) will not display the file "am_pm" created by some HFS application; however, LISTFILE ./@,2 will. Refer to MPE/iX Commands Reference Manual Volumes 1 and 2 (32650-60115) for more information on listing hierarchical files. If the fileset is in HFS syntax and it ends in a slash (or you specify the TREE option), all the nodes (files and directories) are found that match the fileset parameter (horizontal cut). The domain of further traversal is limited to the sub-trees root at these nodes. Those files that match the pattern of pattern are the ones that are finally displayed using the format_opt specified. If the HFS syntax fileset does not end in slash (or you specify the NOTREE option), 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 cases, a final filter of SELEQ is applied, if it is present, to further restrict the files/directories to be displayed. Example 1 | |
LISTFILE SPRLRFMT, 5
********************
FILE: SPLRFMT.SPLR.DEV
FILE CODE: 1516 FOPTIONS: ASCII,VARIABLE,NOCCTL,SPOOL
BLK FACTOR: 1 CREATOR : **
REC SIZE: 1008 (BYTES) LOCKWORD: **
BLK SIZE: 1024 (BYTES) SECURITY--READ : ANY
EXT SIZE: 39 (SECT) WRITE : ANY
NUM REC: 38 APPEND : ANY
NUM SEC: 16 LOCK : ANY
NUM EXT: 1 EXECUTE : ANY
MAX REC: 38 **SECURITY IS ON
MAX EXT: 1 FLAGS : NO ACCESSORS
NUM LABELS: 0 CREATED : THU, JAN 26, 2989, 3:35 PM
MAX LABELS: 0 MODIFIED: THU, JAN 26, 2989, 3:35 PM
DISC DEV #: 17 ACCESSED: TUE, MAR 14, 1989, 9:09 AM
CLASS : DISC LABEL ADDR: **
SEC OFFSET: 0
TARGET DEVICE : 6
|
Example 2 | |
LISTFILE SPLRFMT, 7
********************
FILE: SPLRFMT.SPLR.DEV
TARGET DEVICE : 6
|
|
