Generated from C.65.00 /SYSADMIN/PUB/MYCICAT last modified on Sun Aug 29 15:08:37 2004
Displays the description of one or more temporary files. (CM)
LISTFTEMP [fileset][,listlevel][;listfile]
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.
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. \ITEM=EXAMPLE EXAMPLE 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&
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
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 Back to Main Index