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