HPlogo Performing System Operation Tasks: 900 Series HP 3000 Computer Systems > Chapter 6 Copying Files to Tape

Listing the Files Stored

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

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 “Short File Display (MPE Format)” illustrates the output of this command in MPE format.

Figure 6-1 Short File Display (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

To store the same file set using HFS syntax:

   :FILE T;DEV=TAPE

   :STORE /TEST/PUB/@;*T;SHOW=SHORT

Figure 6-2 “Short File Display (HFS Format)” illustrates the output in HFS format:

Figure 6-2 Short File Display (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


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

Figure 6-3 Short File Display with Wrapped HFS Names

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

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 “Long File Display (MPE Format)” illustrates the output using the long file display.

Figure 6-4 Long File Display (MPE Format)

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-5 “Long File Display (HFS Format)” illustrates the same information as the preceding figure, except that the file names appear in HFS syntax:

Figure 6-5 Long File Display (HFS Format)

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


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 “File Date Information (MPE Format)” illustrates the file listing:

Figure 6-6 File Date Information (MPE Format)

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

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 “File Date Information (HFS Format)” illustrates the file listing from the preceding command example in HFS format.

Figure 6-7 File Date Information (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


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 “File Security Information” illustrates a file listing with security information from the above example.

Figure 6-8 File Security Information

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*

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 “Names Only Format” is an example for HFS format.

Figure 6-9 Names Only 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

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.

Feedback to webmaster