HP 3000 Manuals HP 3000 Manuals
LISTFILE 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-90003 and 32650-90364)
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 ] [[;FORMAT=] format_opt] [(fileset [,fileset][,...])] [ {PERM }] [;USENAME] [[;SELEQ=] select_eq] [;PASS] [;{TEMP }] [;TREE ] [ {PERMTEMP}] [;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] ] [REV BEG] 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-90003 and 32650-90364).[REV END] 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: 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-90003 and 32650-90364) for more information on listing hierarchical files. TREE [REV BEG] 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.[REV END] 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-90003 and 32650-90364) 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.) [REV BEG] 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-90003 and 32650-90364) for more information on listing hierarchical files.[REV END] [REV BEG] 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.[REV END] 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. [REV BEG] In both cases, a final filter of SELEQ is applied, if it is present, to further restrict the files/directories to be displayed.[REV END] 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 More examples The following are more LISTFILE examples: listfile x@,data,[ftype=spool] listfile [a-f]#[g-z@],3;seleq=[ftype=spool]
NOTE For examples of LISTFILE displays with HFS files. Refer to MPE/iX Commands Reference Manual Volumes 1 and 2 (32650-90003 and 32650-90364).