
                     CICS for OS/2 Version 3.1 Samples - README
                     -----------------------------------------



This README file describes the process for compiling and executing the various samples
supplied with CICS for OS/2.

ECI - Exernal Call Interface
EPI - External Presentation Interface
ETI - External Transaction Interface

DB2 - DB2 / UDB interface

'C' Samples ---> ....\tools\c\samples\source

	Front-end Program	Compiled by		Back-end Transaction 		Built by
------------------------------------------------------------------------------------------------
ECI	ECIWAIT.C		MECIWAIT.CMD		-				-
	ECOACB32.C		MECOACB3.CMD		FVECWTO2.CCS			cicsctcl
	ECOAS32S.C		MECOAS32.CMD		FVECWTO2.CCS			cicsctcl
	ECOAWM32.C		MECOAWM3.CMD		FVECWTO2.CCS			cicsctcl
	ECOSTATE.C		MECOSTAT.CMD		-				-
	ECOSYN.C		MECOSYN.CMD		FVECWTO2.CCS			cicsctcl
EPI	EPISAMP.C		MEPISAMP.CMD		EPI1.CCS			cicsctcl
ETI	ETISAMP.C		METISAMP.CMD		ETI1.CCS			cicsctcl

	Program			Built by
------------------------------------------------------------------------------------------------
DB2	FAACCDB2.CCS		MFAADB2.CMD** calls CICSCTCL
	FAARMDBM.SQC		MFAADB2.CMD calls MFAARMDB.CMD
	FAACCDBM.BMS		MFAADB2.CMD calls CICSMAP


COBOL Samples ---> ....\tools\cobol\sample\source

	Front-end Program	Compiled by		Back-end Transaction 		Built by
------------------------------------------------------------------------------------------------
ECI	ECIWAIT.CBL		MECIWAIT.CMD		-				-
	ECOAS32S.CBL		MECOAS32.CMD		FVECWTO1.CCP			cicstcl
	ECOSTATE.CBL		MECOSTAT.CMD		-				-
	ECOSYN.CBL		MECOSYN.CMD		FVECWTO1.CCP			cicstcl
EPI	EPISAMP.CBL		MEPISAMP.CMD		EPI1.CCP			cicstcl
ETI	ETISAMP.CBL		METISAMP.CMD		ETI1.CCP			cicstcl

	Program			Built by
-------------------------------------------------------------------------------------
DB2	FAADCDB2.CCS		MFAADB2.CMD** calls CICSTCL
	FAARMDBM.SQC		MFAADB2.CMD calls MFAARMDB.CMD
	FAADCDBM.BMS		MFAADB2.CMD calls CICSMAP

PLI Samples ---> ....\tools\pli\samples\source

	Front-end Program	Compiled by		Back-end Transaction 		Built by
------------------------------------------------------------------------------------------------
ECI	ECIWAIT.PLI		MECIWAIT.CMD		-				-
	ECOACB32.PLI		MECOACB3.CMD		FVECWTO.PLI			cicspclk
	ECOAS32S.PLI		MECOAS32.CMD		FVECWTO.PLI			cicspclk
	ECOAWM32.PLI		MECOAWM3.CMD		FVECWTO.PLI			cicspclk
	ECOSTATE.PLI		MECOSTAT.CMD		-				-
	ECOSYN.PLI		MECOSYN.CMD		FVECWTO.PLI			cicspclk
EPI	EPISAMP.PLI		MEPISAMP.CMD		EPI1.PLI			cicspclk
ETI	ETISAMP.PLI		METISAMP.CMD		ETI1.PLI			cicspclk

	Program			Built by
-------------------------------------------------------------------------------------
DB2	FAADPDB2.CCS		MFAADB2.CMD** calls CICSPCLK
	FAARMDBM.SQC		MFAADB2.CMD calls MFAARMDB.CMD
	FAADPDBM.BMS		MFAADB2.CMD calls CICSMAP


Compiling the individual samples
--------------------------------

   Each individual sample has an associated '.cmd' (make) file. This file, when executed,
   compiles, links and builds the required sample, creating a '.exe' file.

   For example:  running 'mepisamp.cmd' will build the sample 'EPISAMP.*'

   Where the sample uses a transaction in the CICS region this can be built by the
   CICS translate, comple and link comand shown.

   For example:  running 'cicstcl fvecwto1.ccp' will build the COBOL sample transaction 'FVECWTO1'

   ** Note. The MFAADB2.CMD file should be edited to insert The DB2 Administrator Userid and
            Password in place of 'USERID' and 'PASSWORD' in the statemant
            'LOGON USERID /P:PASSWORD /L'
  
Executing the samples
---------------------

  Each sample can be executed by:
 1. Starting up the CICS system - 'start cicsrun /c'
 2. In the directory where the sample was compiled - run the executable.

 3. In the case of the DB2 samples - with the Database Manager started 
    a. log in to CICS and define a transaction for the DB2 sample transaction in the PCT
       using CEDA
    b. key in that transaction name to execute the DB2 sample transaction
    
Trademarks
----------
      CICS and OS/2 are trademarks of the IBM Corporation
      in the United States and other countries, or both.
