HP3000 Manuals

LISTF [ MPE/iX Commands Reference Manual Volume I ]

MPE/iX Commands Reference Manual Volume I

LISTF 

Displays information about one or more permanent files.  (CM)

Syntax 

LISTF [fileset][,listlevel][;listfile]

Parameters 

fileset               Specifies the set of files to be listed.  The
                      default is @, which lists all files in your logon
                      group.  You may select the file(s) to be listed by
                      using the fully or partly qualified form for
                      fileset:

                      filename.groupname.accountname 

                      You may use the @ to specify zero or more
                      alphanumeric characters or, if used by itself, to
                      denote all the members of a set.  You may use the
                      symbol # to specify one numeric character and the
                      symbol ?  to specify one alphanumeric character.
                      The # and ?  wildcard characters count toward the
                      eight character limit for group, account, and file
                      names.

listlevel             Specifies the amount and format of information to
                      display for the file(s) you select.  The default is
                      0, which displays only the file name.  The
                      listlevel of the LISTF command is equivalent to the
                      format option of the LISTFILE command.  The levels
                      are described below:

          Format Options 
---------------------------------------------------------------------------------------------
|                   |                                                                       |
|     Listlevel     |                         Displayed Information                         |
|                   |                                                                       |
---------------------------------------------------------------------------------------------
|                   |                                                                       |
|        -2         | 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 can view an ACD only if that ACD specifies that   |
|                   | the user has RACD (read ACD) access.                                  |
|                   |                                                                       |
---------------------------------------------------------------------------------------------
|                   |                                                                       |
|        -1         | Shows only the file label in hexadecimal.  The hexadecimal display    |
|                   | generated by this format option only serves a diagnostic purpose in   |
|                   | MPE/iX and is subject to change.                                      |
|                   |                                                                       |
---------------------------------------------------------------------------------------------
|                   |                                                                       |
|         0         | For each directory, this option displays PATH=The name of the file is |
|                   | displayed in a multicolumn format.  This is the default.              |
|                   |                                                                       |
---------------------------------------------------------------------------------------------
|                   |                                                                       |
|         1         | 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.                    |
|                   |                                                                       |
---------------------------------------------------------------------------------------------

          Format Options 

---------------------------------------------------------------------------------------------
|                   |                                                                       |
|     Listlevel     |                         Displayed Information                         |
|                   |                                                                       |
---------------------------------------------------------------------------------------------
|                   |                                                                       |
|         2         | 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.                                                      |
|                   |                                                                       |
---------------------------------------------------------------------------------------------
|                   |                                                                       |
|   3               | Displays the file name, record size, extent size, number of records,  |
|        -3         | user's access rights, 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 of the file |
|                   |        owner.                                                         |
|                   |                                                                       |
|                   |    *   For MPE groups, the SECURITY field displays SAVE; for entries  |
|                   |        other than MPE groups it is blank.  All file access matrix     |
|                   |        fields are blank for anything other than MPE accounts, MPE     |
|                   |        groups, and files in an MPE group.                             |
|                   |                                                                       |
|                   |    *   The LOCKWORD field is omitted.                                 |
|                   |                                                                       |
|                   | 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         | 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               | Shows LISTFILE,3 data and all file-specific data in LISTFILE,3 type   |
|        -5         | format (KSAM, SPOOL, and symbolic links).  If a file has no unique    |
|                   | data, only the option 3 data is shown.                                |
|                   |                                                                       |
---------------------------------------------------------------------------------------------
|                   |                                                                       |
|         6         | Shows the absolute pathname of the file.                              |
|                   |                                                                       |
---------------------------------------------------------------------------------------------
|                   |                                                                       |
|         7         | Shows all file specific data in LISTFILE,5 type format, but does not  |
|                   | show LISTFILE,3 data.  If a file has no unique data, only the file    |
|                   | name is displayed.  Default = 0 (FILES).                              |
|                   |                                                                       |
---------------------------------------------------------------------------------------------

