z/OS UNIX System Services Planning
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Steps for making the runtime library available through STEPLIB

z/OS UNIX System Services Planning
GA32-0884-00

Before you begin: You need to be aware that putting the Language Environment® runtime library in LNKLIST requires the least amount of setup. However, if your applications require the pre-Language Environment runtime library, then make the Language Environment runtime library available through STEPLIB.

Restriction: Do not include a STEPLIB DD statement in the BPXAS procedure. Doing so can lead to recursive 0C4 abends when the BPXAS procedure is processing a fork or spawn request.

Perform the following steps to make the runtime library available through STEPLIB.

  1. Add the SCEERUN data set on a STEPLIB DD statement to the OMVS startup procedure found in PROCLIB.

    Result: The STEPLIB data set is propagated to BPXOINIT and the /usr/sbin/init program including all programs it invokes using fork or exec.

    _______________________________________________________________

  2. Add the SCEERUN data set to your TSO/E logon procedure by concatenating it to the ISPLLIB DD statement (if it exists) and then concatenating it to the STEPLIB DD statement (if it exists). You can also use the TSOLIB function to add the SCEERUN data set.

    Result: After you have added the SCEERUN data set, the TSO/E OMVS command can begin to use it.

    _______________________________________________________________

  3. Add the following statement to the /etc/rc file:
    export STEPLIB=hlq.SCEERUN

    Result: Daemons started in /etc/rc will use the SCEERUN data set.

    _______________________________________________________________

  4. In /etc/profile, remove:
    if [ -z "$STEPLIB" ] && tty -s;
    then
        export STEPLIB=none
        exec sh -L
    fi
    and replace with
    export STEPLIB=hlq.SCEERUN

    This is used when issuing commands and utilities in the shell environment.

    Tip: If a small number of interactive users need a special version of the runtime library, the STEPLIB environment variable can be set in the $HOME/.profile for each of these users.

    _______________________________________________________________

  5. Add the SCEERUN data set on a STEPLIB DD statement to any job invoking BPXBATCH.

    _______________________________________________________________

  6. Add the SCEERUN data set to the STEPLIBLIST statement of the BPXPRMxx parmlib member.

    Rule: The SCEERUN data set must be APF-authorized.

    _______________________________________________________________

When you are done, you have made the Language Environment runtime library available through STEPLIB.

Tip: Place the SCEERUN2 data set in LNKLST, even though the SCEERUN data set is accessed through STEPLIB. Because the SCEERUN data set does not contain module names that conflict with pre-Language Environment runtime libraries, adding it to LNKLST will not have any adverse effects.

For BPXBATCH processing, you still have to specify the SCEERUN data set on a STEPLIB DD statement even though the RUNOPTS parameter has been set in the BPXPRMxx member.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014