HPlogo New Features of MPE/iX: Using the Hierarchical File System: 300 MPE/iX Computer Systems > Chapter 7 Managing Files

Listing Files

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Glossary

 » Index

You can use the LISTFILE command to list files named using MPE and HFS syntax. Because files named using HFS syntax can be long, the format used when listing these files with the ,2 and ,1 options shows the pathname as the last item on the line. Names are listed in alphabetical order.

The following examples illustrate using the LISTFILE command to list files using HFS syntax.

NOTE: You can also use the PLISTF system-provided UDC to list files using the same parameters as provided by the LISTFILE command. The system-provided UDCs must be cataloged to be available to you.

The following example lists all files and directories in the current working directory using the PLISTF UDC. The UDCs must be activated for you to use them. If you get a FILE NAME MISSING error message when you execute the following command, the UDCs are not available to you. Talk to your system manager about activating them.

   hello me.official,gp1

   plistf ./@



    PATH= /OFFICIAL/GP1/



    FILE1  dir2/ file1

Figure 7-1 “Example HFS File System” illustrates an example 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 7-1 “Example HFS File System” assume the directory structure shown. They also assume that the current working directory (CWD) is /ACCT/GROUP/d0.

Figure 7-1 Example HFS File System

[Example HFS File System]

In the first example, the HPPROMPT variable is set to show the current working directory, the user 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:

The next example also requests a listing of all files one level below the CWD using FORMAT=2 (DISC) option.

   /ACCT/GROUP/d0:listfile ./@,2

    PATH= /ACCT/GROUP/d0/



    CODE  ------------LOGICAL RECORD-----------  ----SPACE----

   FILENAME

            SIZE  TYP        EOF      LIMIT R/B  SECTORS #X MX



             16W  DBH          4   67107839   1       64  2  *  d1/

             16W  DBH          4   67107839   1       64  2  *  d2/

             16W  DBH          4   67107839   1       64  2  *  d3/

             80B  FA          12         12   1       16  1  1  f1

             80B  FA          12         12   1       16  1  1  f2

             80B  FA          12         12   1       16  1  1  f3

The next example, the user requests a listing of all entries one level below the group by specifying the absolute pathname.

   /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  DBH          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 a name 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

   /;name=@;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/

   [vellip]

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

   [vellip]

    /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  FA          12         12  f10

             80B  FA          12         12  f7

             80B  FA          12         12  f8

             80B  FA          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

    ********************

   &vellipsis;

    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. Notice that the owner is now displayed as a fully-qualified user name.

   listfile /ACCT/GROUP/@,-3



   /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, which implies that no one has any other access to the file.

    /ACCT/GROUP/d0:listfile ./d2/f4,-2

      PATH= /ACCT/GROUP/d0/d2/



      -----------ACD ENTRIES--------------- FILENAME



      @.@                : RACD             f4



    /ACCT/GROUP/d0: