Troubleshooting the agent installation on z/OS

You might receive error messages after building the agent source code on z/OS. This topic describes fixes for some common errors.

The configure-zos script sets some common values and performs some basic checks to identify the headers and functions available on your system.

Because of variations in z/OS system configurations, the ./configure-zos script might run without errors but you might see the following errors when you run the ./build-zos script.

CEE3501S The module CCNDRVR was not found.

FSUM3066 The COMPILE step ended with the following return code:

-1: EDC5083I An error occurred attempting to load a module into storage.

This error indicates that a required dynamic library cannot be loaded by the compiler.

Run the command: % export STEPLIB="SYS1.SCCNCMP"

Rerun the ./build-zos command. If the command fails again, contact your system administrator for assistance in locating the required library.

IKJ56228I DATA SET CEE.SCEEOBJ NOT IN CATALOG OR CATALOG CAN NOT BE ACCESSED

FSUM3066 The COMPILE step ended with the following return code:

FSUM3052 The data definition name C8961 cannot be resolved. The data set was not found. Ensure that data set name CEE.SCEEOBJ is specified correctly.

This error indicates that the linker was unable to locate a system library that it needs to complete the compilation. Run the commands:

% export _C89_LSYSLIB=SYS1.SCEELKED:SYS1.SCEELKEX

% export _C89_PSYSLIB=SYS1.SCEEOBJ

Rerun the ./build-zos command. If the command fails again, contact your system administrator for assistance in locating the required libraries.

IEW2456E 9207 SYMBOL xxx UNRESOLVED

The unresolved symbol errors indicate that the build expected a symbol to be defined by your system C library that is not actually there. In most cases, this is a symbol that is often missing from other systems too, and there will be a setting in config.h to work around the problem.

For example, your system might not define the unsetenv function. The configure-zos script should normally detect this; if it does not, edit the config.h file that is provided with the agent source pack, as follows:

Change #define HAVE_UNSETENV 1 to #undef HAVE_UNSETENV.

Rerun the ./build-zos command to correct the problem.

Note: Similar #define statements exist for other functions.