home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.robelle3000.ai 2014
/
2014.06.ftp.robelle3000.ai.tar
/
ftp.robelle3000.ai
/
manuals
/
text
/
xpedit.txt
< prev
next >
Wrap
Text File
|
2007-12-20
|
110KB
|
2,684 lines
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