HP 3000 Manuals

Listing the Files Stored [ Performing System Operation Tasks ] MPE/iX 5.0 Documentation


Performing System Operation Tasks

Listing the Files Stored 

Whenever you store a set of files, the system displays the total number
of files stored at your terminal.  If there was an error, it also
displays the number and names of files not stored and the reason each was
not stored.  Use the SHOW parameter and its options to display the names
and additional information about the files stored and to list them on
your system printer as well as at your terminal.

Internally, the STORE program writes information about the files it
stores to a file with the formal file designator SYSLIST. It prints file
information at your terminal by equating SYSLIST with the standard
listing device for your session (your terminal).  You can redirect the
file information to another file or device by issuing a FILE command that
assigns SYSLIST to that device or file.  For example, you might want to
redirect the file information to a disk file so that you can keep it
online for your records.

To write STORE information to the disk file, SHOWFILE, enter:

     :FILE SYSLIST=SHOWFILE;DEV=DISC 

To print information on the files you stored at the system printer as
well as at your terminal, use the SHOW=OFFLINE option:

     :FILE T;DEV=TAPE 
     :STORE @.OPERATOR.SYS;*T;SHOW=OFFLINE 

To redirect the OFFLINE listing to another file or device, issue the
following FILE command.  It will send a copy of the STORE listing to the
disk file SHOWOFFL:

     :FILE OFFLINE=SHOWOFFL;DEV=DISC

To generate a store listing to the terminal as well as to a disk file,
enter the previous FILE command followed by the STORE command:

     :STORE @.OPERATOR.SYS;*t;SHOW=OFFLINE

To use a long or short file display 

The STORE command gives you two options for displaying additional
information about the files stored.  Using the SHOW parameter, you can
choose to display file information in either long or short form.

A short file display prints the file's full name, volume restrictions,
number of sectors, file code, and media number for each file you store.

In addition to there being a long and a short SHOW listing, there are
also two different versions of each:  MPE and HFS. The type of listing
printed depends on the input file set list.  You will get a HFS style
listing if:

   *   At least one file in the file set list is specified in HFS syntax.

   *   A file set wildcard is expanded to include a HFS syntax file.

The HFS style listing contains the same information as the MPE style
listing.  The only difference is that the file name is printed as an
absolute pathname at the end of the line.

Since HFS pathnames can be of variable length, and can be quite long,
they are placed at the end of the line so that they will not affect the
spacing of the other columns.  If the name does not fit on one line, it
will be wrapped to the next line.  An asterik (*) will be placed at the
last column of the line to indicate that the rest of the filename will
continue on the next line.


