HP 3000 Manuals

Getting Started as an MPE/iX Programmer Programmer's Guide

Files Used by HP Link Editor/XL 

HP Link Editor/XL can use three types of input files:

   *   Relocatable object files.
   *   Command input file, containing commands for processing.
   *   Relocatable library (RL) files to be searched or manipulated

The command input file is the standard file $STDINX. For sessions,
$STDINX is the terminal.  For batch jobs, $STDINX is the job file.  You
can redirect $STDINX to another file by using the STDIN option of the
MPE/iX command :RUN. For example, to use the file named SCRIPT as the
standard input file, enter the command

          :RUN LINKEDIT.PUB.SYS;STDIN=SCRIPT

You can send one input command through the "INFO=string" parameter of the
MPE/iX command :RUN instead of using $STDINX. This starts HP Link
Editor/XL, executes the command you specified, and exits HP Link
Editor/XL. Figure 4-2  shows the files used by HP Link Editor/XL.


          Figure 4-2.  Files Used by HP Link Editor/XL 


NOTE  A relocatable object file produced by one of the MPE/iX compilers
      contains one relocatable object module.


Types of HP Link Editor/XL output files are:

   *   $STDLIST, which is the terminal during a session and the output
       spool file from a batch job, unless you redirect it, as discussed
       below.

   *   LINKLIST, which is a list file.

   *   An executable program file.

   *   An executable library file (XL).

   *   A relocatable library file (RL).

   *   A relocatable object file.

You can redirect $STDLIST to another device by using the STDLIST option
of the MPE/iX command :RUN. For example, the following commands send HP
Link Editor/XL output to the printer and runs HP Link Editor/XL:

          :FILE LINKOUT;DEV=LP
     :RUN LINKEDIT.PUB.SYS;STDLIST=*LINKOUT

       LINKLIST information is sent to the $STDLIST device by default.

       LINKLIST contains:

   *   Symbol map produced by the MAP option of the LINK command.
   *   Listing produced by the LISTPROG command.
   *   Listing produced by the LISTOBJ command.
   *   Listing produced by the LISTRL command.
   *   Listing produced by the MAP option of the ADDXL command.
   *   Listing produced by the LISTXL command.

HP Link Editor/XL creates a list file named LINKLIST for commands that
generate large amounts of information.  It usually writes the information
to the $STDLIST device, but you can redirect LINKLIST to a different
device by using the DEV option of the MPE/iX command :FILE. For example,
the following commands send the listing of a relocatable library named
LIBRL to a line printer:

           :FILE LINKLIST;DEV=LP
     :LINKEDIT
     :LinkEd> LISTRL RL=LIBRL
     :LinkEd> EXIT

MPE/iX 5.0 Documentation