LISTF

Generated from C.60.01 /SYS/PUB/CICAT last modified on Thu Jan 11 09:18:52 2001

Back to Main Index


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:

---------------------------------------------------------------------
 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 the file label in hexadecimal and ASCII.

    0               Displays the name(s) of the file(s) 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.

    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,-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, group id (for POSIX files)
                    and label address are omitted in listlevel 3.  To
                    see this information, you must specify -3 and have
                    sufficient capability (AM for files in your own
                    account or SM, for all files).

    4               Displays the security matrix for the file. This
                    includes account, group and file-level security,
                    and the access rights for the user.  This level
                    also indicates if a file is released or if it is
                    assigned an ACD.

  5,-5              Displays listlevel 3 data and all file-specific
                    data for KSAM files, spoolfiles, and symbolic
                    links.  If the file has no unique data, only
                    the level 3 data is shown.

    6               Shows the fully qualified name of the file.

    7               Shows all file specific data in listlevel 5 format,
                    but omits level 3 data.  If the file has no unique
                    data, only the file name is displayed.

    8               Displays accessors of the file.For each accessor the
                    following information is shown: job/session ID, user
                    and account name, number of processes accessing the
                    file, number of processes with the file locked,
                    number of writers, number of readers, LDEV number
                    for local session accessors or spool file ID for
                    local job accessors or IP address.

                    There is a summary header visible to all users;
                    however you need special privileges to see
                    individual accessor information. SM and OP users
                    get to see everything mentioned above. This is also
                    true for all AM users for files where the files GID
                    matches the user's GID (also known as "GID Manager")
                    Last, the file's owner/creator is able to see all
                    accessors. There is an additional restriction on the
                    IP address field: you must posses one of SM, OP, NM,
                    NA, or PM capability.


    9               Displays all of the format 8 data plus the following
                    Process ID Number (PIN), accessing program name,
                    access method (read, write, execute, etc.), access
                    share mode (multi, gmulti, etc.) current record
                    number being accessed, file number, semaphores
                    (locks) owned, shared or blocked on by the accessing
                    process. The locks examined are the FLOCK semaphore,
                    the OPEN semaphore and the GUFD semaphore.

                    The same restrictions outlined for format 8 apply to
                    format 9. Additionally,the accessing program name is
                    a sensitive field, thus the same rules enforced by
                    the SHOWPROC command apply. You may see the process
                    (program) name if: the process is within your
                    job/session, or the process logged on as the same
                    user.account as you and
                    JOBSECURITY is LOW, or you have SM or OP
                    capabilities.

listfile            The name of the output file on which the file
                    descriptions are to 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 precedes 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. The LISTF command 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 working directory
     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, 7, 8 or 9.  If you have
     account manager capability (AM), you may request level -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

         or

     LISTF @.@,2 >*prtr

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


EXAMPLE(S)


Level 0

     LISTF

     FILENAME

     CLKLIST  CLOCK   EDIRC   LINKCLK   LINKFROG   LINKLIST

Level 1

     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

     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

     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

     LISTF L@,6

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

Level 7

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

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

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


Level 8

LISTF hppxudc.pub.sys,8

********************
FILE: HPPXUDC.PUB.SYS
15 Accessors(O:15,P:15,L:0,W:0,R:15),Share
#S265   MIKEP.HPE                P:2,L:0,W:0,R:2      LDEV: 49
#S263   JEFFV,MGR.JVNM           P:3,L:0,W:0,R:3      LDEV: 47
#S261   KROGERS.MPENT            P:2,L:0,W:0,R:2      LDEV: 50
#S231   SUSANC.MPENT             P:2,L:0,W:0,R:2      LDEV: 46
#S219   FAIRCHLD.MPENT           P:2,L:0,W:0,R:2      LDEV: 39
#S214   CATHY,MGR.BOSS           P:2,L:0,W:0,R:2      REM : 15.14.16.198
#J434   FTPMON,FTP.SYS           P:2,L:0,W:0,R:2      SPID: #O21905


Level 9

LISTF hppxudc.pub.sys,9

********************
FILE: HPPXUDC.PUB.SYS
#S263   JEFFV,MGR.JVNM             P:3,L:3,W:0,R:3      LDEV: 47
 #P147   (LFCI.PUB.SYS)
   ACCESS: R-excl            REC#: 0                    FNUM: 13
    LOCKS--Owner--   --Waiter--
         FLOCK
         OPEN
 #P154   (CI.PUB.SYS)
   ACCESS: R-excl            REC#: 0                    FNUM: 13
    LOCKS: none
 #P86    (JSMAIN.PUB.SYS)
   ACCESS: R-excl            REC#: 336                  FNUM: 16
    LOCKS--Owner--   --Waiter--

#J434   FTPMON,FTP.SYS             P:2,L:2,W:0,R:2      SPID: #O21905
 #P79    (CI.PUB.SYS)
   ACCESS: R-excl            REC#: 0                    FNUM: 14


Level -2

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

DOCMNTS             NO ACDS


Level -3

     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

NOTE


Fields containing "n/a" are not implemented.

Level 4

     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

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)

Back to Main Index