i ______ _______ ___ XPEDIT Version 1.8 ___________ ______ Full-Screen Editor ___ ___ __ _____ for the HP e3000 ______ ____ ______ Xpedit User Manual _______ _________ __________ ____ Robelle Solutions Technology Inc. ____ ___ _______ _____ ___ 7360 137 Street, Suite 372 _______ ____ ______ ___ ___ Surrey, B.C. Canada V3W 1A3 __________ _____________ Toll-free: 1.888.robelle ________________ (1.888.762.3553) ______ ____________ Phone: 604.501.2001 ____ ____________ Fax: 604.501.2003 ___________________ support@robelle.com _______________ www.robelle.com _____ ____ March 2000 Program and Manual Copyright Robelle Solutions Technology Inc. 1992-2007 ___ Permission is granted to reprint this document (but not for profit), provided that copyright notice is given. QEDIT and SUPRTOOL are trademarks of Robelle Solutions Technology Inc. Other product and company names mentioned herein may be the trademarks of their respective owners. 1 _______ _ _______ __ ______ Chapter 1 Welcome to Xpedit _ ____________ ü Introduction _ _____________ __ ___ ______ ü Authorization to Use Xpedit _ _____________ ü Documentation _ ___ ______ ___ ____ _______ ü Who Should Use This Manual? _ _____ _ __ _______ __ _ ________ ü Using a PC Instead of a Terminal _ __________ __ ______ ü Highlights of Xpedit ____________ Introduction Xpedit is a full-screen editor designed for people who do not want or need the complexity of programmer-style editors such as Qedit or EDIT/3000. Xpedit uses the full-screen capabilities of terminals for editing simple files. Xpedit requires an HP terminal or a PC running HP terminal emulation software. Xpedit was designed as a simple editor for Xpress electronic mail users. However, it is general enough in scope to be used outside of the Xpress environment, as a full-screen editor for many small text files. The editing features of Xpedit include updating, inserting and deleting lines of text. Paging through the document is handled by clearly labeled function keys. On-line help is available from the main edit screen. An option of editing files using one or more templates is available within Xpedit. This feature allows the setup of turnkey applications whose input data requires a standard format. Editing with templates is accomplished through the use of an alternate forms file. A sample template forms file is included on the tape, but your shop will most likely want to design and compile your own. This is done using the standard VPLUS utilities. _____________ __ ___ ______ Authorization to Use Xpedit Xpedit is a "bonus" program that accompanies most Robelle products. We will send you a copy if your Robelle order entitles you to receive it. As a Robelle customer you may install Xpedit on your CPUs which are licensed for our products. There is no ___ charge for using Xpedit, but you are not free to distribute it. Please install Xpedit only on your primary licensed CPUs, or on CPUs which are registered secondary CPUs. Xpedit is in the PUB group to remind you that it is a Bonus product, and not part of any library that you can freely distribute. There is another category of programs from Robelle, _______ _ _______ __ ______ 2 Chapter 1 Welcome to Xpedit called the "Qlib". These are programs which you may use on any ___ CPU and may distribute freely to your friends. Xpedit is not part of the Qlib. If you have questions on whether you are authorized to install Xpedit on a particular CPU, please call us for advice. _____________ Documentation Use the Printdoc program to print the Xpedit user manual and change notice. Printdoc supports any kind of printer, from line printer to LaserJet. You can type a ? at any prompt in Printdoc, if you need help. Printdoc will ask you questions about your printer. :run printdoc.pub.robelle Here is the list of documentation files for Xpedit: xpedit.doc.robelle {Xpedit user manual} xpedit.docchg.robelle {change notice} _______ Figures There are a number of figures scattered about the manual. Due to space constraints, the number of lines on the screen shown in each figure has been reduced from 18 to 13. The number of columns has also been reduced from 78 to 70. ___ ______ ___ ____ _______ Who Should Use This Manual? This manual is intended for end users of Xpedit, as well as for those who will be installing it. The manual covers all of the features of Xpedit, including using Xpedit as the editor within Xpress. _____ _ __ _______ __ _ ________ Using a PC Instead of a Terminal This manual assumes that you are using Xpedit with an HP terminal. Some of the keystrokes discussed in this manual will be different from those used on a PC emulating an HP terminal. For example, when using Reflection from Walker Richer & Quinn to emulate an HP _____ ____ _____ terminal, the Clear Line key is Alt-K. Please consult your terminal emulator manual for all of the keystroke conversions. _______ _ _______ __ ______ Chapter 1 Welcome to Xpedit 3 __________ __ ___ Highlights in 1.8 ü Xpedit will now detect if Time Machine is installed. __________ __ ___ Highlights in 1.7 ü Two-user site licenses can now run Xpedit. __________ __ ___ Highlights in 1.6 ü Xpedit now works with Time Machine and the HP utility Setdate. __________ __ ______ Highlights in 1.5.01 ü The "Next Page/Add a Page" function key was adding only one line. ü The "Insert three lines" edit key was inserting only one line. ü Xpedit would abort when entering a numeric entry into the template menu. __________ __ _______ ___ Highlights of Version 1.5 ü A new JCW was added called XPForceForm. This JCW causes Xpedit to force editing with a particular form number. ü Inverse video was added to some error messages to make them stand out more clearly. 4 _______ _ ______ __ _ _____ ___________ Chapter 2 Xpedit is a VPLUS Application _ ________ ü Overview _ _____ ____ __________ _______ ____ ü Using Your Terminal's Editing Keys _ _____ ___ ü Break Key _ _______ ______ ____ ___ _______ ü Running Xpedit From the Console __ ___ ____ _____ ______ ____ _ ___________ _____ ____________ If you have never worked with a full-screen VPLUS application, ______ ____ ____ ________ please read this chapter. ________ Overview Xpedit uses VPLUS, a standard screen-driver supported by Hewlett-Packard. Xpedit's look and feel is aimed at previous users of other VPLUS applications, and the interface is simple to learn. If you have never used a VPLUS application program before, do not worry. Xpedit is easy to use, and some basic instructions are given below. VPLUS, or "View" as some people call it, is used by many programs that want to communicate with the user in a full-screen or block-mode environment. The idea is that while the user is typing in data, the terminal is doing all of the work. This frees up the host computer to do other important things - it won't spend all of its time waiting for every keystroke from every single user. The only time that the computer gets to see the information that _____ you typed in is when you press the Enter key, or when you press one of the function keys. The host computer then goes to work processing your request. Normally after a couple of seconds, the computer will send something to your screen and return control to _____ the terminal until the next Enter or function key is pressed. _____ ____ __________ _______ ____ Using Your Terminal's Editing Keys ______ To move your cursor around inside a VPLUS screen, use the cursor ___ keys (the keys with the arrows on them) and the Tab key. The ______ ____ ______ ____ Insert Line and Delete Line keys will have no effect, but the ______ _________ ______ _________ Insert Character and Delete Character keys will work just fine. ______ Inside Xpedit, pressing the Return key will send your cursor to the beginning of the next line. _________ _________ If you are used to using the Control-S or Control-Q keystrokes to pause and resume text printing, you will find that they do not _____ work inside a VPLUS program. Also, do not hit the Break key. Your terminal may become locked up. _______ _ ______ __ _ _____ ___________ Chapter 2 Xpedit is a VPLUS Application 5 _____ ___ Break Key __ ___ _______ VPLUS applications do not disable the Break key. It is enabled or disabled by the user or a program, by a command file or a UDC. Xpedit does not automatically disable the Break key. The disadvantage of having the Break key enabled is that if you accidentally press Break in Xpedit, your terminal will probably still be in block-mode with format mode enabled, handshaking straps incorrectly set, and echo turned off. Your terminal may not be usable in MPE in such a state. To get the terminal back to usability within MPE, you will have to do a hard reset of the terminal. For MPE/iX, you would then have ______ to issue SET ECHO YES; on MPE V, you would issue "escape :". Finally, you must type in the word ABORT. We recommend that you disable the Break key, but we leave it to your discretion. If you wish to disable the Break key, you may do so within a UDC or command file. For example: xped filename option nobreak run xpedit.pub.robelle;info="!filename" _______ ______ ____ ___ _______ Running Xpedit From the Console Any block-mode application should not be run from the console. When sending system messages to the console, the HP e3000 ignores QUIET mode. These messages will print on top of any data that may be displayed in your VPLUS or block-mode application. When Xpedit starts up, it checks to see if is being run from a valid terminal. Depending on your operating system, Xpedit may give an error message if it is being run from the physical console. For example, the physical console on an MPE/iX computer is ldev 20. 6 _______ _ _____ ______ Chapter 3 Using Xpedit _ _________ ______ ü Accessing Xpedit _ _______ ___ _____ ü Editing New Files _ _____ ________ ___ ______ ü Files Suitable for Xpedit _ _____ ____ _____ _______ ü Files With Short Records _ _____ __________ ____ ______ ü Files Containing File Labels _ ______ ____ ü Binary Data _ _____ _____ ü Qedit Files _ ______ ________ _____ ü Xpedit Internal Files _________ ______ Accessing Xpedit If you are using Xpedit as an editor in Xpress electronic mail, then you do not run Xpedit using the Run command. Xpress does this for you. However, you can also use Xpedit within other applications to allow users to edit small files. To run Xpedit from the MPE prompt, you would use: :run xpedit.pub.robelle;info="myfile.mygroup.myacct" The Info string is required, and contains the name of a file that you wish to edit. Xpedit will create a new file if you specify a file that does not already exist. If you are running Xpedit on a MPE/iX machine, you could also use: :xpedit.pub.robelle myfile.mygroup.myacct If you wish to edit using a template forms file, you must issue ______ the following :File equation before running Xpedit: ________ _____ ____ ____ :file xptempla=template forms file name ____ The forms file should be a fast forms file to ensure that the form's data is consistent and correct. Xpedit can edit files that contain up to 500 lines, where each line is up to 78 characters long. The input file may be a Qedit file or a standard Ascii file. The latter can be built with the MPE Build command. :File equations are also allowed, such as: :file xyzzy=myfile.mygroup.myacct :run xpedit.pub.robelle;info="*xyzzy" Note that editing files over NS does not work. _______ _ _____ ______ Chapter 3 Using Xpedit 7 _______ ___ _____ Editing New Files If the file that you specify to edit does not already exist, Xpedit will create a new file for you. The new file will have a limit of 1023 78-byte Ascii records. Xpedit will create an empty file without records if you do not enter any data. Upon exiting Xpedit, it will issue a warning: Xpedit has created a new file: ___________________ filename.group.acct You may assign different attributes to the file with a :File equation, prior to entering Xpedit. For example, :file xyzzy;rec=-50,,f,ascii;disc=512 :xpedit *xyzzy In the above example, Xpedit will create the new file ________________________ xyzzy.yourgroup.youracct with a record width of 50 bytes and a maximum file size of 512 records. _____ ________ ___ ______ Files Suitable for Xpedit Before Xpedit allows you to edit your file, it will check to see if it can be edited safely. If the lines are longer than 78 characters, Xpedit will prompt the user with a message similar to this: Warning: Some lines of your message are too long to edit with Xpedit. The maximum line length is 78 characters. Your 18 line file has 2 lines which exceed this length. If you continue, they will be truncated (chopped off). Do you want to continue [no] ? If you answer 'No' to the above question, Xpedit will stop. If you answer 'Yes', then the lines that exceed the length of 78 characters will be truncated when editing proceeds. What if you make a mistake and type 'Yes' by accident? Xpedit has a function to ignore all changes to a file, which we will discuss later on. Xpedit can only edit Qedit files, or those that are Ascii, of fixed record length, and containing less than 500 records. If the file does not conform to these rules, Xpedit will display an error message and exit right away. _____ ____ _____ _______ Files With Short Records The standard record width for an Xpedit file is 78 characters wide. Xpedit has the capability to edit files with records whose lengths are less than 78 characters. Records lengths greater than ____ ______ __ ____ 78 can also be edited, but any existing data past column 78 will __ ____ be lost. _______ _ _____ ______ 8 Chapter 3 Using Xpedit The full-screen size of Xpedit will not change for files whose record lengths are less than 78. Xpedit will display an error message if the user enters data past the record length and presses _____ the Enter key or a function key. The user must correct the situation before Xpedit will allow the user to continue. _____ __________ ____ ______ Files Containing File Labels Files that contain file labels or have non-zero file codes can be edited with Xpedit. For example, this enables users to edit self-describing files. Self-describing files are created by Quiz, Query and Suprtool, to name just a few applications. ______ ____ Binary Data The editing of binary data is not supported, and Xpedit will not display the data correctly. Saving changes to such a file will corrupt the data. _____ _____ Qedit Files Xpedit has the ability to edit files that are produced by Robelle's text editor, Qedit. These files have a file code of 111, with a physical record length of 256. The data in Qedit files is compressed to allow many logical records to fit into the physical record. Xpedit can still only edit files whose internal logical length is no greater than 78 characters. Xpedit will preserve the rest of the attributes of the Qedit file, such as language type, ZZ marker, last line edited, etc. ______ ________ _____ Xpedit Internal Files Xpedit uses some temporary files to do its work. These are: Xptwork Formlist The last file in the list, Formlist, may conflict with some of your current applications. This file name is used by VPLUS. If templates are used within Xpedit, the program will reset any file commands that are associated with Formlist. 9 _______ _ ________ _______ _______ _________ Chapter 4 Standard Editing Without Templates _ ______ ______ ü Screen Layout _ ________ ____ ü Entering Data _ _______ ______ ü Leaving Xpedit _ ___ ____ ______ ü The Exit Screen _ _____ ___ ________ ____ ü Using the Function Keys _ _________ ___ ________ _____ ü Inserting and Deleting Lines _ ___ ____ ______ ü The Edit Marker _ ___ ____ ______ ü The Page Marker _ _______ ____ ü On-Line Help ______ ______ Screen Layout Enter your text, then press 'enter' or any function key. ________________________________________________________ Lines 1 through 18 displayed. 18 lines in your message. *********************** TOP OF MESSAGE ************************ _______________________________________________________________ This is some sample text to show _______________________________________________________________ how the main edit screen looks like. _______________________________________________________________ _______________________________________________________________ _______________________________________________________________ _______________________________________________________________ _______________________________________________________________ _______________________________________________________________ _______________________________________________________________ _______________________________________________________________ _______________________________________________________________ _______________________________________________________________ ********************** BOTTOM OF MESSAGE ********************** ---+---1---+---2---+---3---+---4---+---5---+---6---+---7---+--- ======= ======= ======= ======= ======= ======= ======= ======= Exit Edit Help Prev Next Next Exit Keys Page Page 1/2 Page ======= ======= ======= ======= ======= ======= ======= ======= Figure 1. Xpedit Main Screen _______ _ ________ _______ _______ _________ 10 Chapter 4 Standard Editing Without Templates ________ ____ Entering Data After the main edit screen is displayed, you are ready to enter new data or change existing data, if any. Editing keys that you can use on this screen are as follows: Insert Character Delete Character cursor keys Clear Line Clear Display Tab Forward Tab Backward Home ______ Editing keys that you cannot use are below: Insert Line Delete Line End Page Up Page Down Control-S and Control-Q The second line of the main edit screen lets you know how many lines are in your file. Xpedit calls your data file a 'message', because the program was originally written as an electronic mail ______ _ editor. In Figure 1, the second line shows "Lines 1 through 18 displayed. 18 lines in your message." The first part is telling you what lines from your message are being shown on the screen, in this case, lines 1 through 18. Blank lines at the end of your message count in the totals as well. The second part tells you how many lines long your message is so far. Xpedit will remove any blank lines from the end of the ___ message - they will not be written to the file. To enter data, just start typing. When you get to the end of a line, your cursor will automatically jump to the start of the next ______ ___ line. You can also use the Return key or the Tab key to get to the beginning of the next line as well. _____ To have the computer accept your data, press either the Enter key, or one of the function keys. Your data will always be updated, no matter which function key you press, including the function key _________ __ used to exit. Two keys that break this rule are F1-Marker Up and _________ ____ F2-Marker Down, but we will talk about that later in the chapter. _______ _ ________ _______ _______ _________ Chapter 4 Standard Editing Without Templates 11 _______ ______ Leaving Xpedit Once you have typed in your data and edited it if necessary, you need to get out of Xpedit. First press one of the exit keys, _______ _______ either F1-EXIT or F8-EXIT. There are two exit keys because some people are used to pressing F8 to exit, others F1. They do exactly the same thing, so use the one you're most comfortable with. Note that if you have not made any changes to your file, Xpedit will skip the exit screen and exit right away. It will also display the message, *** XPEDIT WARNING: No changes to your file detected. *** ___ ____ ______ The Exit Screen At this point Xpedit asks you what you want to do with your data. About to EXIT Xpedit. Make a choice and press a function key. ________________________________________________________ Lines 1 through 18 displayed. 18 lines in your message. *********************** TOP OF MESSAGE ************************ _______________________________________________________________ This is some sample text to show _______________________________________________________________ how the exit screen looks like. _______________________________________________________________ _______________________________________________________________ _______________________________________________________________ _______________________________________________________________ _______________________________________________________________ _______________________________________________________________ _______________________________________________________________ _______________________________________________________________ _______________________________________________________________ _______________________________________________________________ ********************** BOTTOM OF MESSAGE ********************** ---+---1---+---2---+---3---+---4---+---5---+---6---+---7---+--- ======= ======= ======= ======= ======= ======= ======= ======= Save Forget Edit Save and Exit Changes Document and Exit ======= ======= ======= ======= ======= ======= ======= ======= Figure 2. Xpedit Exit Screen Xpedit will prevent you from typing any new characters into the area where your data appears. At this point, you must press a function key to continue. _______ _ ________ _______ _______ _________ 12 Chapter 4 Standard Editing Without Templates ____ ___ ____ Save and Exit _______ ___ ____ _______ ___ ____ Pressing either of the keys F1-Save and Exit or F8-Save and Exit will save all of the changes that you have made to your file, and then exit Xpedit. ____ _______ ______ _______ Exit Without Saving Changes _________ _______ The F4-Forget Changes key allows you to restart from the beginning, or simply forget about all that you have done inside of Xpedit. It also exits right out of Xpedit. _____ ____ Don't Exit _______ ________ Use the F5-Edit Document key when you realize that you aren't _______ finished editing yet. Perhaps you accidentally hit the F1-Exit or _______ F8-Exit key when you were editing your text. Your message is not _______ ________ lost. At this point, when you hit the F5-Edit Document key, you will go back to editing your file again, with all of your previous changes and additions still there. _____ ___ ________ ____ Using the Function Keys You use the function keys in Xpedit to move around inside of your document, to add or delete lines, or to exit the program. They are, in numerical order: __ _ ____ F1 - Exit Press this key to exit Xpedit. The program will then display the _______ exit screen. This does the same thing as F8-Exit. __ _ _______ ____ F2 - Editing Keys Press this function key to insert and/or delete lines. This _________ ___ function will be discussed in detail in the section Inserting and ________ _____ Deleting Lines. __ F3 This key is blank, and does nothing. It is reserved for future versions of Xpedit. _______ _ ________ _______ _______ _________ Chapter 4 Standard Editing Without Templates 13 __ _ ____ F4 - Help Press this function key to enter the on-line help facility. Some new function key labels will be displayed. These are the help _______ ____ subjects. Press F8-Exit Help to continue editing your file. __ _ ____ ____ F5 - Prev Page Press this function key to display your previous page of text, if there is one. __ _ ____ ____________ F6 - Next Page/AddPage Press this function key to display your next page of text. If there is no next page, it will add 18 blank lines to the end of your text. __ _ ____ ___ ____ F7 - Next 1/2 Page ______ ____ Press this function key to perform a scroll (SCreen ROLL) up by half a page (9 lines). __ _ ____ F8 - Exit Press this key to exit Xpedit. The program will then display the _______ exit screen. This does the same thing as F1-Exit. _________ ___ ________ _____ Inserting and Deleting Lines ______ ____ ______ ____ In Xpedit, the terminal's Delete Line and Insert Line keys do not work. Since you may need to do these operations occasionally, __________ ____ Xpedit has a function key labeled F2-Editing Keys. When this key is pressed, a new set of function key labels will appear. These new keys are as follows: __ _ ______ __ F1 - Marker Up Moves the edit marker up by one line (details follow). __ _ ______ ____ F2 - Marker Down Moves the edit marker down by one line. _______ _ ________ _______ _______ _________ 14 Chapter 4 Standard Editing Without Templates __ _ ______ _ _____ F3 - Insert 3 Lines Inserts three blank lines before the line marked by the edit marker. __ _ ______ _ ____ F4 - Delete 1 Line Deletes the line marked by the edit marker. ___ ___ __ F5, F6, F7 These keys are unchanged from the main set, and allow you to move around in your document. __ _ ____ ____ F8 - Main Keys Turns off insert/delete mode and returns you to the main set of function keys. ___ ____ ______ The Edit Marker In addition to the editing function keys, a highlighted line enhancement will appear in the text area. This line is called the edit marker. The edit marker is also indicated by a "<" at the end of the line, in case your terminal cannot display different enhancements. You use the edit marker to point to the line in your document _________ _ _____ where you will insert or delete lines. Pressing F3-Insert 3 Lines will insert 3 blank lines before the edit marker. Pressing _________ _ ____ F4-Delete 1 Line will delete the line that is directly pointed to by the edit marker. _________ __ _________ ____ Pressing F1-Marker Up or F2-Marker Down does not transmit the contents of the screen to the computer - these keys only move the edit marker up and down. When the edit marker gets to the top or bottom of the screen, pressing the function key that would move it out of the text area actually causes the edit marker to jump. If it is at the top of the screen, it jumps to the bottom; if it is at the bottom, it jumps to the top. _______ ____ To re-display the main function keys, press the F8-Main Keys function key. _______ _ ________ _______ _______ _________ Chapter 4 Standard Editing Without Templates 15 Enter your text, then press 'enter' or any function key. ________________________________________________________ Lines 1 through 18 displayed. 18 lines in your message. *********************** TOP OF MESSAGE *********************** ______________________________________________________________ This is some sample text to show ______________________________________________________________ how the edit marker looks < ______________________________________________________________ on an Xpedit Screen. ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ********************** BOTTOM OF MESSAGE ********************* ---+---1---+---2---+---3---+---4---+---5---+---6---+---7---+--- ======= ======= ======= ======= ======= ======= ======= ======= Marker Marker Insert Delete Prev NextPage Next Main Up Down 3 Lines 1 Line Page AddPage Page Keys ======= ======= ======= ======= ======= ======= ======= ======= Figure 3. Xpedit Main Screen with edit keys and edit marker ___ ____ ______ The Page Marker Although Xpedit has no capability to print pages, it can show what line would be at the top of a page if you print the file outside of Xpedit. You must first set a JCW called XPPageMarker to the number of lines on your page. XPPageMarker may have a value between 0 and 32767. Setting the JCW to 0, or not defining it, will disable the page marker feature. The page marker will appear as an asterisk (*) next to the line that is at the top of the printed page. If the edit marker is on the same line, it will appear as a plus sign (+). For example, if we were editing a file to be used as output to a printer that contained labels, the page length may be six. We would set the page marker JCW as below: :SETJCW XPPageMarker 6 The screen of an Xpedit editing session might look like that shown in figure 4. _______ _ ________ _______ _______ _________ 16 Chapter 4 Standard Editing Without Templates Enter your text, then press 'enter' or any function key. ________________________________________________________ Lines 1 through 18 displayed. 18 lines in your message. *********************** TOP OF MESSAGE *********************** ______________________________________________________________ This is some sample text to show * ______________________________________________________________ how the edit marker looks < ______________________________________________________________ on an Xpedit Screen. ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ * ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ______________________________________________________________ ********************** BOTTOM OF MESSAGE ********************* ---+---1---+---2---+---3---+---4---+---5---+---6---+---7---+--- ======= ======= ======= ======= ======= ======= ======= ======= Marker Marker Insert Delete Prev NextPage Next Main Up Down 3 Lines 1 Line Page AddPage Page Keys ======= ======= ======= ======= ======= ======= ======= ======= Figure 4. Xpedit Main Screen with edit keys, edit marker, and page marker _______ ____ On-Line Help On-line help is available from the main edit screen by pressing _______ the F4-Help function key. _____ __ ___ ____ ____ ____ __ ________ _____ _______ ____ __ ___ Note: If the Edit Keys menu is showing, press F8-Main Keys to get __ ___ ____ ____ _____ to the Main Keys menu. The main edit screen will be replaced with the 'quick help' screen. Each function key inside help has a different meaning than in the main edit screen. For example, F1 always displays Quick Help, F2 displays a screen on the Screen Layout, F3 displays a screen on Insert and Delete, and so on. _______ ____ To resume editing your file, press F8-Exit Help and the main edit screen will be re-displayed at the point where you left off. 17 _______ _ _______ _____ _________ Chapter 5 Editing Using Templates _ ________ ü Overview _ ________ __ ü Starting Up _ ________ ____ _______ ü Template Menu Choices _ ________ ___ ___ _______ ____ ü Example: The Job Request Form _ _________ ____ _____ ü Canceling Your Edits _ ________ ______ __________ ü Template Design Guidelines ________ Overview Templates can be useful for a number of applications. For example, the generation of a data center job request form. The user would be required to enter a job name, when the job should be run, and special operating instructions. Another example is using a standard form to generate input to an application such as a fax board interface. Keywords are required to tell the fax board software which telephone number to dial, the address, number of copies, etc. To use templates with Xpedit, issue the following :File equation: ________ ________ ____ file xptempla=template formfile name Xpedit is still run with an input file. The input file's record size must be large enough to accommodate the width of the largest form in the template forms file. In the following discussion the examples refer to the forms files included in the Robelle account. These files are: Template.Xpeddata.Robelle {Compiled forms file} Templatf.Xpeddata.Robelle {Source forms file} ________ __ Starting Up After issuing the commands, build xyzzy;rec=-80,,f,ascii file xptempla=template.xpeddata.robelle run xpedit.pub.robelle;info="xyzzy" the Xpedit banner will be displayed, and a template selection screen will be shown. Please see figure 5. _______ _ _______ _____ _________ 18 Chapter 5 Editing Using Templates ______________________________________________________________ Please enter a template number, then press the 'enter' key. [ ] 1. Edit Message X. Exit 2. Fax 3000 3. Job Request 4. Standard Memo ======= ======= ======= ======= ======= ======= ======= ======= Edit Fax 3000 Job Standard Exit Message Request Memo ======= ======= ======= ======= ======= ======= ======= ======= Figure 5. Template selection screen ________ ____ _______ Template Menu Choices The user is presented with a screen of template choices. Among these is Edit Message and Exit. Entering '1' as a choice or _______ _______ pressing F1-Edit Message will invoke the regular Xpedit function, without a template. _______ Entering 'X' as a choice or pressing F8-Exit will exit Xpedit. Edit template choices start at number 2. The maximum number of templates that Xpedit will use is 30. To select a template, the user may either enter its number, or press a corresponding _ _ ___ function key. In our example file, the assignments are 2 - Fax ____ _ _ ___ _______ _ _ ________ ____ 3000, 3 - Job Request and 4 - Standard Memo. Pressing F2, F3 or F4 will select one of these entries. _______ _ _______ _____ _________ Chapter 5 Editing Using Templates 19 ________ ___ ___ _______ ____ Example: The Job Request Form Xpedit 1.7 JOB_____REQUEST Robelle Solutions Technology Inc. 3:38 PM Job Request Form Fill in all appropriate fields, then submit to SYSTEM MANAGER. ____________________________________________ Your Department: [ ] ____________________________________________ Telephone: [ ] _ Priority: [L] L=Low, M=Medium, R=Rush, Y=Yesterday ____________ ________ When to run the job: Date: [ ] Time: [ ] _____________________ Estimated Run Time: [ ] _ ________ Contact on Abort? [ ] (Y/N) Home Phone if Yes: [ ] ____________________________________ Fully Qualified Jobname: [ ] Additional Operator Instructions: _____________________________________________________________ [ ] _____________________________________________________________ [ ] _____________________________________________________________ [ ] _____________________________________________________________ [ ] _____________________________________________________________ [ ] ======= ======= ======= ======= ======= ======= ======= ======= Save Cancel Full Save & Exit Edit & Exit ======= ======= ======= ======= ======= ======= ======= ======= Figure 6. Job Request Template Fill in the appropriate input fields, and then press either _______ ___ ____ _______ ___ ____ function key F1-Save and Exit or F8-Save and Exit to save the screen to the file Xyzzy. Xpedit uses many of the features of VPLUS, including forms editing specifications. For example, if the enter key is pressed in the Job Request template without filling in any fields, the message, "You must enter your department name" will appear in the window. This editing was specified using Formspec. _________ ____ _____ Canceling Your Edits As long as any of the local screen edits fails, exit is _________ disallowed. To exit regardless, press F4-Cancel. This will change the function keys to the following: __ _ ____ ___ ____ F1 - Save and Exit This has the same purpose as in non-template editing. After saving the message, Xpedit terminates. _______ _ _______ _____ _________ 20 Chapter 5 Editing Using Templates __ _ ______ _ ____ ____ F3 - Cancel / Main Menu This key cancels the editing of the current template and returns control to the template selection menu. __ _ ______ _ ____ F4 - Cancel / Exit This key cancels the editing of the current template and exits Xpedit. __ _ ____ ___ ____ F8 - Save and Exit This has the same purpose as in non-template editing. After saving the message, Xpedit terminates. Pressing any other function key or hitting enter will abort the cancel. ________ ______ __________ Template Design Guidelines Template forms files are created using the HP-supplied utility, Formspec.Pub.Sys. Documentation about this program is covered in ____ _____ ___ _____ __________ ______ _______ the HP manual, Data Entry and Forms Management System (VPLUS). This utility is simple to learn, and offers complex editing ___ features for forms. Xpedit does not support the freeze/append option on forms. Any labels defined will be ignored, as Xpedit uses its own labels. ________ ____ _____ Template Form Names Xpedit tries to put the names of the first six forms of the template file into the function keys on screen. It is suggested that you name your forms so that their names are readable around the break - after the eighth character. For example, naming a form that contains a memo template: memo_template is shown as Memo Tem plate but standard_memo becomes Standard Memo Xpedit will always display the form names in the template selection screen in alphabetical order. This is a side-effect of the way Formspec works. When you add a form into the forms file using Formspec, it will insert the form alphabetically. _______ _ _______ _____ _________ Chapter 5 Editing Using Templates 21 ________ _______ _______ ______ Template Message Display Window We suggest that you place the window display line at the top of the screen, to match Xpedit's message window. Formspec's default is to put the window display line on line 24. You can change this in the Globals menu in Formspec. _____ ___ ____ _______ ___ Using the Line Drawing Set During the design phase of a form, the line drawing set can be activated by typing a Control-N and then any characters. This can make wonderful-looking screens. However, the drawback is that Xpedit cannot transmit these characters to the edit file. What appears as a solid line in the displayed screen can become a row of commas in the edit file. Underscore characters will remain as underscores. _____ ____ __________ Field Edit Processing Xpedit will perform any field edits that are required, including initialization. The field edits that are used most often in standard Formspec forms processing are: UPSHIFT JUSTIFY LEFT IF $EMPTY THEN FAIL "You must enter a value for xxxxxxxx". When a user error is encountered, Xpedit will highlight the erroneous field. It will then put the message from the FAIL processing instruction (or from the standard VPLUS catalog) into the window. 22 _______ _ ______ ___ ______ _____ Chapter 6 Xpedit for Xpress Users _ ___ ___ _____ _______ ü Are You Using Xpedit? _ ________ _ _______ ü Creating a Message _ _________ __ ______ ü Returning to Xpress _ _____ ______ __ _____ _______ ü Using Xpedit in Other Baskets _ _________ ______ ___ ______ ü Configure Xpedit for Xpress There are two ways to create messages in Xpress: using Xpress's built-in message-writer, and using the editor configured for you by your Xpress manager, Helpman. You may use Xpedit anywhere you can edit a message in Xpress. Possibly the most common example of creating a new message using an editor is when you want to send a message to someone else from ___ ______ your Out Basket. ___ ____ __ ____ _______ __ _ ________ ___ _____ ______ ____ The rest of this chapter is a tutorial for using Xpedit with _______ ___ ________ ___ __ __ ______ __ __ _ _________ ________ Xpress, and requires you to be logged on to a terminal. Actions, ______ ____ ______ ____ ____ ___ __________ ___ __ ___ _______ better than words, will help you understand how to use Xpedit. ___ ___ _____ _______ Are You Using Xpedit? To see if you are configured to use Xpedit, try the following on your terminal. If you already know that you are configured to use ________ _ _______ Xpedit, you can skip this part and proceed to Creating a Message. 1. Start up Xpress as you normally would. ______ ______ 2. Press F3-Out Basket. ______ ______ 3. Press F3-Out Basket a second time. This will tell Xpress to use your configured editor to create a message. 4. Type a subject and press Return. If you are already configured to use Xpedit as your editor, the Xpedit program banner will appear and then your screen will show you a blank Xpedit screen. It is possible that you are configured to use templates, in which case the Xpedit template menu will appear. If this occurs, press the F1 function key. If you see the Xpedit screen, you pass the test. To return to _______ _________ _______ Xpress, press F1-Exit, then press F4-Forget Changes. This will display a warning message, which you can ignore for now. If you did not see the Xpedit screen, please exit your editor, and return to Xpress. For most editors, you type E to exit. Once you _______ _ ______ ___ ______ _____ Chapter 6 Xpedit for Xpress Users 23 are back in Xpress, send Helpman a message asking to have Xpedit configured as your editor. Then come back to this manual. ________ _ _______ Creating a Message Start up Xpress as you normally would, then run through the ___ _______ following steps to create a new message in the Out Basket. 1. Select option 3, Out Basket. 2. Xpress will ask you what you want to do; you want to Edit, option 6. So type in "6". ___ ______ 3. Xpress will want to know which of your Out Basket messages you want to edit. You want to create a new message using Xpedit, so type in "1". 4. Then type in a subject for the new message and press Return. A message will appear on your screen displaying the Xpedit banner. Your screen will then blank out and proceed to display the main ______ _ Xpedit screen. This is shown in the manual in Figure 1. Try typing in a few lines. This will be your message. You can ______ _________ ______ _________ use the Insert Character and Delete Character keys of your ___ terminal to edit your text if you wish, as well as the Tab and ______ ___ cursor keys. You can use the Tab key to get to the beginning of ______ the next line quickly, as well as the Return key. _______ When you are finished entering your message, press F1-Exit or _______ F8-Exit. _________ __ ______ Returning to Xpress Once you have typed in your message, and edited it if necessary, you have to get the message back to Xpress. First press one of _______ _______ the exit keys, either F1-EXIT or F8-EXIT. There are two exit keys because some people are used to pressing F1 to exit, others F8. They do exactly the same thing, so use the one you're most comfortable with. After you have pressed one of the exit keys, a new screen will be displayed. At this point Xpedit is asking you what you want to do with your message. __ _ ____ ___ ____ Press F1 - Save and Exit to save your message and return control to Xpress. Once back inside Xpress, try sending this message to yourself, and __ ______ then look for it in your In Basket. Read it over to see that what you wrote is what you sent. _______ _ ______ ___ ______ _____ 24 Chapter 6 Xpedit for Xpress Users _____ ______ __ _____ _______ Using Xpedit in Other Baskets You may use Xpedit in Xpress wherever where you need to compose a _____________ message. For example, you may use Xpedit to create Bring-Forward ________ _____ ______ messages, Bulletin Board messages, or messages in your Filing _______ Cabinet. You may also use Xpedit to edit existing messages, using option 6 in any basket. _________ ______ ___ ______ Configure Xpedit for Xpress ___________ ______ ________ ______ See the Configuring Xpress chapter of the Managing Xpress __________ ____ Electronic Mail manual for details. 25 _______ _ _________ ______ ___ ______ Chapter 7 Configure Xpedit for HPDesk To change the default editor in HPDesk, you need to modify your individual Profile. To do this, enter HPDesk as you usually would. From the main menu (choice 0), select option 10 (Admin.). From the administration menu, select F2 (Profile). From the profile menu, select F2 again (Next Options). You should see a screen similar to this: Edit and Create Options _ Entry method for creating messages/comments ... [ ] _ Entry method for creating text items ... [ ] _ Editor for editing text items [ ] Values can be: 1. Line by line text entry 2. Screen text entry 3. Slate editor 4. HPWORD or screen for non-HP terminals __________________________ 5. External editor You must make two sets of changes to this menu. First, you must enter "Xpedit.Pub.Robelle" for the external editor (option 5). Second, change the editor option to 5 for the first three items, then press enter. After your changes, the screen should look like the following: Edit and Create Options _ Entry method for creating messages/comments ... [5] _ Entry method for creating text items ... [5] _ Editor for editing text items [5] Values can be: 1. Line by line text entry 2. Screen text entry 3. Slate editor 4. HPWORD or screen for non-HP terminals _________________________ 5. External editor Xpedit.Pub.Robelle 26 _______ _ _________ ___ ______ ___________ Chapter 8 Configure the Xpedit Environment _ ____ ____ _______ ______ ü JCWs That Control Xpedit _ ________ __________ ü Run-Time Parameters _ ______ ______ ____ ________ ü Xpedit Allows File Commands There are several Job Control Words (JCWs) that can control the way Xpedit works. Xpedit can also be affected by a :File equation for the edit file, as well as by the value passed in the Parm= run-time parameter. ____ ____ _______ ______ JCWs That Control Xpedit ____________ _ XPPageMarker n Xpedit can display an "*" next to the line that will be at the top of a printed page. You must set the number of lines per page for XPPageMarker. If the JCW is missing or set to zero, the "*" will not be displayed. __________ _ _ _ XPSkipHPTA 0 | 1 Upon startup, Xpedit will try to detect and disable HP type-ahead. Occasionally, this may cause problems with communications equipment such as network cards or multiplexers that do not support the detection of HP type-ahead. You may disable this feature by setting XPSkipHPTA to 1. Note that HP type-ahead is only applicable to MPE/iX platforms. ______________ _ _ _ XPSkipFkeySave 0 | 1 Upon startup, Xpedit will attempt to save the user-defined function keys. Occasionally, this may cause problems with communications equipment such as network cards or multiplexers that do not support saving of keys. Disable this feature by setting XPSkipFkeySave to 1. _______________ _ _ _ XPDisableAutoLF 0 | 1 Upon startup, Xpedit will attempt to turn on the auto-linefeed function of the terminal. Some terminals do not support this function, such as "dumb" terminals emulating HP 2624Bs with software (e.g., PreView, from Unison/Tymlabs). With these terminals, set XPDisableAutoLF to 1. _______ _ _________ ___ ______ ___________ Chapter 8 Configure the Xpedit Environment 27 ___________ ______ XPForceForm number You may force Xpedit to edit the input file with a particular form by setting this JCW to a number greater than 1. The form selected will be the one that is normally displayed in the Xpedit forms selection menu. If the JCW is set to zero, or is not present, Xpedit will perform its operations in the normal manner. Setting the JCW to 1 will cause Xpedit to skip the forms selection screen entirely, editing the input file with the Xpedit editor. ____________ XpeditStatus Xpedit sets this JCW upon exiting. It will be set to either zero upon successful exiting, or to -1 if Xpedit is aborted for any reason. For example, this JCW is set to -1 if users reply "no" when Xpedit asks them if they want to edit a file that is wider than 78 characters. ________ __________ Run-Time Parameters Xpedit has the ability to suspend instead of killing its process upon exiting. There are several advantages to suspending: ü You use less resources to start-up Xpedit again. ü You save some time getting back into Xpedit. ü You will always edit the same file name. The following Run statement shows how to run Xpedit so that it suspends: _____ run xpedit.pub.robelle;parm=1;info="xyzzy" When Xpedit suspends, the forms file and catalog file are not closed. Upon re-activation, much of the initialization code is bypassed. Due to the way that MPE works, the info parameter passed to Xpedit cannot be changed. Therefore, the same file name will be opened for editing. The process calling Xpedit (such as Xpress or Qedit) must be able to detect that the child process has suspended, to enable it to activate rather than re-run Xpedit. Xpedit will not suspend if run from the MPE Command Interpreter. _______ _ _________ ___ ______ ___________ 28 Chapter 8 Configure the Xpedit Environment ______ ______ ____ ________ Xpedit Allows File Commands If you would like to suspend Xpedit but want to edit a different file each time, we suggest using a :File equation and editing the *file. For example: ________ parm filename file editfile=!filename _________ run xpedit.pub.robelle;parm=1;info="*editfile" The above command file tells Xpedit to edit the file pointed to by _________ *editfile. This command file will work inside Qedit. 29 _______ _ __________ ______ Chapter 9 Installing Xpedit _ ____ __ _______ ___ _______ _______ ü Step 1: Upgrade the Robelle Account _ ____ __ _______ ___ _____ ü Step 2: Restore the Files _ ____ __ _______ ___ _______ ü Step 3: Install the Program _ ______ _____ ü Xpedit Files _ ________ _____________ ü Printing Documentation There are three steps for installing the Xpedit program on your system. If you received Xpedit along with another Robelle product, you may have already streamed Bonus.Job.Robelle. This job stream installs all of the Bonus programs, including Xpedit. If you received Xpedit with another Robelle product and have not streamed yet Bonus.Job.Robelle, follow the installation steps for that product first. Then skip these first two steps and do step 3. 1. Upgrade the Robelle account. 2. Restore the files from the tape. 3. Install the files into production. For steps 1 and 2, log on as Manager.Sys. For step 3, log on as Mgr.Robelle. ____ __ _______ ___ _______ _______ Step 1: Upgrade the Robelle Account Even if you already have the Robelle account, the first thing you must do is stream the Robelle job. This ensures that any new groups that we need will be built with the proper capabilities and security. :hello manager.sys :file robtape;dev=tape :restore *robtape; robelle.job.robelle; create :run qedit.pub.robelle {or use :Editor} /text robelle.job.robelle /modify first {Manager.Sys password} /change "XXXX","password",ALL {Robelle acct. password} /keep robtemp /exit :stream robtemp :purge robtemp {file has passwords} This job stream launches a second job, which will send you a message when it has completed. _______ _ __________ ______ 30 Chapter 9 Installing Xpedit ____ __ _______ ___ _____ Step 2: Restore the Files Stay logged on as Manager.Sys and restore the Robelle files: :file robtape;dev=tape :restore *robtape;@.@.robelle;show ____ __ _______ ___ _______ Step 3: Install the Program The installation job renames the Xpedit program from either XpeditCM or XpeditNM in the Pub group to be Xpedit.Pub.Robelle. It also copies data files from the Xpeddupd group to Xpeddata. No one can be using the Xpedit program or files during installation. Warn people not to use Xpedit for a while, and then stream our installation job: :hello mgr.robelle :warn @ Please stop using Xpedit NOW! :run qedit.pub {or use :Editor} /text install.xpedjob /modify first {Mgr.Robelle passwords} /keep robtemp /exit :stream robtemp :purge robtemp {file has passwords} The job will send a message to the console when it completes successfully. If you do not get the message, check the installation job $Stdlist. If anyone was using Xpedit or the other files, or attempting to back them up, the job will have failed. Chase away any users, ensure that backup is not in progress, then stream the installation job again. (Hint: Xpress or other programs can "suspend" Xpedit, making it appear to the user that they are not using Xpedit, when in fact they are. Have the users get out of the program that is suspending Xpedit.) After the installation job completes, you are ready to use this new version of Xpedit. ________ :run xpedit.pub.robelle;info="filename" ______ _____ Xpedit Files Xpedit consists of five types of files: the programs, a message catalog, VPLUS forms files, a documentation file and a help file. xpedit.pub.robelle {program} xpeditcm.pub.robelle {CM program} xpeditnm.pub.robelle {NM program} catalog.xpeddata.robelle {message catalog} vfast.xpeddata.robelle {forms file} templatf.xpeddata.robelle {template source forms file} _______ _ __________ ______ Chapter 9 Installing Xpedit 31 template.xpeddata.robelle {template fast forms file} xpedit.doc.robelle {user manual} xpedit.help.robelle {on-line help} If you want to save a few sectors of disc space, after the installation job completes you can stream the job called Cleanup.Purgejob.Robelle. This job removes all program files whose names end in CM or NM. After a successful installation these files are no longer necessary. ________ _____________ Printing Documentation As stated in the first chapter, printing the documentation is as easy as typing one MPE Run command. We format and print all of our manuals using Printdoc. This program utilizes Prose, a text formatter from Robelle, to print documents to a line printer or an HP LaserJet. If you have an HP LaserJet, your printed manuals can come out looking quite nice. Printdoc supports a number of font cartridges. Be prepared to answer a few questions about your printer. 32 ________ _ _ ________ Appendix A - Messages Xpress keeps you informed of its progress, usually via the VPLUS message window at the top of the screen, and occasionally while you enter and exit from full-screen mode. Some of these messages are simply status information; others warn you of situations where Xpedit cannot understand what you want to do; and others tell you, postmortem, that Xpedit has terminated in some spectacular way. ________ ___ ______ Warnings and Errors The following is a list of warnings or error messages which may appear either in line mode or on line 1 (the status line) in the Xpedit main screen. ________ ____ _____ __ ____ _______ ___ ___ ____ __ ____ ____ _______ Warning: Some lines of your message are too long to edit with Xpedit. ___ _______ ____ ______ __ __ ___________ The maximum line length is 78 characters. ____ _ ____ ____ ___ _ _____ _____ ______ ____ _______ Your x line file has y lines which exceed this length. __ ___ _________ ____ ____ __ _________ ________ _____ If you continue, they will be truncated (chopped off). __ ___ ____ __ ________ ____ _ Do you want to continue [no] ? Xpedit has detected some lines in your file where some characters occur past column 78. If you do not care that you will lose those characters then answer 'yes', otherwise, 'no'. If you answer 'no', Xpedit will not let you edit your file. If you answer 'yes', Xpedit will remove those characters past column 78. ___ ___________ _______ ____ ____ ____ _ ___________ ______ _____ The highlighted line(s) have more than n characters. Change them. This message will appear only when editing files whose record size is less than 78 characters. If the user enters more characters on a line than can fit in the record, Xpedit will highlight the line _____ when a function key or Enter key is pressed. The line must be corrected before continuing. _____ _ _______ _ __________ _ _____ __ ____ ________ Lines x through y displayed. z lines in your message. This screen is showing line x through line y of your file, which contains a total of z lines. ___ ______ ____ ____ ____ ___ ______ ____ _______ _____ ______ ___ You cannot edit more than 500 lines. This command would exceed the ______ limit! _______ ____ You have either pressed F6-Next Page or tried to insert lines which would cause the number of lines in your file to exceed 500. Xpedit cannot edit more than 500 lines at a time. ________ _ _ ________ Appendix A - Messages 33 __ _____ ____ __ ___ ________ ______ _______ __ ___ __ ________ F5 can't page up any further. You're already at TOP OF MESSAGE. The data that you see on the screen is at the beginning of the file. __ _____ ____ ____ ___ ________ ___ __ __ ___ ____ _____ _____ __ ___ F7 can't page down any further. Use F6 to add more blank lines if you _____ wish. _______ ___ ____ The F7-Next 1/2 Page key does not add blank lines the way that F6 does. Press F6 if you wish to add more blank lines to the end of your file. ______ ___ _______ _ ___ _____ ___________________ Xpedit has created a new file: filename.group.acct A file name was specified in the Run statement that did not already exist. Xpedit has created a new file for you. ___ ______ ______ ____ ____ _____ _____ *** Xpedit cannot open your input file. For some reason, Xpedit couldn't open your input file. A description of the reason will follow. ___ ______ ________ ____ _______ ____ ____ __________ ___ *** XPEDIT WARNING! Your changes have been discarded. *** _________ _______ F4-Forget Changes was pressed when exiting Xpedit. Your changes to the file were not saved. ___ ______ ________ __ _______ __ ____ ____ _________ ___ *** XPEDIT WARNING! No changes to your file detected. *** Xpedit did not detect any changes to your file. This can happen when no changes were performed. NOTE: If you change something, then change it back to the way it was, Xpedit will still think that a change has occurred. ____ __ ___ _ _____ ________ _______ ______ ___ ______ That is not a valid template number. Please try again. You must enter a number from 1 to the number of templates displayed. ___ _____ ____ __ _ ________ _______ _ __ __ ______ ___ ______ The input must be a template number, 1 or X. Please try again. You must enter a number from 1 to the number of templates displayed, or 1 to enter regular Xpedit, or X to exit the program. ________ _ _ ________ 34 Appendix A - Messages ________ ____ __ ____ ________ _____ ____ _______ ___ __ ___ ____ WARNING: Some of your template lines were chopped off at the end. Some lines on your template produced lines longer than 78 characters. This can occur when the line drawing set is used in creating the templates. Contact Helpman to change the templates so that this does not happen. ______ ___ ___ ___________ _____ __ ______ ____ ____ __ __ ___ ______ Error: The JCW XPFORCEFORM value is either less than -1 or too large. The XPForceForm JCW has been set to an incorrect value. Allowable values are -1, 0, or a number equal to a valid form sequence number. ________ ____ _____ ____ ________ _____ WARNING: Your input file contains data. ________ ___ ______ ___ _ __ _ ____ _____ ____ _____ _____ Choosing any option but 1 or X will erase your input file. This warning will appear on the template menu when the input file contains data. Choosing a template will cause the input data to be erased if a template is chosen and saved. To edit the message normally, choose option 1, regular Xpedit. To quit without any changes to the input file, select X for exit. ______ ______ Severe Errors In the unlikely event that a severe error occurs, Xpedit will lose the changes that are made to the data file. Xpedit will inform the user that this has happened by displaying the error message: __ Error Exit point: nn ***************** WARNING! ******************* *** XPEDIT Terminated: Changes Not Saved! *** ********************************************** The user should write down any accompanying error messages (or do a PSCREEN if possible), and ask your system manager to contact the Robelle technical support team for aid. ______ ____ ____ ___ ______ _______ ________ ERROR! Next Page Not Found! Contact Helpman. Contact Robelle. A program error has occurred. ______ ____ ____ ______ ___ _____ _ _____ _______ _____ ERROR! Last Edit Buffer too large - using current size. Contact Robelle. A program error has occurred. ________ _ _ ________ Appendix A - Messages 35 ______ ______ ____ ________ ______ ____ ___ ______ _______ ________ ERROR! Output file xpbuffer record size too small. Contact Helpman. The current form contains too many escape characters per line. Reduce its complexity. ______ ______ __ ____ ________ _____ _______ ________ ERROR! Unable to open xptempla file. Contact Helpman. Probable cause: user doesn't have read and execute access to the xptempla file. The xptempla file will be the template fast forms file. ______ ______ __ ____ ________ _____ _______ ________ ERROR! Unable to open xpbuffer file. Contact Helpman. Probable cause: user doesn't have SF (save file) capability. ___ ______ ______ ______ ________ _ *** Xpedit Error! HPTERM returned n ___ ____ ________ __ ___ _________ ___ *** This terminal is not supported *** Probable cause: running Xpedit on a non-HP compatible terminal. Xpedit will only run on HP block-mode terminals, HP compatible terminals, and PCs running HP terminal emulators. 36 _____ Index $empty processing..................21 _ A aborting Xpedit....................5 activate...........................27 _ B binary data........................8 block-mode.........................4 Bonus programs.....................1 Break key..........................5 Bring-Forward......................24 Bulletin Board.....................24 _ C configuring for HPDesk.............25 configuring for Xpress.............24 console............................5 Control-S and Control-Q............4,10 creating a message in Xpress.......23 creating template forms files......20 cursor keys........................4 _ D Delete Character key...............4 Delete Line key....................4,10 deleting lines.....................13 disabling auto-linefeed............26 disc space, saving.................31 discarding your message............12 display window.....................21 documentation, printing............2,31 DSlines, editing over..............6 _ E echo, terminal.....................5 edit marker........................14 editing keys.......................10,13 editing over NS....................6 editing Qedit files................8 editing records < 78 characters....32 _____ 37 Index editing using templates............17 empty processing...................21 emulator, terminal.................2 End key............................10 Enter key..........................4,10 entering data......................10 environment........................26 exit screen........................11 exiting Xpedit.....................11 _ F fail processing....................21 field edit processing..............21 figure 1...........................9 figure 2...........................11 figure 3...........................15 figure 4...........................16 figure 5...........................18 figure 6...........................19 figure explanation.................2 file attributes....................7 file commands......................7,28 file types.........................6 filecodes..........................8 files - internal...................8 files suitable for Xpedit..........7 files with file labels.............8 Filing Cabinet.....................24 forcing Xpedit to use a form.......27 form names.........................20 form sequence numbers..............27 formlist...........................8 Formspec...........................20 freeze/append forms................20 full-screen editing................1 function keys......................4,12 _ H help...............................13 how to install Xpedit..............29 HP LaserJet, documentation.........31 HP terminals.......................35 HP type-ahead......................26 HPDesk.............................25 _ I Insert Character key...............4 Insert Line key....................4,10 _____ Index 38 inserting lines....................13 Install.Xpedjob.Robelle............30 installing Xpedit..................29 internal files.....................8 _ J JCW XPDisableAutoLF................26 JCW XpeditStatus...................27 JCW XPForceForm....................27 JCW XPPageMarker...................26 JCW XPSkipFkeySave.................26 JCW XPSkipHPTA.....................26 JCWs that affect Xpedit............26 job request sample template........19 justify left processing............21 _ L LaserJet, documentation............31 leaving Xpedit.....................11 line drawing in templates..........21 _ M marker.............................14 maximum line length................7 maximum number of templates........18 menu choices.......................18 _ N new features.......................2 new files..........................7 no changes to your file............11 NS, editing over...................6 _ O on-line help.......................13,16 Out Basket.........................22 _ P page marker........................15,26 Page Up and Down keys..............10 parm=1.............................27 PC.................................2 _____ 39 Index PreView from Unison/Tymlabs........26 printdoc...........................2 printing the manual................2 _ Q Qedit files........................6 Qlib programs......................1 _ R record sizes < 78..................7 Reflection.........................2 required files.....................30 Return key.........................4,10 returning to Xpress................23 run Xpedit.........................6 running from the console...........5 _ S sample template - job request......19 saving disc space..................31 saving user labels.................26 saving your data...................12 self-describing files..............8 SF capability......................35 starting with templates............17 suspend............................27 _ T Tab key............................4,10 template design guidelines.........20 template form names................20 template forms file name...........6,17 template menu choices..............18 template sample file...............17 terminal echo......................5 terminal emulator..................2 truncation.........................7 _ U upshift processing.................21 _____ Index 40 _ V VPLUS..............................4 _ W Walker Richer & Quinn..............2 window display line................21 _ X XPDisableAutoLF JCW................26 Xpedit file limits.................6 Xpedit files.......................30 XpeditStatus JCW...................27 XPForceForm JCW....................27 XPPageMarker JCW...................26 Xpress.............................22 XPSkipFkeySave JCW.................26 XPSkipHPTA JCW.....................26 xptempla...........................17 xptempla access....................35 xptwork............................8 ______ _______ _____ Reader Comment Sheet ______ ___ ____ ______ XPEDIT 1.8 User Manual Your opinion of this manual is a valuable resource for helping us improve the quality of our documentation. We invite you to rate the manual on this form. Your Name: Date: Company: Position: Address: Phone: ______ ______ ___ ______ ___ _____ Please circle one number for each: ____ _______ ____ Good Average Poor ü General organization 1 2 3 ü Technical accuracy 1 2 3 ü Writing clarity 1 2 3 ü Convenience of size and format 1 2 3 ü Ease of locating information 1 2 3 ü Thoroughness of material 1 2 3 ü Quality of examples 1 2 3 ________ ___ ____________ _______ ___ ________ __ __________ Comments and suggestions: (please use reverse, or additional ______ __ _______ sheets as needed) _______________________________________________________________ _______________________________________________________________ _______________________________________________________________ _______________________________________________________________ _______________________________________________________________ Thank you for your feedback. We appreciate your time and interest. Please send your comments to us at one of the following numbers or addresses: Robelle Solutions Technology Inc. Toll-free: 1.888.robelle (1.888.762.3553) 7360 137 Street, Suite 372 Phone: 604.501.2001 Surrey, B.C. Canada V3W 1A3 Fax: 604.501.2003 E-mail: support@robelle.com Web: www.robelle.com iii ______ ____ ______ XPEDIT User Manual ________ Contents _______ _ _______ __ ______ Chapter 1 Welcome to Xpedit Introduction..........................1 Authorization to use Xpedit...........1 Documentation.........................2 Who should use this manual?...........2 Using a PC instead of a terminal......2 Highlights in 1.8.....................3 Highlights in 1.7.....................3 Highlights in 1.6.....................3 New features of version 1.5...........3 _______ _ ______ __ _ _____ ___________ Chapter 2 Xpedit is a VPLUS Application Overview..............................4 Using your terminal's editing keys....4 Break key.............................5 Running Xpedit from the console.......5 _______ _ _____ ______ Chapter 3 Using Xpedit Accessing Xpedit......................6 Editing new files.....................7 Files suitable for Xpedit.............7 Files with short records..............7 Files containing file labels..........8 Binary data...........................8 Qedit files...........................8 Xpedit internal files.................8 ________ iv Contents _______ _ ________ _______ _______ _________ Chapter 4 Standard Editing Without Templates Screen layout.........................9 Entering data.........................10 Leaving Xpedit........................11 The exit screen.......................11 Save and exit......................12 Exit without saving changes........12 Don't exit.........................12 Using the function keys...............12 Inserting and deleting lines..........13 The edit marker.......................14 The page marker.......................15 On-line help..........................16 _______ _ _______ _____ _________ Chapter 5 Editing Using Templates Overview..............................17 Starting up...........................17 Template menu choices.................18 Example: the job request form........19 Canceling your edits..................19 Template design guidelines............20 Template form names................20 Template message display window....21 Using the line drawing set.........21 Field edit processing..............21 _______ _ ______ ___ ______ _____ Chapter 6 Xpedit for Xpress Users Are you using Xpedit?.................22 Creating a message....................23 Returning to Xpress...................23 Using Xpedit in other baskets.........24 Configure Xpedit for Xpress...........24 _______ _ _________ ______ ___ ______ Chapter 7 Configure Xpedit for HPDesk..........25 _______ _ _________ ___ ______ ___________ Chapter 8 Configure the Xpedit Environment JCWs that control Xpedit..............26 Run-time parameters...................27 Xpedit allows file commands...........28 _______ _ __________ ______ Chapter 9 Installing Xpedit Step 1: Upgrade the Robelle account..29 Step 2: Restore the files............30 Step 3: Install the program..........30 Xpedit files..........................30 Printing documentation................31 ________ Contents v ________ _ _ ________ Appendix A - Messages............................32 _____ Index............................................36