LISTFTEMP


LISTFTEMP

     Displays the description of one or more temporary files.  (CM)

SYNTAX


LISTFTEMP [fileset][,listlevel][;listfile]


PARAMETERS


fileset The set of temporary files you want to list.
The default is @, which produces a list of all
temporary files. You may list specific temporary
file(s) by using the fully qualified form for
fileset.

filename[.groupname[.accountname]]

You may use the symbol "#" to specify a single
numeric character, the symbol "?" to specify a
single alphanumeric character, and the symbol "@"
to specify one or more alphanumeric characters.
By itself, "@" represents all members of a set.

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

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, 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 characterists, 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 blockingfactor, number of sectors
in use, number of extents currently
allocated, and the maximum number of
extents allowed.

3 Displays the information found with
level -1, but omit the creator,
lockword, and label address.
The display is formatted.

-1 Displays the hexadecimal listing of
the file label(s). This level is
available only to system managers
and account managers. Level -1 serves
a diagnostic purpose only in MPE/iX
and is subject to change.

-3 Display the same information found
with 3, but displays the lockword,
label address, and creator as well.
You must have System Manager (SM) or
account manager (AM) capability to
use this option.

4 Displays the security matrix for the
file, which includes account, group
and file-level security, and the
access rights for the user.

For MPE groups and 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 DATA;PASS
-5 DATA Shows LISTFILE,3 data and all file-
specific data in LISTFILE, 3 type
format (that is, KSAM and SPOOL).
If the file has no unique data, only
the option 3 data is shown.

6 QUALIFY Shows the fully qualified (absolute
pathname) of the file.

7 UNIQUE Shows all file specific data in
LISTFILE,5 type format, but does
not show LISTFILE,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,alongwith
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.

SECTORS The number of sectors allocated for the file on
disk. This number will always be a multiple of
16 (the page size in MPE/iX). This value is an
indication of the size of the file.

#X Number of Extents, displayed only to maintain
compatibility with MPE V. This value does NOT
indicate the size of the file (unlike MPE V).
The variable-extent structure of MPE/iX permits a
file to have a variable number of extents, all of
variable size.

MX Maximum Number of Extents, displayed only to
maintain compatibility with MPE V. If the value
is greater than the MPE limit of 32, then "*" is
displayed.

listfile The name of the output file on which the file
descriptions are to be written. The default is
$STDLIST. If listfile is specified, it is created
automatically as 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 the same as
they would be with the FILE command default
specifications.


OPERATION

     This command lists descriptions of one or more temporary files
at the level you specify. You may list any file, but, based on
your capabilities, there are restrictions on the kind of
information that is available to you.

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

Below is an example of "Level 0" output.

LISTFTEMP

TEMPORARY FILES FOR PETE.HPXLII,DEVELOP

FOO.DEVELOP.HPXLII

Level 1
LISTFTEMP,1 TEMPORARY FILES FOR PETE.HPXLII,DEVELOP&
ACCOUNT=HPXLII GROUP=
DEVELOP FILENAME CODE   -------------LOGICAL RECORD---------- SIZE  TYP
EOF LIMIT FOO 128W FB 0 1023 (TEMP)
Level 2

LISTFTEMP ,2

TEMPORARY FILES FOR PETE.HPXLII,DEVELOP

ACCOUNT= HPXLII GROUP= DEVELOP

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

SIZE TYP EOF LIMIT R/B SECTORS #X MX
FOO 128W FB 0 1023 1 128 1 8 (TEMP)

Below is an example of "Level 3" output. Fields containing "n/a"
are not implemented.


LISTFTEMP ,3

********************

FILE FOO.DEVELOP.HPXLII

FCODE O FOPTIONS BINARY,FIXED,NOCCTL,STD
BLK FACTOR 1 CREATOR **
REC SIZE 256 (BYTES) LOCKWORD **
BLK SIZE 256 (BYTES) SECURITY--READ : ANY
EXT SIZE 0 (SECT) WRITE : ANY
NUM REC 0 APPEND : ANY
NUM SEC 0 LOCK : ANY
NUM EXT 0 EXECUTE : ANY
MAX REC 1023 **SECURITY IS ON

FLAGS : NO ACCESSORS
NUM LABELS: 0 CREATED : FRI, 21 SEP 1991, 11:55 AM
MAX LABELS: 0 MODIFIED: FRI, 21 SEP 1991, 12:34 PM
DISC DEV #: 1 ACCESSED: FRI, 21 SEP 1991, 12:46 PM
SEC OFFSET: 0 LABEL ADDR **
VOLSET : MPEXL_SYSTEM_VOLUME_SET


Below is an example of "Level -3" output. Fields containing "n/a"
are not implemented.


LISTFTEMP ,-3

********************

FILE FOO.DEVELOP.HPXLII

FCODE O FOPTIONS STD,ASCII,FIXED,NOCCTL
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

Below is an example of "Level -1" output.

LISTFTEMP 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.......

Commands: LISTF, LISTFILE