Qp2dlsym()--Find an Exported i5/OS PASE Symbol

 #include <qp2user.h>

 void* Qp2dlsym(QP2_ptr64_t  id
                const char   *name,
                int          ccsid,
                QP2_ptr64_t  *sym_pase);  

Qp2dlsym() finds an exported i5/OS PASE symbol by calling the i5/OS PASE dlsym() function.

Parameters

id

(Input) Specifies a value returned by API Qp2dlopen (or the i5/OS PASE dlopen function) that controls what modules are searched for the exported symbol.

name

(Input) A pointer to a null-terminated string that contains the symbol name. This API copies the input name string and converts the copy from the CCSID specified by the ccsid argument to the current i5/OS PASE CCSID (required by the i5/OS PASE dlsym function).

ccsid

(Input) Specifies the CCSID for the input name argument string. Zero means the symbol name is in the (EBCDIC) job default CCSID.

sym_pase

(Input) A pointer to a buffer, used to return the i5/OS PASE address of the exported symbol. The return value is always 64-bits, even for a 32-bit i5/OS PASE program. sym_pase can be null if the caller does not need the i5/OS PASE address of the symbol.

Authorities

None.

Return Value

The function result is a pointer to the specified symbol, or a null pointer if the symbol could not be resolved. A buffer addressed by the sym_pase argument is unchanged if the symbol could not be resolved. The caller can check ILE errno or i5/OS PASE errno (if ILE errno is zero), or call the Qp2dlerror API for more information about any error.

Related Information

• i5/OS PASE dlsym()--See AIX documentation
  
  
• Qp2dlerror()--Retrieve i5/OS PASE Dynamic Load Error Information
  
  
• Qp2errnop()--Retrieve i5/OS PASE errno Pointer
  
  
• Qp2RunPase()--Run an i5/OS PASE Program