z/OS Install instructions

Installing LegStar modules for z/OS

Pre-requisites

LegStar mainframe programs are mostly written in C/370, therefore Language Environment (LE) is mandatory.

Some COBOL sample programs are part of the delivery. They were compiled using Enterprise COBOL for z/OS 3.3.0.

All CICS programs are translated with CICS 6.4.0 COMMAND LANGUAGE TRANSLATOR.

Installing

Download the latest LegStar distribution for z/OS.

Unzip the binary distribution package into the directory of your choice, referred to as <installDir> in the following steps.

The directory tree should look like this:


   <installDir>
        |---->LEGSTAR.version.C370.XMIT
        |---->LEGSTAR.version.CNTL.XMIT
        |---->LEGSTAR.version.COBOL.XMIT
        |---->LEGSTAR.version.H370.XMIT
        |---->LEGSTAR.version.LOAD.XMIT
        |---->LEGSTAR.version.OBJ.XMIT

Upload the XMIT files into sequential files on z/OS.

It is very important that:

  • You use a BINARY transfer type
  • Use RECFM=FB LRECL=80 PS files as targets

With FTP, you can use command such as:

   QUOTE SITE RECFM=FB LRECL=80 BLKSIZE=27920

to force new uploaded files to have an acceptable format for the TSO XMIT/RECEIVE protocol.

Under TSO, you can now RECEIVE the XMIT files into their target PDSs using a JCL such as:


//P390XMIT   JOB  (ACCT#),'USERID',
//*          RESTART=REFRESH,
//           MSGCLASS=X,NOTIFY=&SYSUID,PRTY=14,REGION=0M
//********************************************************************
//*  RESTORE XMIT FILES                                              *
//********************************************************************
//SUBMIT   EXEC PGM=IKJEFT1A
//SYSTSPRT DD   SYSOUT=*
//SYSTSIN  DD   *
  RECEIVE INDATASET('hlq.LEGSTAR.version.LOAD.XMIT')
       DSNAME('hlq.LEGSTAR.version.LOAD')
  RECEIVE INDATASET('hlq.LEGSTAR.version.OBJ.XMIT')
       DSNAME('hlq.LEGSTAR.version.OBJ')
  RECEIVE INDATASET('hlq.LEGSTAR.version.C370.XMIT')
       DSNAME('hlq.LEGSTAR.version.C370')
  RECEIVE INDATASET('hlq.LEGSTAR.version.H370.XMIT')
       DSNAME('hlq.LEGSTAR.version.H370')
  RECEIVE INDATASET('hlq.LEGSTAR.version.CNTL.XMIT')
       DSNAME('hlq.LEGSTAR.version.CNTL')
  RECEIVE INDATASET('hlq.LEGSTAR.version.COBOL.XMIT')
       DSNAME('hlq.LEGSTAR.version.COBOL')
/*

Finally in the target CICS region:

  • Add hlq.LEGSTAR.version.LOAD to the RPL list
  • Customize and run CSD updates from hlq.LEGSTAR.version.CNTL(CICSCSDU)

Compile and link-edit LegStar programs

If, for some reason, le load modules shipped with the LegStar distribution are not suitable, you can chose to either re-link edit or recompile all the modules.

You might have noticed that the LegStar delivery contains object modules in the hlq.LEGSTAR.version.OBJ library. So you can re-link without recompiling. If you elect to recompile, these object modules will be overridden with yours.

if you decide to compile, make sure you have a C/370 compiler.

The hlq.LEGSTAR.version.CNTL library contains a set of cataloged procedures that you need to customize.

If you elect to recompile, you need to customize:

  • CTRNC370: Translates and compiles a CICS C/370 program and pre-links into an object module.
  • BCMPC370: Compiles a C/370 program and pre-links into an object module.

for link-editing, you need to customize:

  • CLNKC370: Link-edits a CICS object module.
  • BLNKC370: Link-edits an object module.

Once the cataloged procedures are ready, you can use the following JCL's to process all LegStar modules at once:

  • BUILDOBJ: Compiles and pre-links all programs. After you run this job, you need to run BUILDLOA.
  • BUILDLOA: Link-edits all programs. You can use this job on the object modules shipped with LegStar or after you ran BUILDOBJ.