Chapter

6.

Original

Program

Model (OPM)

and

Integrated

 

 

 

Language

Environment

(ILE)

Differences

 

 

 

 

 

 

 

This chapter contains an overview of how Original Program Model (OPM) API

 

 

Integrated

Language Environment (ILE) APIs differ

from each

other. The

 

 

include

the

UNIX-type

APIs and the ILE CEE APIs

among

others.

 

 

You must have the ILE

language

compiler on your

system

to

develop ap

 

 

that use any ILE APIs.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Contrasting

OPM and

ILE

APIs

 

 

 

 

 

 

API Name

 

 

 

 

 

 

 

 

 

 

The maximum number of characters that an OPM API name can contain is whereas the maximum number in an ILE API name is 30. ILE API names ar case-sensitive.

Parameters

There are several types of

parameters: required, optional, and

omitte

AS/400

OPM

and ILE

APIs show

the

parameters

in a Parameter

box,

where

AS/400

UNIX-type

APIs

show

them

in

a Syntax

box. The ILE

APIs

include

service

program

name

at the

bottom

of the

box.

 

 

Optional Parameters: Some of the OPM APIs have optional parameters. The optional parameters form a group, and you must either include or exc group.

OPM APIs

do

not

have

omitted

parameters.

Omitted

Parameters:

 

The ILE APIs may have parameters that can be omitt

When

these

parameters

are omitted, you must pass a null pointer.

ILE

APIs

do

not

have

optional

parameters.

The required and optional parameters are discussed in more detail i Parameter Group” on page 3-3 and “Optional Parameter Group” on page 3-

Error Conditions

The error code parameter is common to most of the OPM APIs, and it return error codes and exception data to the application. The error returned for a given API are in the form of an error message and 7-character message identifier.

Some APIs use means other than the error code parameter for report ditions, as follows:

Ÿ The ILE CEE APIs use feedback codes and conditions.

Ÿ The UNIX-type APIserrnosuse and return values.

Ÿ The national language data conversion errnosAPIs anduse return values.

Copyright IBM Corp. 1997

6-1

Page 129
Image 129
IBM Version 4 manual Parameters, Error Conditions, Opm