HP 3000 Manuals

SWAT Quick Reference Summary [ Switch Programming User's Guide ] MPE/iX 5.0 Documentation


Switch Programming User's Guide

SWAT Quick Reference Summary 

The following steps summarize the process of using SWAT to generate
Switch stubs automatically and how to use SWAT-generated stubs:

   1.  To invoke SWAT, type:  RUN SWAT.PUB.SYS. SWAT uses VPLUS screens
       to prompt you for the information it needs.

   2.  Follow these guidelines when filling in a menu:

       a.  Use the Cursor Control keys or the Tab key to move from field
           to field and item to item within a menu.

       b.  To complete some fields, you must enter a name or numerical
           value.

       c.  If the field consists of a list of options, place a nonblank
           character in the space provided next to your choice.

       d.  To record information on the menu, press the [[Enter]] key.

       e.  If you have made errors while filling the menu, SWAT will help
           you resolve them by highlighting the fields containing errors
           and displaying diagnostic messages.

   3.  Fill in SWAT's MAIN menu with the following information:

        *  Source code file name

        *  Target CM procedure name

        *  Target procedure parameter names

   4.  Fill in SWAT's PROCINFO menu with the following information:

        *  Location of the target procedure

        *  Function return type of the target procedure

        *  Privilege level of the target procedure

        *  Whether the target procedure returns a condition code

   5.  For each parameter, fill in SWAT's PARMINFO menu with the
       following information:

        *  Parameter's addressing method

        *  Parameter's data type

        *  Parameter's I/O type

        *  Whether a parameter is an array

   6.  If a parameter is an array, fill in SWAT's ARRAYLEN menu with the
       following information:

        *  Length value of the array parameter

        *  How the length value is to be interpreted

   7.  If you want to review or edit any of these menu screens, use the
       F5 and F6 function keys to move backward and forward through the
       screens.

   8.  When finished with your review/edit, proceed to the COMMIT screen
       and press the F2 function key to begin generating the Switch stub
       source code.

   9.  When code generation begins, the PROGRESS MESSAGES screen appears
       and displays any progress, error, and/or result messages
       associated with the code generation process.

  10.  When SWAT has generated the source for your Switch stub, it
       redisplays the MAIN menu screen.  You can either press the F8
       function key to exit SWAT or return to step 2 to generate another
       stub.

  11.  Use the PASXL command to compile the SWAT-generated Switch stub.
       For more information on PASXL, refer to the MPE XL Commands
       Reference Manual (32650-90003).

  12.  Use the Link Editor to link the resulting object code into an NM
       program file or install it in an NM Executable Library.  For more
       information on the Link Editor, refer to the Link Editor/XL
       Reference Manual (32650-90030).


MPE/iX 5.0 Documentation