HP 3000 Manuals HP 3000 Manuals
Viewing File Information
Files store the information with which you work. Reports, financial
data, program listings, letters, management tools, and more exist within
the system in the form of files. Files in the PUB group of an account
are usually the files that users of the account share. Files in other
groups in the account are often the private files of that group's users.
Files must have unique names within the group, but two files in different
groups might have the same name. You can display a list of files in your
group and account.
To list file names to your screen
There are many ways to display a list of files. The following sections
offer ways of displaying sets of files with a single command, LISTFILE.
To list all file names in your current group and account.
To list the names of all files in your current group and account, use the
LISTFILE command.
1. At the system prompt, type LISTFILE.
2. Press Return.
:LISTFILE Return
Your screen displays whatever file names you have in your logon group.
Here is a sample display:
______________________________________________________________
| |
| |
| :LISTFILE |
| FILE NAME |
| |
| ADDCAP ALLMTNS ALPHA AMSPELL BITSOM MINUTES |
| CLEAN PATH |
| :_ |
| |
______________________________________________________________
To list all file names that begin the same.
To list the names of all files in your group and account that begin with
the same letter or letters, use the wildcard character (@) after the
common portion of the file name.
1. At the system prompt, type LISTFILE xxx@. (Replace xxx with the
beginning letter or letters of the files that you wish to be
displayed.)
2. Press Return.
The following example displays all files in your current group and
account that begin with the letters "ABC":
:LISTFILE ABC@ Return
To list all file names that end the same.
To display the names of all files in your group and account that end with
the same letter or series of letters, use the wildcard character @
immediately preceding the common part of the file name and for the group:
1. At the system prompt, type LISTFILE @xxx. Replace xxx with the
ending letter or letters of the files that you wish to display.
2. Press Return.
The following example lists files in your current group and account that
end in the letters "TXT".
:LISTFILE @TXT Return
To list all file names in a specific group and account.
To list the names of all files in a specific group of an account, use the
LISTFILE command and provide a group name and an account name. Use the
wildcard character (@) for the file name.
1. At the system prompt, type LISTFILE @.groupname.accountname.
2. Press Return.
The following example lists all files (indicated by the @) in the QTR1
group of the PAYROLL account:
:LISTFILE @.QTR1.PAYROLL Return
To list all file names in all groups in an account.
To list the names of all files in all groups of an account, use the
LISTFILE command. Use the wildcard character (@) for the file name and
group name, and provide an account name.
1. At the system prompt, type LISTFILE @.@.accountname.
2. Press Return.
The following example lists all files in all groups of the PAYABLE
account.
:LISTFILE @.@.PAYABLE Return
To list all file names on the system.
To list the names of all files in all groups in all accounts, use the
LISTFILE command with wildcard characters for the file name, the group,
and the account.
1. Type LISTFILE @.@.@ at the system prompt.
2. Press Return. For example:
:LISTFILE @.@.@ Return
For a system with several users, this command may generate a large
display. The system scrolls lines of text until it reaches the end of
the data. Enter CTRL S to stop the scrolling. Enter CTRL Q to continue
the scrolling.
To get specific information about files
To get specific information about a file, use one of the options of the
LISTFILE command. The options can be entered as keywords or option
numbers.
To find the maximum number of records.
To find the maximum number of records in a file, use the SUMMARY or 1
option of the LISTFILE command.
1. At the system prompt, type LISTFILE filename,SUMMARY (or 1).
2. Press Return.
The following example provides a summary screen for the file TEMPREC:
:LISTFILE TEMPREC,SUMMARY Return
or
:LISTFILE TEMPREC,1 Return
This option displays a screen similar to the following:
___________________________________________________________
| |
| |
| ACCOUNT= PAYROLL GROUP= QTR3 |
| |
| FILENAME CODE -------- LOGICAL RECORD ------ |
| SIZE TYP EOF LIMIT |
| |
| TEMPREC 80B FA 10 10 |
| |
___________________________________________________________
This screen displays the following information:
* file group and account information (ACCOUNT=, GROUP=)
* file name (FILENAME)
* file code (CODE)
* record size (SIZE)
* type of file format and data representation, such as fixed or
variable, ASCII or binary (TYP)
* current end-of-file location (EOF)
* maximum number of records allowed in the file (LIMIT)
To display file specifications.
To display the file specifications and security levels of a file, use the
DETAIL or 3 option of the LISTFILE command.
1. At the system prompt, type LISTFILE filename,DETAIL (or 3).
2. Press Return.
The following example displays file specifications and security levels of
the TEMPREC file:
:LISTFILE TEMPREC,DETAIL Return
or
:LISTFILE TEMPREC,3 Return
This option displays the following information:
_____________________________________________________________________
| |
| |
| ******************************* |
| FILE: TEMPREC.QTR3.PAYROLL |
| |
| FILE CODE : 0 FOPTIONS: ASCII, FIXED, NOCCTL, STD |
| BLK FACTOR: 10 CREATOR : ** |
| REC SIZE: 80(BYTES) LOCKWORD: ** |
| BLK SIZE: 80(BYTES) SECURITY--READ : ANY |
| EXT SIZE: 8(SECT) WRITE : ANY |
| NUM REC: 10 APPEND : ANY |
| NUM SEC: 16 LOCK : ANY |
| NUM EXT: 1 EXECUTE : ANY |
| MAX REC: 10 ** SECURITY IS ON |
| NUM LABELS: 0 FLAGS : NO ACCESSORS |
| MAX LABELS: 0 CREATED : MON, SEP 10, 1990, 7:21 PM |
| DISC DEV# :15 MODIFIED: THU, NOV 15, 1990, 9:54 PM |
| CLASS :DISC ACCESSED: THU, NOV 15, 1990, 9:54 PM |
| SEC OFFSET:0 LABEL ADDR: ** |
| |
| |
_____________________________________________________________________
This screen displays the following information:
* complete file name
* record and extent sizes
* number of records
* file security access rights for the user
* dates when the file was created, modified, and last accessed
To display security levels.
To display the security levels of a file, its group, and its account, use
the SECURITY or 4 option of the LISTFILE command.
1. At the system prompt, type LISTFILE filename, SECURITY (or 4).
2. Press Return.
The following example displays the security level for the TEMPREC file:
:LISTFILE TEMPREC, SECURITY Return
or
:LISTFILE TEMPREC,4 Return
This option displays a screen similar to the following:
_____________________________________________________________________
| |
| |
| ******************************* |
| FILE: TEMPREC.QTR3.PAYROLL |
| |
| ACCOUNT -------------- READ : ANY |
| WRITE : AC |
| APPEND : AC |
| LOCK : ANY |
| EXECUTE : ANY |
| |
| GROUP ---------------- READ : ANY |
| WRITE : AL, GU |
| APPEND : AL, GU |
| LOCK : AL, GU |
| EXECUTE : ANY |
| SAVE : GU |
| |
| FILE ----------------- READ : ANY FCODE : 0 |
| WRITE : ANY **SECURITY IS ON |
| APPEND : ANY NO ACDS |
| LOCK : ANY |
| EXECUTE : ANY |
| |
| FOR USER1.PAYROLL: READ, WRITE, LOCK, APPEND, EXECUTE |
| |
_____________________________________________________________________
This screen displays the following information:
* account-level, group-level, and file-level security (READ, WRITE,
APPEND, LOCK, EXECUTE)
* a listing of user's file access rights (FOR username.acctname:
READ, WRITE, LOCK, and so on.)
* status of file's security (either **SECURITY IS ON or **SECURITY
IS OFF)
To display a fully qualified file name.
To display the fully qualified file name of a file, use the QUALIFY or 6
option of the LISTFILE command. The fully qualified file name is
composed of the file name, its group name, and its account name.
1. At the system prompt, type LISTFILE filename,QUALIFY (or 6).
2. Press Return
The following example displays the fully qualified name of the TEMPREC
file:
:LISTFILE TEMPREC,QUALIFY Return
or
:LISTFILE TEMPREC,6 Return
This option displays the following information:
TEMPREC.QTR3.PAYROLL
The wildcard character @ may be used in place of file, group, and account
names. For example:
* To list all qualified file names in the group QTR3 of the PAYROLL
account:
LISTFILE @.QTR.PAYROLL, QUALIFY Return
* To list all qualified file names in all groups of the PAYROLL
account:
LISTFILE @.@.PAYROLL, QUALIFY Return
* To list all qualified file names on the system:
LISTFILE @.@.@, QUALIFY Return
To display the lockword and creator.
To display the lockword and creator of a file, use option -3 of the
LISTFILE command. This option is available to only the system manager
(SM capability), or the account manager (AM capability) of the account
that the file is in.
1. At the system prompt, type LISTFILE filename, -3.
2. Press Return.
The following example displays the creator of the TEMPREC file and any
lockword assignments:
:LISTFILE TEMPREC, -3 Return
This option displays the following information:
_____________________________________________________________________
| |
| |
| ******************************* |
| FILE: TEMPREC.QTR3.PAYROLL |
| |
| FILE CODE : 0 FOPTIONS: ASCII, FIXED, NOCCTL, STD |
| BLK FACTOR: 10 CREATOR : CLERK |
| REC SIZE: 80(BYTES) LOCKWORD: KINU |
| BLK SIZE: 80(BYTES) SECURITY--READ : ANY |
| EXT SIZE: 8(SECT) WRITE : ANY |
| NUM REC: 10 APPEND : ANY |
| NUM SEC: 16 LOCK : ANY |
| NUM EXT: 1 EXECUTE : ANY |
| MAX REC: 10 ** SECURITY IS ON |
| NUM LABELS: 0 FLAGS : NO ACCESSORS |
| MAX LABELS: 0 CREATED : MON, SEP 10, 1990, 7:21 PM |
| DISC DEV :15 MODIFIED: THU, NOV 15, 1990, 9:54 PM |
| CLASS :DISC ACCESSED: THU, NOV 15, 1990, 9:54 PM |
| SEC OFFSET:0 LABEL ADDR: $000000D1 $001BC920 |
| |
_____________________________________________________________________
Along with file specification information, this screen displays the
following:
* name of the creator of the file
* lockword assigned to the file, if any
To view the contents of a file from the system prompt
You can view the contents of a file using the PRINT command at the system
prompt.
To view the entire file.
To view the contents of a file, use the PRINT command followed by a file
name.
1. At the system prompt, enter PRINT followed by the file name.
2. Press Return.
The following example displays the contents of the YOURFILE file
in your current group and account:
:PRINT YOURFILE Return
This example displays the contents of the file--but only from the
QTR1 group of the PAYABLE account.
:PRINT TEMPREC.QTR1.PAYABLE Return
If your file is longer than what can be shown on one screen, a
pagebreak prompt appears. This prompt looks similar to the
following:
23/54 Continue?_
Respond with Y or YES Return if you want to display the next
screen page of the file. Respond with N or NO Return if you wish
to stop the PRINT command and return to the system prompt.
Note that the first number of the pagebreak prompt indicates the
next line number to be displayed. The second number of the
pagebreak prompt indicates the total number of lines in the
document.
To view portions of a file.
You can print certain portions of a file to the screen by specifying
START= or END= line numbers. For example:
* To display selected lines of a file on your screen, enter the
PRINT command, and specify the file name and the starting and
ending line numbers. The following example prints lines 1 through
10 of the MYFILE file:
:PRINT MYFILE;START=1;END=10 Return
* To display the end of the file, use the PRINT command without an
ending line number. In the following example, all lines from line
170 to the end of the file MYFILE are displayed:
:PRINT MYFILE;START=170 Return
* To display a number of lines from the end of the file, specify the
starting line number as a negative number. This signifies that
the starting line number is to be calculated from the end of the
file. In the following example, the last twenty lines of the file
MYFILE are displayed:
:PRINT MYFILE;START=-20 Return
Any problems?
* Did the prompt disappear after using the PRINT command?
Enter :eod (colon included) by itself on a new line and press
Return. To prevent this from occurring again, always specify a
file name when using the PRINT command.
* Did you get the following error message?
NONEXISTENT PERMANENT FILE (FSERR 52)
THE PRINT COMMAND FAILED. (CIERR 9080)
This error message means that the file name that you are trying to
access, is not recognized by the computer. Check to see if the
file name is spelled correctly.
Also, check that the file is in your logon group and account. If
it is not, and you are the creator of the file, use the fully
qualified file name.
* Did you get this error message?
SECURITY VIOLATION (FSERR 93)
THE PRINT COMMAND FAILED. (CIERR 9080)
You are trying to print a file to which you do not have access.
In this case, the creator of the file must release the file (see
the RELEASE command, in chapter 7) before you can print it.