COBOL container for batch troubleshooting
If we encounter problems when using COBOL container for batch troubleshooting, there are a number of options available to you.
Debug trace
To enable tracing of the COBOL container code, add the following to the Java trace specification:
com.ibm.ws.batch.ilc.*=all com.ibm.websphere.batch.ilc.*=all
Performance trace
To monitor performance of COBOL container invocations, activate the following Java trace specification:
com.ibm.ws.batch.ilc.impl.LEChildEnvironment.invokeProcedure=allWhen activated, the trace prints the following line to the job log after each COBOL invocation:
Returned from procedure {name}, duration=1335875 ns, rc=0The reported duration includes the execution time of the COBOL procedure and of the surrounding container code.
Common errors
Error Suggested solution com.ibm.websphere.batch.ilc.ILContainerException: mkfifo failed with rc=-1 Ensure that the ${GRID_JOBLOG_ROOT}/joblogs directory exists and is writeable by the WebSphere Application Server SR user ID. com.ibm.websphere.batch.ilc.ILContainerException: LEChildEnvironment.create failed (CEEPIPI function:0x5A rc:0x0000006F rsn:0x5B400002) Ensure that PIPIENV is on the LIBPATH (server_region_libpath) and is executable by the WAS SR user ID. java.lang.UnsatisfiedLinkError: LECENV (Not found in java.library.path) Ensure that libLECENV.so is on the LIBPATH (server_region_libpath) and is executable by the WAS SR user ID.
Related:
COBOL container overview Developing COBOL container batch applications Create a COBOL call stub Java class Compiling COBOL call stub Java classes Generate COBOL call stubs COBOL call stub Java class usage example COBOL RETURNING, RETURN-CODE, getReturnValue, and getReturnCode parameters