HP 3000 Manuals

Tutorial [ HP RPG/XL Utilities-Part 3 SIGEDITOR ] MPE/iX 5.0 Documentation


HP RPG/XL Utilities-Part 3 SIGEDITOR

Tutorial 

This short tutorial is designed to teach you some of the basic functions
of SIGEDITOR. This lesson guides you through creating a forms file,
designing a form, and editing the form.

Running SIGEDITOR 

To begin using SIGEDITOR, enter the following command:

:run sigedit.pub.sys

The main menu heading appears at the top of the as shown in
Figure 1-1.
__________________________________________________________________________________
|                                                                                |
|     HP32104A.08.00   SIGEDITOR                         WED, MAR 3, 1988 9:32 AM|
|                                                                                |
|                                                                                |
|                                                                                |
__________________________________________________________________________________

          Figure 1-1.  Main Menu Heading 

The main menu keys appear at the bottom of the screen.  The keys
correspond with  f1  through  f8  on the keyboard.  Figure 1-2 shows the
main menu keys.
_____________________________________________________________________________________
|                                                                                   |
|      SELECT    CONVERT             MERGE        PRINT   GEN I/O     FORM      EXIT|
|     FRMS FIL  S+D SPEC            CATALOG       SPECS    SPECS     UTILS          |
|                                                                                   |
_____________________________________________________________________________________

          Figure 1-2.  Main Menu Keys 

Creating a Forms File and a Form 

To create a forms file press the  f1  key (SELECT FRMS FIL). The screen
displayed is shown in Figure 1-3.
____________________________________________________________________________
|                                                                          |
|     Forms File name:                                                     |
|                                                                          |
|                                                                          |
|                                                                          |
|                                                                   ABANDON|
|                                                                          |
|                                                                          |
____________________________________________________________________________

          Figure 1-3.  Form File Creation Screen 

SIGEDITOR requests a name for the new forms file.  Type the forms
filename, MYFORMS, and press  ENTER . In reply to the question Create new
form file (Y/N)?, type Y.

The screen displayed now is the edit menu (see Figure 1-4).
_____________________________________________________________________________________
|                                                                                   |
|       EDIT    EDT FORM  EDT FLD    SWITCH     PREV PAG  NEXT PAG    FORM      MAIN|
|       FORM     ATTRIB    ATTRIB   LST FMT     FRM LIST  FRM LIST    UTILS     MENU|
|                                                                                   |
|                                                                                   |
_____________________________________________________________________________________

          Figure 1-4.  The Edit Menu 

From here you can select the functions for designing a new form, editing
an existing form, or selecting the form utilities functions.  These keys
and their related functions are explained in chapter 2 and summarized in
appendix B.

The cursor appears in the field beside Selected form:.  When editing an
existing form, you must enter the form name here.  Leave this entry blank
for now, and press  f1  (EDIT FORM).

The top of the screen is clear except for the cursor.  The keys used to
design a new form appear at the bottom of the screen, as shown in Figure
1-5.
_______________________________________________________________________________________
|                                                                                     |
|      START      STOP     CENTER                                    REFRESH    SWITCH|
|      FIELD      FIELD     LINE                                                 MENU |
|                                                                                     |
|                                                                                     |
_______________________________________________________________________________________

          Figure 1-5.  Form Design Keys 

You can now begin to draw the form in Figure 1-6.
_____________________________________________________________
|                                                           |
|      SOC. SEC. NO.                                        |
|      NAME                                                 |
|      ADDRESS                                              |
|                                                           |
|      ZIP CODE                PHONE NO.                    |
|                                                           |
|                                                           |
_____________________________________________________________

          Figure 1-6.  A Sample Form 

Using the cursor control keys, position the cursor where the label SOC.
SEC. NO. should begin.

Type the label SOC. SEC. NO. Create the field beside the label by
pressing the  f1  key (START FIELD) and by using the space bar to extend
the field.  When the field is the same length as that in Figure 1-6,
press the  f2  key (STOP FIELD). Follow this procedure with the other
labels and their fields until your form resembles the sample form.  If
one field is created directly under another, as in Figure 1-6, the two
fields may appear to be one.  However, SIGEDITOR recognizes them as
separate fields.

The  f3  key (CENTER LINE) centers a line of the form.  Position the
cursor anywhere on the social security number line and press  f3 .  Your
form looks like Figure 1-7.

             SOC. SEC. NO.                
      NAME                                                 
      ADDRESS                                              
      ZIP CODE                      PHONE NO.             

          Figure 1-7.  Sample Form with a Centered Line 

Press  ENTER . In the next screen, type the name of the new form and
press  ENTER  to store the form and return to the main menu.  At this
point, you have created a forms file, designed a new form, and stored the
form in the file.

Editing a Form 

This section takes you through the steps of editing a form.  The name of
the newly created form is displayed beside Selected form:  on your
screen.  Press  f1  (EDIT FORM) to display your form on the screen.

Press  f8  (SWITCH MENU). A new set of keys for detailed form editing is
displayed, as shown in Figure 1-8.
_______________________________________________________________________________________
|                                                                                     |
|      ADD TO    SHORTEN   DELETE     HOLD         PLACE     CLEAR  REFRESH     SWITCH|
|      FIELD      FIELD    FIELD      FIELD        FIELD     HOLD                MENU |
|                                                                                     |
|                                                                                     |
_______________________________________________________________________________________

          Figure 1-8.  Keys for Detailed Form Editing 