listfile              The name of the output file to which the file
                      information will be written.  If you omit this
                      parameter, the output appears on $STDLIST. If you
                      specify listfile, the output is sent to a temporary
                      file created for this purpose.  The temporary file
                      is a new ASCII file with variable length records,
                      closed in the temporary domain, and with user
                      supplied carriage control characters (CCTL), OUT
                      access mode, and EXC (exclusive access) option.
                      All other characteristics are identical to the FILE
                      command default specifications.  You may specify a
                      different kind of file or backreference an existing
                      file.

                      When you direct LISTF output to $STDLIST from a
                      job, or when you direct the output to any non-disk
                      device, a date and time stamp preceeds the data,
                      and listlevel 0 data appears as one file per record
                      rather than in the standard multi-column format.

Operation 

The LISTF command displays a description of the file(s) you specified in
fileset.  It only accepts MPE file name syntax, but it displays
information in one of two formats, MPE or POSIX, depending upon whether
or not your current group differs from your logon group.  MPE format
examples appear below.  For examples of the POSIX format, see the
LISTFILE command.

You may list any file, but there are restrictions on the kinds of
information available to various users.  A standard user may specify a
listlevel of 0, 1, 2, 3, 4, 5, 6 or 7.  If you have account manager
capability (AM), you may request listlevel -1, -3 or -5 information about
files in your own account.  If you have System Manager capability (SM),
you can specify any listlevel to view all information for all files on
the system.

The LISTF command does not display #SEG, STACK, MAXDATA, TOTAL, DB, DL or
CAP values for program files.  That information is displayed by the
VERSION utility.  For more information, see the VERSION command.

You may have the information displayed on a device other than the
standard listing device.  To do that, you will need to name the device
with a FILE command and then backreference the file in the LISTF command.
For example:

     :FILE PRTR;DEV=LP 
     :LISTF @.@,2;*PRTR 

Use 

The LISTF command is available from a session, job, or a program, or in
BREAK. Pressing Break aborts the execution of this command.

Examples 

Level 0 File Display 

          :LISTF 

          FILENAME

          CLKLIST  CLOCK   EDIRC   LINKCLK   LINKFROG   LINKLIST

Level 1 File Display 

          : LISTF L@,1 

          ACCOUNT=  HPXLII          GROUP=    DEVELOP

          FILENAME  CODE    -------------LOGICAL RECORD----------

                              SIZE      TYP       EOF       LIMIT

          L2                   80B      FA          2          12
          LINKCLK              72B      FA          1          11
          LINKFROG             72B      FA          1          11
          LINKLIST             72B      FA          8          18

Level 2 File Display 

          :LISTF L@,2 

          ACCOUNT=  HPXLII          GROUP=    DEVELOP

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

                           SIZE  TYP      EOF     LIMIT R/B  SECTORS #X MX
          LINKCLK           72B   FA        1        11   3        8  1  1
          LINKFROG          72B   FA        1        11   3        8  1  1
          LINKLIST          72B   FA        8        18   3        8  1  1

Level 3 File Display 

          :LISTF DOCMNTS,3 

          ********************
          FILE DOCMNTS.DEVELOP.HPXLII

          FCODE O               FOPTIONS STD,ASCII,FIXED,NOCCTL
          BLK FACTOR 16         CREATOR  **
          REC SIZE 80(BYTES)    LOCKWORD **
          BLK SIZE 640(BYTES)   SECURITY--READ   : ANY
          EXT SIZE 25(SECT)               WRITE  : ANY
          NUM REC 501                     APPEND : ANY
          NUM SEC 165                     LOCK   : ANY
          NUM EXT 7                       EXECUTE: ANY
          MAX REC 501          **SECURITY IS ON
          MAX EXT 7            FLAGS n/a
          NUM LABELS 0         CREATED FRI, 21 SEP 1986, 11:55 AM
          MAX LABELS 0         MODIFIED FRI, 21 SEP 1986, 12:34 PM
          DISC DEV # 3         ACCESSED FRI, 21 SEP 1986, 12:46 PM
          CLASS     DISC       LABEL ADDR **
          SEC OFFSET 0

          VOLSET               MPEXL_SYSTEM_VOLUME_SET

          or

          VOLNAME              MPEXL_SYSTEM_VOLUME_SET: MEMBER1

          or

          VOLCLASS             MPEXL_SYSTEM_VOLUME_SET: DISC

          CLASS   : DISC       LABEL ADDR: $00000010  $0010E014

