Navigator User Guide

Back Next

User-Defined C Programs - Examples

PowerExchange provides example user-defined C programs on all operating systems.

User-defined C programs use the following prototype:

int CRoutine(int NbrFlds
            ,char *pMsgBuffer, int *pMsgBufferSize
            ,char *ppData[], int * pDataLen[]);

The following table lists the example C programs:

Operating System	Member or Program	Location	Linkage Type	Program Requirements
i5/OS	-	-	C¹	Exported routines in a service program
Linux UNIX	-	-	C¹	Exported routines in an executable shared object
Windows	ucpe.c	The examples directory in the PowerExchange installation directory	C¹	Exported routines in the CDECL convention in a DLL
z/OS	UCPE	hlq .SRCLIB library	C¹	Must be fetchable from a load module. Link called modules with AMODE(31). If access is required to AMODE(24) load modules, call the module through an AMODE(31) program that relocates the parameters below the 16 MB line and then calls the AMODE(24) load module.
1. Specify as the third argument in the CallProg function call.