IBM Version 4 manual Parameters, Error Conditions, Opm

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