HPlogo MPE/iX Commands Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 5 Command Definitions L-O

LISTFTEMP

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

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 5-2 “List Options” displays the listlevel options available.

Table 5-2 List Options

OptionDisplayed Information
-2Displays 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.
-1Shows 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.
0For each directory, this option displays PATH=The name of the file is displayed in a multicolumn format. This is the default.
1Displays 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.
2Displays 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 (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 -5Shows 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.
6Shows the absolute pathname of the file.
7Shows 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).
8Shows all accessors of the files listed. Restrictions apply
9Shows level 8 information and details about processes accessing the files including file locking data. Restrictions apply.

 

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) SECURITYREAD :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

Feedback to webmaster