HP 3000 Manuals

LISTFILE [ HP 3000 Series 9X8LX Computer Systems Commands Reference ] MPE/iX 5.0 Documentation


HP 3000 Series 9X8LX Computer Systems Commands Reference

LISTFILE 

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   ] [[;NAME=] pattern] [;PASS]
                       [               ^indir]

[;{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,

                   LISTFILE @.@ 

              lists the files in all of the groups of the logon account;
              whereas:

                   LISTFILE @ 

              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,

                   LISTFILE ./@ 

              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,

                                 [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'.  [-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,

                   LISTFILE /SYS/@;TREE 

              behaves like:

                   LISTFILE /SYS/@/ 

              On the other hand, if you specifyNOTREE, the trailing
              slash, if present at the end of a fileset, is ignored.
              Hence,

                   LISTFILE /SYS/@/;NOTREE 

              behaves like:

                   LISTFILE /SYS/@ 

              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.

          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.                                    |
|          |                   |                                                              |
-----------------------------------------------------------------------------------------------

          Format Options 

-----------------------------------------------------------------------------------------------
|          |                   |                                                              |
|  Option  |       Name        |                    Displayed 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      | DETAIL;PASS       | Displays the file name, record size, extent size, number of  |
|    -3    | DETAIL            | 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) .                      |
|          |                   |                                                              |
-----------------------------------------------------------------------------------------------

          Table 2-2.  Format Options 

-----------------------------------------------------------------------------------------------
|          |                   |                                                              |
|  Option  |       Name        |                    Displayed Information                     |
|          |                   |                                                              |
-----------------------------------------------------------------------------------------------
|          |                   |                                                              |
|    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      | DATA;PASS         | Shows LISTFILE,3 data and all file-specific data in          |
|    -5    | DATA              | 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,

                                 LISTFILE /SYS/;NAME=OFF@ 

                            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.  The reason is that the
                                  pattern can be specified as the part of
                                  the fileset, for example, instead of
                                  entering:

                                       LISTFILE @.@.@;NAME=@DOC 

                                  you should enter:

                                       LISTFILE @DOC.@.@. 

                            ____________________________________________ 

              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-3  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-3  assume the
directory structure shown.  They also assume that the current working
directory (CWD) is /ACCT/GROUP/d0.
______________________________________________________________________________________
|                                                                                    |
|                                                                                    |
|                                    /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             |
|                                                                                    |
|                                                                                    |
|                                                                                    |
|                                                                                    |
______________________________________________________________________________________

          Figure 2-3.  Example File System 

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



MPE/iX 5.0 Documentation