Manual De Api En As400

AS/400 Advanced Series

IBM

System API Programming
Version 4

SC41-5800-00

AS/400 Advanced Series

IBM

System API Programming
Version 4

SC41-5800-00

Take Note!
Before using this information and the product it supports, be sure to read the general information under “Notices” on page xi.

First Edition (August 1997)
This edition applies to the licensed program IBMOperating System/400 (Program 5769-SS1), Version 4 Release 1 Modification 0,
and to all subsequent releases and modifications until otherwise indicated in new editions.
Make sure that you are using the proper edition for the level of the product.
Order publications through your IBM representative or the IBM branch serving your locality. If you live in the United States, Puerto
Rico, or Guam, youcan order publications through the IBM Software Manufacturing Solutions at 800+879-2755. Publications are not
stocked at the address given below.
IBM welcomes your comments. A form for readers’ comments may be provided at the back of this publication. You can also mail
your comments to the following address:
IBM Corporation
Attention Department 542
IDCLERK
3605 Highway 52 N
Rochester, MN55901-7829 USA
or you can fax your comments to:
United States and Canada: 800+937-3430
Other countries: (+1)+507+253-5192
If you have access to Internet, you can send your comments electronically to IDCLERK@RCHVMW2.VNET.IBM.COM; IBMMAIL, to
IBMMAIL(USIB56RZ).
When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believesappropriate without incurring any obligation to you.
© Copyright International Business Machines Corporation 1997. All rights reserved.
Note to U.S. Government Users — Documentation related to restricted rights — Use, duplication or disclosure is subject to
restrictions set forth in GSA ADP Schedule Contract with IBM Corp.

Contents
Notices . . . . . . . . . . . . . . .
Programming InterfaceInformation
Trademarks . . . . . . . . . . . . .

...........................
.........................
..........................

About System API Programming (SC41-5800)
Who Should Use This Book . . . . . . . . . . . .
Prerequisite and Related Information . . . . . .
Information Available on the World Wide Web .

.................
..................
....................................

Chapter 1. Application Programming Interface—Overview
API Compatibility . . . . . . . . . . . . . . . . . . . . . . . . . .
Using APIs—Benefits . . . . . . . . . . . . . . . . . . . . . . .
System APIs or CL Commands—When to Use Each . . . . .
Actions and System Functions of APIs . . . . . . . . . . . . .
Related Information
........................

.........
....................
..........
..........
..........

Chapter 2. Getting Started with APIs . . . . . . . . . . . . . .
Locating the API to Use . . . . . . . . . . . . . . . . . . . . . . .
...........
Selecting the High-Level Language To Use
API Environments
..........................
APIs for the Original Program Model Environment . . . . . .
APIs for the Integrated Language Environment . . . . . . ..
APIs for the ILE Common Execution Environment (CEE) . .
APIs for the UNIX Environment . . . . . . . . . . . . . . . . .
API Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Parameter Passing . . . . . . . . . . . . . . . . . . . . . . . .
Parameter Classification . . . . . . . . . . . . . . . . . . . . .
Error Code Parameter . . . . . . . . . . . . . . . . . . . . . .Using the Job Log to Diagnose API Errors
..........
Internal Identifiers
..........................
.............................
User Spaces
.................
User Space Format—Example
Logic Flow of Processing a List of Entries . . . . . . . . . . .
Manipulating a User Space with Pointers . . . . . . . . . . .
.........
Manipulating a User Space without Pointers
Additional Information...