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

D IPI_Initialize...
D                 PR              N   Extproc('IPI_Initialize')
D                                     Opdesc

Returns *OFF if an error occurs during processing, *ON otherwise.

D  pErrorDS                           LikeDS(IPI_ErrorDS_t)
D                                     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.

Data Structures

D IPI_ErrorDS_t   DS                  Qualified Template Inz
D  Subproc                     132A   Varying

Name of the subprocedure that encountered an error.

D  MessageId                     7A

Message ID corresponding to the error that occurred.

D  Message                    1024A   Varying

Error message text providing details about the error.