HP 3000 Manuals

LISTF [ Native Mode Spooler Reference Manual ] MPE/iX 5.0 Documentation


Native Mode Spooler Reference Manual

LISTF 

Displays information about one or more permanent files.  LISTF does not
display file information for files residing in hierarchical directories.
To list such files, use the LISTFILE command.  Refer to MPE/iX Commands 
Reference Manual Volumes 1 and 2 (32650-90003 and 32650-90364) for more
information on listing hierarchical files. 

Syntax 

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

Parameters 

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

                           filename[.groupname[.accountname]]

                      Use the # symbol to specify a single numeric
                      character.  Use the ?  symbol to specify a single
                      alphanumeric character.  Use the @ symbol to
                      specify zero or more alphanumeric characters.  By
                      itself, @ represents all the members of a set.
                      Each of these wildcard characters counts toward the
                      eight-character limit for group, account, and file
                      names.

listlevel             Specifies the level (amount and format) of
                      information about the file(s) you select.  The
                      default is zero.

-3                    Displays the same information found with 3, plus
                      the lockword, creator, and label address.  For
                      program files the #SEG, STACK, MAXDATA, TOTAL, DB,
                      DL, and CAP values are omitted.  System manager
                      (SM) or account manager (AM) capability is required
                      to use this option.

-2                    Displays the file's access control definition
                      (ACD). 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                    Displays the hexadecimal listing of the file label,
                      including all lockwords.  This level is available
                      only to system managers and account managers.


NOTE The hexadecimal listing generated by a LISTF, -1 serves only a diagnostic purpose in MPE/iX and is subject to change.
0 Displays only the file name. 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, current end-of-file location, and the maximum number of records allowed in the file. 2 Displays the file name, file code, record size, record format, and other file characteristics such as ASCII or binary records, carriage-control option, 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. LISTF, 2 also displays KSAMXL file types with "K". 3 Displays the file name, record size, extent size, number of records, access rights for the user, and other file characteristics including the date created, modified, and last accessed. The creator, lockword, and label address are omitted. These can be obtained by specifying -3 if you have AM capability (for files in your account) or SM capability (for any file on the system). 4 Displays the security matrix for the file. This includes account, group and file-level security and the access rights for the user. If an access control definition (ACD) exists, a message stating that fact is displayed. 6 Displays the fully qualified file name.


MPE/iX 5.0 Documentation