Machine interface programming

Provides information about creating machine interface (MI) programs.

This topic is for programmers interested in creating machine interface (MI) programs. While some MI instructions are discussed within the context of how to develop MI programs, the following information makes no attempt to review the full range of MI instructions. The goal is to provide a sufficient base of knowledge so that you can begin to use the MI language. After reading the information on machine interface programming, you should be able to develop, create, run, and debug an MI program.

IBM^® grants you a nonexclusive copyright license to use all programming code examples from which you can generate similar function tailored to your own specific needs.

SUBJECT TO ANY STATUTORY WARRANTIES WHICH CANNOT BE EXCLUDED, IBM, ITS PROGRAM DEVELOPERS AND SUPPLIERS MAKE NO WARRANTIES OR CONDITIONS EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OR CONDITIONS OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT, REGARDING THE PROGRAM OR TECHNICAL SUPPORT, IF ANY.

UNDER NO CIRCUMSTANCES IS IBM, ITS PROGRAM DEVELOPERS OR SUPPLIERS LIABLE FOR ANY OF THE FOLLOWING, EVEN IF INFORMED OF THEIR POSSIBILITY:

1. LOSS OF, OR DAMAGE TO, DATA;
2. SPECIAL, INCIDENTAL, OR INDIRECT DAMAGES, OR FOR ANY ECONOMIC CONSEQUENTIAL DAMAGES; OR
3. LOST PROFITS, BUSINESS, REVENUE, GOODWILL, OR ANTICIPATED SAVINGS.

SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO SOME OR ALL OF THE ABOVE LIMITATIONS OR EXCLUSIONS MAY NOT APPLY TO YOU.

• Machine interface instructions
  Programs and procedures are the two basic units of execution on iSeries™.
• Example: Writing an MI program
  This topic shows how to write a simple MI program that receives two packed-decimal parameters and returns the larger value through a third parameter.
• Compile an MI program
  To compile an MI program, use the Create Program (QPRCRTPG) API.
• Creating an MI version of CLCRTPG
  This topic discusses how to create an MI version of the CLCRTPG program that can be used to create MI programs. This program is called MICRTPG.
• Enhanced version of the MICRTPG program
  A new version of MICRTPG (named MICRTPG2) incorporateS the functions of the CL03 program and the CL05 program.
• Create the MICRTPG2 program
  This topic shows how to create the MICRTPG2 program and how to handle exceptions in the MICRTPG2 program.
• Examples: Common MI programming techniques
  This example MI program demonstrates some additional programming techniques.
• Program storage
  Two steps are needed to run a program: program activation and program invocation.