Level 6 File Display 

          :LISTF L@,6 

          LINKCLK.DEVELOP.HPXLII
          LINKFROG.DEVELOP.HLPXLII
          LINKLIST.DEVELOP.HPXLII

Level 7 File Display 

          ********************
          FILE:    LINKCLK.DEVELOP.HPXLII

          ********************
          FILE:    LINKFROG.DEVELOP.HLPXLII

          ********************
          FILE:    LINKLIST.DEVELOP.HPXLII

Level -2 File Display 

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

          DOCMNTS             NO ACDS

Level -3 File Display 

          :LISTF DOCMNTS,-3 

          ********************
          FILE DOCMNTS.DEVELOP.HPXLII

          FCODE O               FOPTIOc

          NS STD,ASCII,FIXED,NOCCTL              15496000
          BLK FACTOR 16         CREATOR PETE
          REC SIZE 80(BYTES)    LOCKWORD RETEP
          BLK SIZE 640(BYTES)   SECURITY--READ   : ANY
          EXT SIZE 25(SECT)               WRITE  : ANY
          NUM REC 501                     APPEND : ANY
          NUM SEC 165                     LOCK   : ANY
          NUM EXT 7                       EXECUTE: ANY
          MAX REC 501          **SECURITY IS ON
          MAX EXT 7            FLAGS n/a
          NUM LABELS 0         CREATED FRI, 21 SEP 1986, 1155 AM
          MAX LABELS 0         MODIFIED FRI, 21 SEP 1986, 1234 PM
          DISC DEV # 3         ACCESSED FRI, 21 SEP 1986, 12:46 PM
          CLASS     DISC       LABEL ADDR $00000010 $0010E014
          SEC OFFSET 0

Level 4 File Display 

          :LISTF DOCMNTS,4 

          ********************
          FILE DOCMNTS.DEVELOP.HPXLII

          SYSTEM    READ    : ANY
          SECURITY--WRITE   : AC
          (ACCT)   APPEND   : AC
          LOCK              : ANY
          EXECUTE           : ANY

          SYSTEM    READ    : GU
          SECURITY--WRITE   : GU
          (GROUP)  APPEND   : GU
          LOCK              : GU
          EXECUTE           : GU
          SAVE              : GU

          SECURITY--READ    : ANY          FCODE 0
          (FILE)   WRITE    : ANY          CREATOR PETE
          APPEND            : ANY          LOCKWORD
          LOCK              : ANY        **SECURITY IS ON
          EXECUTE           : ANY

          FOR PETE.HPXLII READ,WRITE,APPEND,LOCK,EXECUTE

Level -1 File Display 

          :LISTF LINKCLK,-1 

          F = LINKCLK

          00000001 44495343 20202020 20202020 20202020 20202020 .........@..LINK
          20202020 20202020 20202020 20310000 4C495354 53202020 DEVELOP       ...
          20202020 20202020 44455645 4C4F5020 20202020 20202020 HPXLII      .
          00000000 4850584C 49492020 20202020 20202020 00000000 ...PETE
          52455445 50202020 20202020 20202020 50455445 20202020 .|..,2....#.,7.6
          20202020 20202020 00000000 FC000000 04580001 13915EF4 ,2.|..#.,2.....#
          00010405 00000000 00000300 00020CEE 0EA78B32 00020CEE .......H........
          0EA78B32 00020CEE 12F61E2D 00020CEE 0EA78B32 00000000 ................
          000000A0 000001F5 00000000 00000000 00000000 00000000 ...........   ..
          00009C90 00000000 00000000 00000000 00000050 00000500 ................
          00100000 00190007 000F0000 20200000                   C.8x@.R.@.Q.......

Additional Information 

Commands      LISTFILE, VERSION, CHDIR

Manuals       Performing System Management Tasks (32650-90004)
              Performing System Operation Tasks (32650-90137)