z/OS Language Environment Customization
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Add Language Environment-CICS data sets to the CICS startup job stream

z/OS Language Environment Customization
SA38-0685-00

Before running any CICS® transactions under Language Environment, you must add Language Environment to the startup job stream. CICS Transaction Server for z/OS® System Definition Guide describes the CICS system startup procedure and provides an example of a CICS startup job stream.

To add the Language Environment-CICS data sets to CICS:

  • Update the DFHRPL DD concatenation.

    Add the Language Environment runtime library SCEERUN in the DFHRPL DD concatenation of the job that is used to start CICS.

    If you are running COBOL programs on CICS, you must also add Language Environment runtime library SCEECICS in the DFHRPL DD concatenation. The SCEECICS library must be concatenated before the SCEERUN library.

    Any libraries that contain runtime routines from earlier versions of COBOL, PL/I, and C/C++ should be removed from the DFHRPL DD concatenation.

    Start of change If you are running COBOL V5.1 (or later) programs, you must also add the Language Environment runtime library SCEERUN2 in the DFHRPL DD concatenation of the job that is used to start CICS. End of change

    Start of change If you are running COBOL V5.1 (or later) programs that were compiled with the TEST compiler option on CICS, you must also add system libraries SYS1.MIGLIB and SYS1.SIEAMIGE in the DFHRPL DD concatenation. End of change

  • If SCEERUN is not in LNKST or LPALST, then you must include the correct Language Environment routines into an authorized library that is part of the STEPLIB DD concatenation in the CICS startup job. If SCEERUN is in LNKLST/LPALST, then you do not have to add SCEERUN to the STEPLIB DD concatenation in the CICS startup job. You can either:
    1. Authorize the Language Environment runtime library SCEERUN and then include it in the STEPLIB DD concatenation in the CICS startup job. (The SCEERUN2 data set does not need to get added to this concatenation.)
    2. Put only those Language Environment routines that are needed by CICS using the STEPLIB into another library.
    If you use the second method, you must make the following Language Environment routines available by using the STEPLIB:
    • CEECCICS, CEECTCB
    • IGZCWTO: Used for COBOL support.
    • IGZCMTUE: Used for COBOL support.
    • IGZIDYN: Used for COBOL support.
    • ILBO routines: If you are running OS/VS COBOL programs, all of the ILBO routines must be available.

    Remove any libraries that contain runtime routines from earlier versions of COBOL and C/370™ from the STEPLIB DD concatenation.

Note:
  1. The previously mentioned library routines required from the STEPLIB might also be available by using the JOBLIB or the LNKLSTnn member.
  2. There is no CICS startup option for Language Environment. If CICS locates CEECCICS, it attempts to initialize Language Environment. If the modules have not been installed correctly, Language Environment initialization fails, and CICS generates an error message to that effect.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014