To lengthen the NAME field on the form, position the cursor in that field
(using the cursor control keys), and press the  f1  key (ADD TO FIELD)
several times.  The field is lengthened one position each time you press  
f1 .

The  f1  key can also create a new field in the form.  Position the
cursor under the field designated by the label ZIP CODE and type a new
label, AGE. Then, press the  f1  key three times to create a small field.
Your form looks like Figure 1-9.

             SOC. SEC. NO.                            
      NAME                                                  
      ADDRESS                                               
      ADDRESS                                               
      ZIP CODE                     PHONE NO.                
               AGE           

          Figure 1-9.  Sample Form with a New Field Added 

To shorten a field (remove spaces from the field) use the  f2  key
(SHORTEN FIELD). Position the cursor in the second address field and
press the  f2  key several times.  One space is removed from the field
each time you press  f2 .

To delete an entire field, use the  f3  key (DELETE FIELD). Position the
cursor in the field with the label AGE and press the  f3  key.  The field
no longer appears on the screen.  Erase the label by spacing over the
field.  Your form now looks like Figure 1-10.

             SOC. SEC. NO.                          
      NAME                                                 
      ADDRESS                                              
      ADDRESS                                          
      ZIP CODE                    PHONE NO.                

          Figure 1-10.  Sample Form with a Field Deleted 

The  f4  key (HOLD FIELD) copies or moves a single field from one
position to another.

Position the cursor on the field labeled PHONE NO. and press the  f1  
key.  An H appears in the field to indicate that the field is being held.
Next, move the cursor to the next line under the first position of the
PHONE NO. field and press the  f5  key (PLACE HOLD). A field identical to
the held field appears beginning at the cursor.  Label this field OFFICE
PHONE. Your form looks like Figure 1-11.

             SOC. SEC. NO.                             
      NAME                                                  
      ADDRESS                                               
      ADDRESS                                            
      ZIP CODE                     PHONE NO.               
                            OFFICE PHONE                        

          Figure 1-11.  Altered Sample Form 

The hold field function can only be used with one field at a time.  The H
remains in a held field until you apply the function to another field or
until you press  f6  (CLEAR HOLD).

Press  ENTER . The cursor appears under the name of your form.  You have
four options:

 *  Save the modified form under the original form name overwriting the
    old form.

 *  Save the modified form under a new form name preserving the old form.

 *  Press  f7  (ABANDON EDITS) cancelling changes.

 *  Press  f4  (RETURN TO EDIT) to make additional changes to the form.

Press  f4  to return to the editing screen.  Press  f8  (SWITCH MENU)
until the line drawing keys appear, as shown in Figure 1-12.
_______________________________________________________________________________________
|                                                                                     |
|       FROM       TO      HORIZON  VERTICAL      ERASE              REFRESH    SWITCH|
|     POSITION  POSITION   SINGLE    SINGLE                                      MENU |
|                                                                                     |
|                                                                                     |
_______________________________________________________________________________________

          Figure 1-12.  Line Drawing Keys 

Three line types are available:  single, bold, and double.  The default
is single.  When the set of keys first appears, both the horizontal and
vertical line types are set at the single type.  To change the types
press the  f3  key (HORIZON) or the  f4  key (VERTICAL).

To draw lines on a form, you must specify endpoints.  For example,
position the cursor on your screen to approximately the same position as
the letter a appears in Figure 1-13.  Press the  f1  key (FROM POSITION).
_______________________________________________________________________
|                                                                     |
|     e                                                              f|
|       a                                                          b  |
|                                                                     |
|                                                                     |
|                     SOC. SEC. NO. ___________________               |
|              NAME ________________________________________          |
|              ADDRESS _____________________________________          |
|              ADDRESS _____________________________________          |
|              ZIP CODE ___________ PHONE NO. ________                |
|                                    OFFICE PHONE __________          |
|                                                                     |
|                                                                     |
|       d                                                          c  |
|     h                                                              g|
_______________________________________________________________________

          Figure 1-13.  Location of Lines Drawn on Sample Form 

Set the horizontal line type to bold by pressing the  f3  key until the
key on the screen reads 'HORIZON BOLD.'

Next, move the cursor with the cursor control keys to approximately the
same position on the screen that the letter b appears in Figure 1-13.
Press the  f2  key (TO POSITION) to draw the bold line on the screen.
Press the  f1  key again, but this time set the vertical line type to
double by pressing the  f4  key until the key reads 'VERTICAL DOUBLE.'
Move the cursor to the same position as the letter c and press the  f2  
key; a double line appears.

Repeat the process above, drawing a bold line across the bottom of the
screen (from c to d) and a double line up the side (from d to a).  Now
set both line types to 'SINGLE' and draw another box around the form in
the position of the letters e, f, g, and h in Figure 1-13.

SIGEDITOR automatically places appropriate connectors on the form.
Chapter 2 describes how to specify connectors manually.

The  f5  key (ERASE) initiates the erase function to erase part or all of
a line within a form.  Press the  f5  key to turn erase on.  Notice that
the set of function keys at the bottom of the screen changes.  These are
the erase keys.  To erase the lines on the side of the form, move the
cursor to the upper right corner of the inside box on the screen and
press  f1 .  Move the cursor to the lower right corner and press  f2 .
The line between the two endpoints just defined is erased.  Repeat this
process with the vertical line on the left side of the inside box.

Press  ENTER . The name of the form is displayed in the next screen.
Press  ENTER  to save the changes and return to the main menu.



MPE/iX 5.0 Documentation