HP 3000 Manuals

HP EDIT Reference Manual

Starting A Session 

You start an HP EDIT session by issuing the proper run string from the
MPE command interpreter.  You can issue the standard run string, or you
can simplify the start-up procedure by implementing a User-Defined
Command (UDC).

Each time you start an HP EDIT session, you must specify the name of the
file you intend to edit.  By default, HP EDIT searches for files in your
home group, but it also accepts qualified file name paths that reference
files in other groups.

Performing The Standard Start-up Procedure 

Perform the following procedure to start HP EDIT and open a new or
existing file:

   1.  Type the following run string beginning at the cursor position and
       press Return:

            run hpedit.pub.sys

       HP EDIT displays banner information and a prompt similar to the
       following example:


            

       If you want to abort session initiation at this point, press
       Return.

   2.  Type an alphanumeric file name not exceeding 32,000 lines and
       eight characters beginning at the cursor position and press
       Return.  You can optionally specify a group name following the
       file name as shown in the following example:


            

       If the specified file exists, HP EDIT responds to your input by
       displaying the first page of the file named FILENAME.GRPNAME as
       shown in figure 1-1.  If the specified file does not exist, HP
       EDIT asks whether you want to create a new file:


            

   3.  If the file name you specified in Step 2 appears correct, press
       the y key.  If you press the y key, HP EDIT:
          *   Initializes the HP EDIT program
          *   Loads the specified file
          *   Creates a backup recovery file
          *   Saves user function key labels
          *   Displays the first page of the file

       Figure 1-1 shows how the first page of a file named
       FILENAME.GRPNAME would appear:


          Figure 1-1.  Sample File 

       If the file name you specified in Step 2 appears incorrect, press
       the n key.  If you press the n key, HP EDIT prompts you again for
       the file name.  Specify the desired file name and press Return as
       for Step 2.

Customizing The Start-up Procedure 

You can customize the start-up procedure so that you are able to begin an
HP EDIT session more quickly.  You could do one or all of the following
to customize the start-up procedure:

   *   Add the Info parameter to the run string
   *   Create a file equation that specifies the file name
   *   Create a User-Defined Command (UDC)

Adding The Info Parameter.     

Add the Info parameter to the run string to eliminate the HP EDIT file
name prompt.  An example of using the Info parameter within the run
string is as follows:

     :run hpedit.pub.sys;info="filename"

[REV BEG]

Adding the Line Parameter.     

To start editing a file at a specific point, you can specify the line
number in the run string.  The following is an example of using the line
number in a run string.

     :RUN HPEDIT.PUB.SYS;INFO="filename;LINE=nn.n"

If the file is unnumbered, the number in the run string refers to the
record number in your file.  If the file is numbered, the number in the
run string refers to the line number in your file.

To force a record number for a numbered file, enter an R before the
record number.  For example:

     :RUN HPEDIT.PUB.SYS="filename;LINE=Rnnn"
[REV END]

Creating A File Equation.     

You can prepare a file equation that accesses a specific named file as in
the following example:

     :file f=testfile
     :run hpedit.pub.sys;info="f"

After creating this file equation, you could enter the letter f to access
the file named testfile.

Creating A UDC.    

You can create a UDC that substantially reduces the number of keystrokes
required to access HP EDIT. The following UDC example incorporates the
Info parameter for further start-up simplification:

     hpedit filename=" "
     run hpedit.pub.sys;info="!filename"
     ***

After creating this UDC, you could initiate a session by simply entering
the following command:

     :hpedit filename 

MPE/iX 5.0 Documentation