# IPI_Initialize()

This subprocedure is used to initialize the internal IPI environment to allow the usage of other IPI subprocedures. This subprocedure must be called prior to any other IPI subprocedures.

## Subprocedure Prototype

| Field | Description |
|---|---|
| `Dcl-Pr IPI_Initialize Ind OpDesc ExtProc('IPI_Initialize');` | Returns *OFF if an error occurs during processing, *ON otherwise. |
| `  pErrorDS LikeDS(IPI_ErrorDS_t) Options(*NoPass:*Omit);` | Optional parameter that, if passed, will contain error data returned from the subprocedure. If it is not passed, exceptions will instead be "thrown" and must be caught by a MONITOR block. |
| `End-Pr;` |  |


## Data Structures

### IPI_ErrorDS_t

| Field | Description |
|---|---|
| `Dcl-Ds IPI_ErrorDS_t Qualified Template Inz;` |  |
| `  Subproc VarChar(132);` | Subprocedure which received error |
| `  MessageCode Char(7);` | Message ID of error message |
| `  Message VarChar(1024);` | Error message text |
| `End-Ds;` |  |