LISTFTEMP

Generated from C.60.01 /SYS/PUB/CICAT last modified on Thu Jan 11 09:18:52 2001

Back to Main Index


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.


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.

\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&

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

Back to Main Index