Qp2dlerror()--Retrieve i5/OS PASE Dynamic Load Error Information

 #include <qp2user.h>

 char* Qp2dlerror(void);

Qp2dlerror() returns a pointer to a string that provides error information for the most recent dynamic load function (API Qp2dlopen, Qp2dlsym, or Qp2dlclose).

Parameters

None.

Authorities

None.

Return Value

The function result is a pointer to a null-terminated character string (in the job default CCSID). A null pointer is returned if no error occurred during the most recent dynamic load operation. Once Qp2dlerror is called, subsequent calls without an intervening dynamic load error also return a null pointer.

The ILE errno is set and a null pointer is returned for any internal processing error (such as an error converting the string from the i5/OS PASE CCSID to the job default CCSID).

Usage Notes

1. Qp2dlerror is not threadsafe because it may call an i5/OS PASE function that is not threadsafe (dlerror) and uses a buffer in static storage for the error string that is also updated by other dynamic load functions (APIs Qp2dlopen, Qp2dlsym, and Qp2dlclose). Applications may need to serialize use of dynamic load functions and copy the error information string to preserve its contents.

Related Information

• i5/OS PASE dlerror()--See AIX documentation
  
  
• Qp2errnop()--Retrieve i5/OS PASE errno Pointer
  
  
• Qp2RunPase()--Run an i5/OS PASE Program