HP 3000 Manuals HP 3000 Manuals
Listing the Files Stored (SHOW)
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
Using 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 asterisk (*) 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 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 a short file display in MPE format using the
above example.
________________________________________________________________________
| |
| |
| 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)
This example uses the same file set as the first example, except that it
is specifed in HFS syntax.
:FILE T;DEV=TAPE
:STORE /TEST/PUB/@;*T;SHOW=SHORT
Figure 6-2 illustrates a short file display in HFS format using the
above example.
________________________________________________________________
| |
| |
| 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)
This example shows how the HFS syntax names will be wrapped, if they
cause the line to exceed 80 characters:
:FILE T;DEV=TAPE
:STORE /usr/lib/terminfo/e/e[t-z]@;*T;SHOW=SHORT
Figure 6-3 illustrates a short file display in HFS format with line
wrap using the above example.
____________________________________________________________________________
| |
| |
| 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 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 a long file display from the above example.
______________________________________________________________________________________________________
| |
| |
| 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 example as above, except specifying
the file names 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, but do not specify 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 NAMESONLY, but you cannot specify both LONG and SHORT at the same
time within a STORE command.
Displaying 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 a file listing created from the above example.
_________________________________________________________________________
| |
| |
| 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 a file listing created from the above 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)
Displaying 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
Displaying 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
Forcing the HFS Format
If SHOW=PATH is specified, the output Store listing will be in HFS
format, even if no HFS synatx files are being stored. You may want to
use this so that all of your listings appear in the same format.