LISTF


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.

10 Displays all of the same data as format 1, but with
wider column sizes for future expansion. A simple
indication of whether or not each file is currently
opened is given, along with the type of access,
Exclusive, Read, Write, or Store.

11 Displays all of the same data as format 2, but with
wider column sizes to allow for larger file sizes.
In addition, the disk space occupied by each file is
displayed in Kilobytes (KB) rather than in 256 byte sectors.

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, 9, 10, or 11.
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 10

ACCOUNT= SYS GROUP= TEST

Name Access FCode RecSiz Type EOF File Limit
-------- ERWS ----- ------ ----- ------------- -------------

SYSXTNTS 44 FB 11687 48806446
TESTF2 R 500 FA 1592197 10000000
TESTFILE W 50 FA 0 10000000


Level 11

ACCOUNT= SYS GROUP= TEST

Name Access FCode RecSiz Type EOF File Limit Disk Usage Exts
-------- ERWS ----- ------ ----- ------- ----------- --------KB -----

SYSXTNTS 44 FB 11687 48806446 1024 5
TESTF2 R 500 FA 1592197 10000000 777728 1382
TESTFILE W 50 FA 0 10000000 0 0


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, CHDIR

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