HP Browse/XL User's Guide HP e3000 MPE/iX Computer Systems Edition 1 Manufacturing Part Number: 36384-90001 E0490 U.S.A.
Notice The information contained in this document is subject to change without notice. Hewlett-Packard makes no warranty of any kind with regard to this material, including, but not limited to, the implied warranties of merchantability or fitness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or for direct, indirect, special, incidental or consequential damages in connection with the furnishing or use of this material.
1 Introducing HP Browse HP Browse is a full-screen interactive tool that allows you to examine and print files, and search for patterns of text in the files. With HP Browse you can: • Examine spool files. • Examine any part of a file by: • Scrolling. • Moving immediately to a particular line. • Setting place markers at particular lines in the file. • Open a second window. You can view different parts of one file, or view two separate files, simultaneously.
- 6
2 Using HP Browse This chapter presents many of the tasks you can do with HP Browse. It shows you exactly the steps to take to accomplish these tasks. Starting HP Browse At the MPE prompt, run HP Browse by using the RUN command. You can give the name of the file you want to browse in the INFO string: :RUN HPBROWSE.PUB.SYS;INFO="filename" Or use the implied RUN command: :HPBROWSE "filename" Or you can let HP Browse prompt you for the file name: :RUN HPBROWSE.PUB.
Then the command to browse a file named "DATA" would be: :BROWSE DATA Stopping HP Browse To leave HP Browse once you are in it, do either of the following: Press the Exit function key. or: Press e. Getting Help HP Browse provides a comprehensive online help system that offers useful information about functions and the context in which they are used. To access the online help facility, do any one of the following: Press the Help function key. or: Press H, h, or ?.
To change any option: 1 Press the MPE and Options function key. 2 Press the Set Options function key. 3 Press the function key corresponding to the option you want to change. (Use the Next Options function key to display the second set of function keys.) If the option only has two possible values, the option will change to the other value. Otherwise you must provide the new option value. 4 If applicable, type the new value for the option and press Return.
Opening a File To open a file: 1 Press the File/Print function key. 2 Press the Open File function key. 3 Type the name of the file you want to browse. (To open a spool file, just type the name of the spool file, for instance, "O25.OUT.HPSPOOL".) 4 Press Return. HP Browse displays the file. If you have two windows open, HP Browse displays the file in the current window. Printing a File To print all or part of a file: 1 Press the File/Print function key. 2 Press the Print Text function key.
1 Press the Windows function key. 2 Press the Switch Window function key. HP Browse makes the other window the current window. All functions apply to the current window. Closing and Hiding a Window To close or hide a window: 1 Use the cursor movement or arrow keys to position the cursor anywhere within the window you want to close. 2 Press the Windows function key. 3 Press the Close Window function key. HP Browse closes the window.
or: 1 Press the Position function key. 2 Press the Scroll Backward function key. Scrolling Left and Right in the File Scrolling Left. To scroll left in the file: 1 Press the Position function key. 2 Press the Next Keys function key. 3 Press the Scroll Left function key. Scrolling Right. To scroll right in the file: 1 Press the Position function key. 2 Press the Next Keys function key. 3 Press the Scroll Right function key.
Moving to a Particular Line in the File To move the cursor to a particular line in the file, do either of the following: 1 Press g. 2 Type the desired line number. 3 Press Return. 1 Press the Position function key. 2 Press the Go To Line/Mrk function key. 3 Type the desired line number. 4 Press Return. or: HP Browse moves the cursor to the specified line number. Moving to a Particular Marker in the File You can set place markers with the Set Mark function key under the Position function key.
Searching Forward To search forward for the current search pattern, do either of the following: 1 Press /. 1 Press the Search function key. 2 Press the Search Forward function key. or: Searching Backward To search backward for the current search pattern, do either of the following: 1 Press \. 1 Press the Search function key. 2 Press the Search Backward function key.
3 Function Keys This chapter lists and describes all of the functions and corresponding options you can use in HP Browse. The individual functions are listed by keyset. The keysets are listed in the order which they appear, from left to right, in the main keyset. Specifying a Count Many HP Browse functions accept a numerical option, called the count, which you may specify before issuing a function. HP Browse uses the count in performing many functions.
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.
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.
• Forward/Back Scroll Size • Left/Right Scroll Size • Lines Per Page • Output Device • Print Line Numbers • Print Header Line • Line Range The remaining HP Browse options are global; that is, they apply to both of the windows even if the windows contain different files. The global options are listed below. • Highlight Match • Ignore Case • Pattern-Matching Chars • Function Keys • File Path • Search Pattern Also, the Exit function always applies to both windows.
Switch Window In HP Browse you can manipulate two windows independently by moving the cursor into either window before executing a function. To move a cursor from one open window to another, press the Switch Window function key or simply use the cursor movement arrows on your keyboard to position the cursor into the other window. If a window is hidden, the Switch Window function will display the hidden window and hide the previously displayed window.
To use this function, press either the Back Line function key or the - character. You may specify a count for this function. The default is 1 line backward. Forward Line The Forward Line function advances the cursor one line in the text window. If the cursor is already on the last line in the window, the window is scrolled one line forward in the text. The default is 1 line forward. To use this function, press either the Forward Line function key, Return, or the + character.
Back/Forward Character The Back Character and Forward Character functions move the cursor back one character and forward one character, respectively. You cannot induce HP Browse to scroll the text window left and right with these functions. If you use the Back Character function when the cursor is in the leftmost column of the text window, HP Browse moves the cursor to the last column of the previous line in the text window.
Special Pattern-Matching Characters. HP Browse has a pattern-matching facility that enables you to use wildcard and other special characters in order to conduct more sophisticated pattern searches of your files. You can use any of the pattern-matching characters of HP Browse when you specify a pattern with the Define Search Pattern function. To signify to HP Browse that you want to use these special matching characters, set the Use Pattern-Matching Chars to "Yes".
(a|[c-z]|[1-4])A single character chosen from the following: "a", the range "c" to "z", or the range 1 to 4. ([A-Z])BUF Any one capital letter followed by "BUF". [A-Z]\(@\); Any string starting with an uppercase alphabetic character followed by an open parenthesis, any number of characters, and a close parenthesis. The entire string must be terminated with a semicolon. BUF+$ Any line ending with a string that begins with "BU", followed by one or more occurrences of "F".
terminates the search, leaving the lines it has printed on the screen.) Figure 3-2. The Find All Occurrences Screen The search pattern is displayed on the second line of the screen in parentheses. If there is not enough room on the second line for the entire search pattern, HP Browse displays only the first 60 characters of the search pattern. HP Browse displays the corresponding line number with each line containing an occurrence of the search pattern.
the MPE Commands function key, HP Browse displays the colon prompt and executes MPE commands until you press Return in response to the prompt. HP Browse then returns you to your previous text window. Command Files, UDCs, and execution of program files are also supported through the MPE Command interface.
Ignore Case. The Ignore Case option may be either "Yes" or "No". If "Yes", HP Browse performs its searches without regard to the case of characters in the file. That is, alphabetic characters in the search pattern will match either their uppercase or lowercase equivalents. If "No", the case must agree for HP Browse to match the search pattern. The default is "No". Use Pattern-Matching Characters. The Use Pattern-matching Chars option may be "Yes" or "No".
Help Facility Functions HP Browse provides a comprehensive help facility offering useful information about functions and the context in which they are used. To get help, press the Help function key, or "H", or "h", or "?". To leave the help facility and return to browsing your file, press Control Y, or the Exit Help function key. When you request help, the Main Help screen appears offering three categories of information: 1 Functions by Topic: Provides a list of tasks and how to accomplish them.
4- 28
4 Table of Character Key Assignments This table lists all the character keys you can use in HP Browse and their corresponding functions. You can use these character keys in place of the function keys.
4- 30
5 Errors and Warnings This section contains all the error messages and warnings you can receive while using HP Browse. These messages are listed below in numeric order along with the probable reason each is issued. HP Browse Error Messages 020 Initial spool file control information not displayed. (HPBW 020) The spool file was created using an environment for the laser printer. This information at the beginning of the file is not displayed by HP Browse. 030 Carriage Control data not displayed.
This is not a user error. HP Browse encountered an error while attempting to retrieve the attribute table for the language of the text. The attribute table contains language-specific information about the characters. Please contact HP support; investigation is required. 230 There is not enough space for the NLS collating sequence table. (HPBW 230) This is not a user error. HP Browse could not find enough space in memory for the collating table.
530 First character of identifier not alphabetic. (HPBW 530) The requested file name begins with a non-alphabetic character. 540 Unrecognized file name. (HPBW 540) MPE rejected one or more components of the requested file name. You may have misspelled the file name. 550 Identifier in file name is too long. (HPBW 550) One or more components of the requested file name is longer than eight characters, which is the maximum MPE allows. You may have misspelled the file name.
760 Mark #n has not been set. (HPBW 760) You attempted to go to a mark that has not been set. You have not set marker #n. 810 End of file on $STDIN. (HPBW 810) You entered an :EOD sequence at the beginning of the line during text entry. HP Browse interprets this sequence as a request to immediately exit HP Browse. 820 Duplicate permanent file. Unsupported SAVE option in file equation. (HPBW 820) A file equation exists for the specified file that contains the SAVE option.
You entered an invalid line number for this file format (for example, entered 1.123 for an unnumbered file). Check the line number format for this file before reentering a line number. 1310 Unable to read disk record XXX (line XXX). (HPBW 1310) This is not a user error. HP Browse encountered an error while attempting to read record XXX, which corresponds to line XXX. Please contact HP support; investigation is required. 1350 Only two windows can be open at one time.
1490 XXX is not a valid topic number. (HPBW 1490) The topic numbered XXX does not exist. Enter a number listed on the Topics screen. 1495 XXX is not a valid function number. (HPBW 1495) The function numbered XXX does not exist. Enter a number listed on the Function Description screen. 1500 There is no next page. (HPBW 1500) The only page or last page of the current topic is being displayed. There is no next page to display. 1520 Unknown command "XXX".
where the function keys are preserved. XXX is the error MPE returned to HP Browse. Please contact HP support; investigation is required. 1600 Received error XXX rewinding function key file. (HPBW 1600) This is not a user error. HP Browse encountered an error while attempting to rewind the file where the function keys are preserved. XXX is the error MPE returned to HP Browse. Please contact HP support; investigation is required. 1610 Received error XXX reading from function key file.
The desired command must be run directly from MPE and not from within HP Browse. 1820 Warning: The message catalog does not match program version. (HPBW 1820) This is not a user error. HP Browse encountered an error while checking the version of the message catalog. The message catalog version does not match the version of the program. HP Browse will still attempt to run but some error messages may be incorrect or may not be found. HP Browse may not have been installed correctly.
ing the data for the parameter. Only one quotation mark was specified. 2040 Quotation marks (' or ") must surround INFO string. (HPBW 2040) The INFO parameter of the RUN command must have matching quotation marks surrounding the data for the parameter. 2050 Invalid RUN option ('!') found in RUN command. (HPBW 2050) The RUN command has a parameter that is not valid. 2060 Value following 'STACK=' is invalid. (HPBW 2060) The value entered is greater than 32767 or contains a non-numeric value.
The program you are trying to run does not exist. 2220 Not a valid program file. (HPBW 2200) The program you are trying to run is not a valid program file. 2230 Process could not be loaded due to a hard load error. (HPBW 2230) The program you are trying to run cannot be executed. Try running the program outside of HP Browse to identify the problem. Let your system administrator know of this problem. 2240 Could not open the specified STDIN file.
