Testing and Debugging Considerations [ Switch Programming User's Guide ] MPE/iX 5.0 Documentation
Switch Programming User's Guide
Testing and Debugging Considerations
You must test Switch stubs and inline Switches in the run-time
environment on an MPE XL-based system. You must either compile the stub
and install the compiled version in the appropriate system library or
merge it with the code requiring the Switch call and recompile that
merged source. You can also compile the stub and then link it with the
USL/SOM file for the program that calls it. Before you can verify
correct execution of the stub, the target procedure that Switch is to
invoke must be present in the appropriate callable library of the other
mode. You can use the MPE XL debugging facilities to troubleshoot,
should you encounter problems.
The following are testing and debugging considerations that apply
specifically to switches in the CM--> NM direction:
* Verify that the other-mode procedure operates correctly by calling it
from its own mode.
* Verify that the switch worked correctly by checking its status
parameter return. It should be all zeros.
* Verify that the parameter types in the argdesc description are
correct.
* Verify that arglist elements were correctly reserved for hidden
parameters and/or function return values.
* Verify that name lengths are correct.
* Verify that HPLOADNMPROC succeeded (by testing the condition code)
before calling HPSWTONMPLABEL.
* Verify either that alignments match or that the target can handle any
alignment.
MPE/iX 5.0 Documentation