Scenario: Integrated Language Environment^® (ILE) APIs

The example APIs in this section represent two general functions of APIs--change and retrieve.

For a detailed description of how to use the API, use information in API information format.

The following examples illustrate the use of ILE APIs. The examples use the registration facility APIs. The registration facility APIs provide a means for storing and retrieving information about exit points and exit programs. An exit point is a specific point in a system function or program where control may be passed to one or more exit programs. An exit program is a program to which control is passed from an exit point. The examples show how to manipulate exit points and exit programs, how to retrieve information about exit points and exit programs that are stored with the registration facility, and how to call an exit program.

Several of the registration facility APIs manipulate the information that the registration facility repository contains. One API is provided for retrieving information from the repository.

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.

• Example in ILE C: Register exit point and add exit program
  This program registers an exit point with the registration facility. After the successful completion of the registration of the exit point, an exit program is added to the exit point.
• Example in OPM COBOL: Register exit point and add exit program
  This program registers an exit point with the registration facility. After the successful completion of the registration of the exit point, an exit program is added to the exit point.
• Example in ILE COBOL: Register exit point and add exit program
  This program registers an exit point with the registration facility. After the successful completion of the registration of the exit point, an exit program is added to the exit point.
• Example in OPM RPG: Register exit point and add exit program
  This program registers an exit point with the registration facility. After the successful completion of the registration of the exit point, an exit program is added to the exit point.
• Example in ILE RPG: Register exit point and add exit program
  This program registers an exit point with the registration facility. After the successful completion of the registration of the exit point, an exit program is added to the exit point.
• Example in ILE C: Remove exit program and deregister exit point
  This program removes an exit program and deregisters an exit point from the registration facility.
• Example in OPM COBOL: Remove exit program and deregister exit point
  This program removes an exit program and deregisters an exit point from the registration facility.
• Example in ILE COBOL: Remove exit program and deregister exit point
  This program removes an exit program and deregisters an exit point from the registration facility.
• Example in OPM RPG: Remove exit program and deregister exit point
  This program removes an exit program and deregisters an exit point from the registration facility.
• Example in ILE RPG: Remove exit program and deregister exit point
  This program removes an exit program and deregisters an exit point from the registration facility.
• Example in ILE C: Retrieve exit point and exit program information
  This program retrieves exit point and exit program information. After retrieving the exit point information, the program resolves to each associated exit program and calls each exit program. The Retrieve Exit Information API returns a continuation handle when it has more information to return than what fits in the receiver variable.
• Example in OPM COBOL: Retrieve exit point and exit program information
  This program retrieves exit point and exit program information. After retrieving the exit point information, the program calls each exit program. The Retrieve Exit Information API returns a continuation handle when it has more information to return than what fits in the receiver variable.
• Example in ILE COBOL: Retrieve exit point and exit program information
  This program retrieves exit point and exit program information. After retrieving the exit point information, the program calls each exit program. The Retrieve Exit Information API returns a continuation handle when it has more information to return than what fits in the receiver variable.
• Example in OPM RPG: Retrieve exit point and exit program information
  This program retrieves exit point and exit program information. After retrieving the exit point information, the program calls each exit program. The Retrieve Exit Information API returns a continuation handle when it has more information to return than what fits in the receiver variable.
• Example in ILE RPG: Retrieve exit point and exit program information
  This program retrieves exit point and exit program information. After retrieving the exit point information, the program calls each, exit program. The Retrieve Exit Information API returns a continuation handle when it has more information to return than what fits in the receiver variable.