Preparing an OS/390 Java client environment for OLT and the IBM Distributed Debugger (CB)

IBM WebSphere Enterprise Edition
To enable the Java client for OLT and the Distributed Debugger in the IBM WebSphere Enterprise Edition for the OS/390 environment, perform these steps:

  1. Create the jivp.sh file and include its location in your system PATH. The file should look like the following:
    export HOME=/tmp # this can be any existing, writable directory
    export IVB_DEBUG_ENABLED=1
    export IVB_TRACE_HOST=YourOLTViewerHost.YourDomain.com
    export IVB_TRACE_PORT=2102
    # enable the OLT tools
    # you may use the machine IP address instead of YourOLTViewerHost.YourDomain.com
    export CLASSPATH=
    /usr/lpp/CB390/samples/PolicyIVP/jcivp.jar:
    /usr/lpp/CB390/samples/PolicyIVP/TRACE_DEBUG/bboplc.jar:
    $CLASSPATH
    export LIBPATH=/lib:
    /usr/lpp/CB390/lib:
    /jbo:
    $LIBPATH
    java jcivp commit
  2. Ensure that you JCL looks like the following:
    //BBOIVPJ JOB
    //* 
    // SET IVPPATH=path_to_jar_files 
    //IVP3A EXEC PGM=BPXBATCH,REGION=0M 
    //STEPLIB DD DSN=&BBOLIB..SBBOLD2,DISP=SHR 
    // DD DSN=&BBOLIB..SBBOULIB,DISP=SHR 
    //STDIN DD PATH='&IVPPATH/jcivp.sh',PATHOPTS=(ORDONLY) 
    //STDOUT DD PATH='/tmp/jcivp.out',PATHOPTS=(OWRONLY,OCREAT,OTRUNC), 
    // PATHMODE=SIRWXU 
    //STDERR DD PATH='/tmp/jcivp.err',PATHOPTS=(OWRONLY,OCREAT,OTRUNC), 
    // PATHMODE=SIRWXU 

    Where <path_to_jar_files> is the path to your application's JAR files. For example, the CB Policy Sample JAR files, PolicyC.jar and JPolicyS.jar are in /usr/lpp/CB390/samples/PolicyIVP, so the command in the JCL would be:
    SET IVPPATH='/usr/lpp/CB390/samples/PolicyIVP'

  3. Submit your java client JCL.

IBM WebSphere Advanced Single Server Edition
To enable the Java client for OLT and the Distributed Debugger in the IBM WebSphere Advanced Single Server Edition for OS/390 environment, use the java command for JDK 1.3.x

ngrelt.gif (466 bytes)
Preparing for an OLT and IBM Distributed Debugger session on OS/390