NOTE It is most likely that a STORE with the file set @.@.@ will result in a HFS format listing, since MPE/iX, by default, contains some HFS syntax files.
To display the list of files stored using the short form in MPE format, use the SHOW=SHORT option in your STORE command. For example: :FILE T;DEV=TAPE :STORE @.PUB.TEST;*T;SHOW=SHORT Figure 6-1 illustrates the output of this command in MPE format. ________________________________________________________________________ | | | | | FILENAME GROUP ACCOUNT VOLUME RESTRICTIONS SECTORS CODE MEDIA | | | | FILE1 .PUB .TEST DISC :C 1104 1 | | FILE2 .PUB .TEST DISC :C 0 1 | | FILE3 .PUB .TEST DISC :C 32 1 | | | ________________________________________________________________________ Figure 6-1. Short File Display (MPE Format) To store the same file set using HFS syntax: :FILE T;DEV=TAPE :STORE /TEST/PUB/@;*T;SHOW=SHORT Figure 6-2 illustrates the output in HFS format: ________________________________________________________________ | | | | | VOLUME RESTRICTIONS SECTORS CODE MEDIA FILENAME | | | | DISC :C 1104 1 /TEST/PUB/FILE1 | | DISC :C 0 1 /TEST/PUB/FILE2 | | DISC :C 32 1 /TEST PUB/FILE3 | | | | | ________________________________________________________________ Figure 6-2. Short File Display (HFS Format) The command specifies the file set in HFS syntax and how the names are wrapped in the resulting output when they cause the line to exceed 80 characters: :FILE T;DEV=TAPE :STORE /usr/lib/terminfo/e/e[t-z]@;*T;SHOW=SHORT ____________________________________________________________________________ | | | | | VOLUME RESTRICTIONS SECTORS CODE MEDIA FILENAME | | | | DISC :C 256 1 /_HFSACCT/_HFSGRP/HFSMAP | | DISC :C 16 1 /usr/lib/terminfo/e/ethern* | | et | | DISC :C 16 1 /usr/lib/terminfo/e/ex3000 | | DISC :C 16 1 /usr/lib/terminfo/e/exidy | | DISC :C 16 1 /usr/lib/terminfo/e/exidy2* | | 500 | | | ____________________________________________________________________________ Figure 6-3. Short File Display with Wrapped HFS Names A long file display in native mode contains the same information as a short file display plus each file's ending media number, record size, blocking factor, maximum number of extents allowed, end-of-file, and file record limit. Once again, there are two formats for the long listing, MPE and HFS. The HFS format contains the same information as the MPE format, except that the variable-length HFS filename is at the end of the line. It will be wrapped in the same was as the short listing if the file name length exceeds the line length. To display the list of files stored using the long form in MPE format, use the SHOW=LONG option. For example: :FILE T;DEV=TAPE :STORE @.PUB.TEST;*T;SHOW=LONG Figure 6-4 illustrates the output using the long file display. ______________________________________________________________________________________________________ | | | | | FILENAME GROUP ACCOUNT VOLUME RESTRICTIONS SECTORS CODE MEDIA_NUM RSIZE BFCTR #EXT EOF LIMIT | | | | FILE1 .PUB .TEST DISC :C 1104 1 - 1 80 16 0 3500 3500 | | FILE2 .PUB .TEST DISC :C 0 1 - 1 72 3 1 0 0 | | FILE3 .PUB .TEST DISC :C 32 1 - 1 72 1 2 111 112 | | | ______________________________________________________________________________________________________ Figure 6-4. Long File Display (MPE Format) Figure 6-5 illustrates the same information as the preceding figure, except that the file names appear in HFS syntax: _______________________________________________________________________________________________ | | | | | VOLUME RESTRICTIONS SECTORS CODE MEDIA_NUM RSIZE BFCTR #EXT EOF LIMIT FILENAME | | | | DISC :C 1104 1 - 1 80 16 0 3500 3500 /TEST/PUB/FILE1 | | DISC :C 0 1 - 1 72 3 1 0 0 /TEST/PUB/FILE2 | | DISC :C 32 1 - 1 72 1 2 111 112 /TEST/PUB/FILE3 | | | | | _______________________________________________________________________________________________ Figure 6-5. Long File Display (HFS Format) If you use the SHOW parameter without specifying either LONG or SHORT, the system displays files in short form when the record size of the output device or file (SYSLIST) contains fewer than 132 characters in native mode and 114 characters in transport mode. The system displays files in long form when the record size is equal to or greater than 132 characters in native mode and equal to or greater than 114 characters in transport mode. You can combine either LONG or SHORT with any of the other SHOW options, except path, but you cannot specify both LONG and SHORT at the same time within a STORE command. To display file dates To display each file's creation date, last access date, and last modification date for the files stored, use the SHOW=DATES option. For example: :FILE T;DEV=TAPE :STORE @.PUB.DOC;*T;SHOW=DATES Figure 6-6 illustrates the file listing: _________________________________________________________________________ | | | | | FILENAME GROUP ACCOUNT VOLUME RESTRICTIONS SECTORS CODE MEDIA | | CREATED ACCESSED MODIFIED | | | | FILE1 .PUB .TEST DISC :C 1104 1 | | 1/12/1994 1/12/1994 1/12/1994 | | | | FILE2 .PUB .TEST DISC :C 0 1 | | 1/12/1994 1/12/1994 1/12/1994 | | | | FILE3 .PUB .TEST DISC :C 32 1 | | 1/12/1994 1/12/1994 1/12/1994 | | | _________________________________________________________________________ Figure 6-6. File Date Information (MPE Format) When the output listing is in HFS format, an additional field is added to the dates display. The STATE_CHANGE field indicates the last date that a file attribute was changed. An example listing is: Figure 6-7 illustrates the file listing from the preceding command example in HFS format. ________________________________________________________________ | | | | | VOLUME RESTRICTIONS SECTORS CODE MEDIA FILENAME | | CREATED ACCESSED MODIFIED STATE_CHANGE | | | | DISC :C 1104 1 /TEST/PUB/FILE1 | | 1/12/1994 1/12/1994 1/12/1994 1/12/1994 | | | | DISC :C 0 1 /TEST/PUB/FILE2 | | 1/12/1994 1/12/1994 1/12/1994 1/12/1994 | | | | DISC :C 32 1 /TEST/PUB/FILE3 | | 1/12/1994 1/12/1994 1/12/1994 1/12/1994 | | | | | ________________________________________________________________ Figure 6-7. File Date Information (HFS Format) To display file security information To display file security information for the files stored, use the SHOW=SECURITY option. The listing includes the file creator's user and account name, the security matrix, and a flag indicating the presence or absence of an ACD. The HFS format displays the same security information. For example: :FILE T;DEV=TAPE :STORE @.PUB.TEST;*T;SHOW=SECURITY Figure 6-8 illustrates a file listing with security information from the above example. ____________________________________________________________________________ | | | | | FILENAME GROUP ACCOUNT VOLUME RESTRICTIONS SECTORS CODE MEDIA | | FILE1 .PUB .TEST DISC :C 1104 1 | | LAURA .STSUPPNM (R:ANY; A:ANY; W:ANY; L:ANY; X:ANY) *ACD EXISTS* | | | | FILE2 .PUB .TEST DISC :C 0 1 | | LAURA .STSUPPNM (R:ANY; A:ANY; W:ANY; L:ANY; X:ANY) *ACD ABSENT* | | | | FILE3 .PUB .TEST DISC :C 32 1 | | LAURA .STSUPPNM (R:ANY; A:ANY; W:ANY; L:ANY; X:ANY) *ACD ABSENT* | | | ____________________________________________________________________________ Figure 6-8. File Security Information To display names only The SHOW=NAMESONLY allows an abbreviated listing to be displayed. The only fields shown are the starting and ending media number, and the name of the file. This option is most useful when displaying HFS syntax files. Since they can be longer than MPE syntax names, it is sometimes useful to allow more room on the line to display the full pathname. NAMESONLY cannot be used with the SHORT or LONG options to SHOW. It has a slightly different format for MPE and HFS. The HFS style has the filename as the last field, while the MPE style has the filename as the first field. Figure 6-9 is an example for HFS format. ____________________________________________ | | | | | MEDIA_NUM FILENAME | | 1 - 1 /_HFSACCT/_HFSCRP/HFSMAP | | 1 - 1 /usr/lib/terminfo/e/ethernet | | 1 - 1 /usr/lib/terminfo/e/ex3000 | | 1 - 1 /usr/lib/terminfo/e/exidy | | 1 - 1 /usr/lib/terminfo/e/exidy2500 | | | ____________________________________________ Figure 6-9. Names Only Format To force the HFS format If you specify SHOW=PATH is the STORE command line, the output listing will be in HFS format, even if no HFS syntax files are being stored. You may want to use this so that all of your listings appear in the same format.


MPE/iX 5.0 Documentation