HP 3000 Manuals

File and Print Functions [ HP Browse/XL User's Guide ] MPE/iX 5.0 Documentation


HP Browse/XL User's Guide

File and Print Functions 

Open File 

Use the Open File function when you want HP Browse to read a new file
into the workspace window.  HP Browse will accept any ASCII or binary
file that is not a privileged file.  Files are opened by HP Browse for
both read-only and shared access.  This allows multiple users to browse
the file concurrently.

You can browse binary files with HP Browse but the data is interpreted as
ASCII characters.  HP Browse denotes data with a binary value by
highlighting it.

Using HP Browse, you can open a file of any length within the limits of
your MPE operating system.  However, HP Browse does impose a restriction
on the record size of the file.  It will allow you to browse a file with
a record size greater than 1024 bytes, but only the first 1024 bytes will
be displayed.  The only exception to this rule are files with variable
length records.  Many variable length record files have a physical record
length greater than 1024 bytes although each logical record can be less
than the length of the physical record.  If a record is greater than 1024
bytes long, HP Browse will not display the data beyond the 1024th
character.
If you open a numbered file, HP Browse will display the line numbers in
the first nine columns for a regular numbered file and in the first seven
columns for a COBOL numbered file.  See also "Option-Setting Functions",
in this chapter.

If you specify a file to be opened into a window that already contains an
opened file, HP Browse will close the previously opened file to allow the
new file to be read into the window.  Regardless of size, only one file
may be open in any one window.  However, HP Browse does allow more than
one window to be open at one time.  For more information, refer to
"Window Functions", in this chapter.

Print Text 

Use the Print Text function to print an open file or portions of an open
file.  When you press the  Print Text function key, HP Browse replaces
your current function keys with the Print Text keyset and displays the
print options on your terminal screen, as shown below:

[]
Figure 3-1. The Printing Options Screen Printing Your File. After you press the Print Text function key, you can print the file you are currently browsing by either pressing Return or by pressing Print Text again. HP Browse displays the current values of the print options, one per line. When you press either RETURN or Print Text, HP Browse sends text to the currently specified output device and using the currently specified print options. To return to the workspace window without printing the file, press Exit Print or "Control Y". Print Options. The print options you specify are maintained between executions of the Print Text function in HP Browse and may be set independently for each file opened in a session. Use the Save Config function in the Options keyset to save print options for the next time you use HP Browse. (Note, however, that the only print options that will be saved are Lines Per Page, Output Device, and Print Header Lines. Print Line Numbers and Line Range will not be saved.) Lines Per Page. Use the Lines Per Page option to determine how many lines of text should be printed on each page. When you press the Lines Per Page function key, HP Browse erases the current lines per page value and prompts you for a new value. If you press Return without entering a value, the previous value is restored. The minimum lines per page value allowed is 1 if the header option is disabled and 3 if the header option is enabled. (The header and the blank line after it count as two lines of the page.) The maximum value allowed is 10,000 lines per page. The default value is 60 lines per page. Output Device. The Output Device option allows you to specify which printer or disk file to send your output to. Whether you send your output to a printer or a disk file, HP Browse uses file equations. When you press the Output Device function key, HP Browse erases the current file specifier and prompts you for a new value. If you press Return without entering a value, the previous value will be restored. The default for this option is "*LP". If no file equation exists for "LP", HP Browse creates the following default file equation: FILE LP;DEV=LP Print Line Numbers. The Print Line Numbers option determines whether HP Browse prints line numbers in front of each line of text. When you press the Print Numbers function key, this value toggles between "Yes" and "No". If "Yes" is specified, HP Browse will print standard-numbered lines using the first ten columns for the formatted line number ("xxxxx.yyy "), COBOL-numbered lines with 8-column formatted numbers ("xxx.yyy "), and unnumbered lines are printed with their record numbers right-justified to column 6. If "No" is specified, the text of each line is printed, starting in column 1. The default for this option is "Yes" for numbered files and "No" for unnumbered files. Print Header Lines. The Print Header Lines option determines whether HP Browse prints headers at the top of each page. When you press Print Headers, this option toggles between "Yes" and "No". If "Yes" is specified, HP Browse will print a header on the top of each page and a blank line is left between the header and the text. Otherwise, no header lines are printed. A sample header is shown below: PAGE 12 FRI, MAR 16, 1990, 3:45 PM FILE: MYFILE.MYGROUP.ACCOUNT Line Range. The Line Range option allows you to print all or part of a file. When you press the Line Range function key, the existing value for this option will be erased and HP Browse will prompt you for a new line range. The keyword All can be used to specify the range when you want to print an entire file. The keywords First and Last can be used to specify the first and last lines (or records) in your file. In cases where you want to print only a portion of a file, you must specify the beginning and ending lines of the text to be printed as shown below. Line Range firstline/lastline If the file you want to print is a numbered file, HP Browse expects you to enter a line number range. Otherwise, a record number range is expected. If you type Return without entering a line range, HP Browse will restore the previous value. The default for this option is "ALL". Sample line ranges for numbered and unnumbered files are given in Table 3-1. Table 3-1. Sample Line Ranges ------------------------------------------------------------------------------------------- | | | Numbered Unnumbered | | | ------------------------------------------------------------------------------------------- | | | 84.2/392.35 1011/1873 | | | ------------------------------------------------------------------------------------------- Use the Help Print function key to display a description of each of the HP Browse print options. The amount of text printed per line is based on the record length of the output device. If the record length is not defined, HP Browse assumes it is 132 columns. If the text in a line is longer than 132 columns, HP Browse will print it on multiple lines with the continuation character, "$", at the beginning of the additional lines signifying that they are continuation lines.


MPE/iX 5.0 Documentation