 |
» |
|
|
|
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 in Table 4-5 “Format Options”:
Table 4-5 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. | | 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, 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
-5 | Shows LISTFILE,3
data and all file-specific data in LISTFILE,3
type 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. | | 8 | Shows all accessors of the files
listed. Restrictions apply | | 9 | Shows level 8 information and details about
processes accessing the files including file locking data. Restrictions
apply. |
- 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, 8, 9 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. List levels 8
and 9 are also available if you are the owner of the files. For list levels 8 and 9 the IP address of remote accessors
and the program name of the accessor process are restricted fields.
PM, SM, OP, NA, or NM capabilities are needed to see the IP address.
The rules defined by the SHOWPROC command
are enforced before revealing the process name. 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) SECURITYREAD : 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 8 File Display :listfile 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 File Display :listfile hppxudc.pub.sys,9
********************
FILE: HPPXUDC.PUB.SYS
5 Accessors(O:5,P:5,L:5,W:0,R:5),Share
#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
LOCKSOwner 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
LOCKSOwner Waiter
FLOCK
#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
LOCKS: none
#P47 (JSMAIN.PUB.SYS)
ACCESS: R-excl REC#: 336 FNUM: 15
LOCKSOwner Waiter
OPEN FLOCK |
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) SECURITYREAD : 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
SECURITYWRITE : AC
(ACCT) APPEND : AC
LOCK : ANY
EXECUTE : ANY
SYSTEM READ : GU
SECURITYWRITE : GU
(GROUP) APPEND : GU
LOCK : GU
EXECUTE : GU
SAVE : GU
SECURITYREAD : 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
, LISTDIR (UDC) FINDFILE (UDC) - Manuals
Performing System Management Tasks Performing System Operation Tasks
|
