HP 3000 Manuals HP 3000 Manuals
LISTFTEMP
Displays information about one or more temporary files.
Syntax
LISTFTEMP [fileset][,listlevel][;listfile]
Parameters
fileset Specifies the set of temporary files to be listed.
The default is @, producing a listing of all
temporary files. You may select the temporary
file(s) to be listed by using the fully 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 one or more alphanumeric characters. By
itself, @ represents all the members of a set.
Refer to appendix G for examples of using wildcard
characters.
listlevel Specifies the level (amount and format) of
information about the temporary file(s) you select.
The default is zero.
The following table displays the listlevel options
available.
List Options
--------------------------------------------------------------------------------------------
| | |
| Option | 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. |
| | |
--------------------------------------------------------------------------------------------
List Options
--------------------------------------------------------------------------------------------
| | |
| Option | Displayed Information |
| | |
--------------------------------------------------------------------------------------------
| | |
| 3 | Displays the file name, record size, extent size, number of records, user's |
| -3 | 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 (user.acct) 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 | Shows LISTFILE,3 data and all file-specific data in LISTFILE,3 type format |
| -5 | (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. Default = 0 (FILES). |
| | |
--------------------------------------------------------------------------------------------
SECTORS The number of sectors allocated for the file on
disk. This number is always 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. This number is displayed only
to maintain compatibility with MPE V/E. This value
does not indicate the size of the file. 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. This number is
displayed only to maintain compatibility with MPE
V/E. If the value is greater than 32 (the limit on
MPE V/E), then * is displayed.
listfile The name of the output file. The default is
$STDLIST. If you specify listfile, it is
automatically created 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 Notes
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.
Use
This command is available from a session, job, program, or in BREAK.
Pressing Break aborts the execution of this command.
Examples
The following examples show the output displayed for the various levels
of the LISTFTEMP command:
The next example shows "Level 0" output.
LISTFTEMP
TEMPORARY FILES FOR PETE.HPXLII,DEVELOP
LINKCLK.DEVELOP.HPXLII
The next example shows "Level 1" output.
LISTFTEMP ,1
TEMPORARY FILES FOR PETE.HPXLII,DEVELOP
ACCOUNT= HPXLII GROUP= DEVELOP
FILENAME CODE ------------LOGICAL RECORD------
SIZE TYP EOF LIMIT
LINKCLK 128W FB 0 1023 (TEMP)
The next example shows "Level 2" output.
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
LINKCLK 128W FB 0 1023 1 128 1 8 (TEMP)
The next example shows "Level 3" output. Fields containing "n/a" are not
implemented.
LISTFTEMP ,3
********************
FILE: LINKCLK.DEVELOP.HPXLII
FCODE: O FOPTIONS: ASCII,FIXED,NOCCTL,STD
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 RED: 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
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
The next example shows "Level -1" output.
LISTFTEMP LINKCLK,-1
F = LINKCLK
00000000 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 02020000 C.8x@.R.@.Q.....
Related Information
Commands LISTF, LISTFILE, SAVE
Manuals None