Appendix B. List of CD-ROM Files

The sample that is described in this book is a simplified application that dynamically creates, reads, updates, and deletes customer records. It is based on a COBOL application that has been written as a two-tier structure of business and presentation logic. This permits the flexibility of a variety of frontends to the business logic. The application shows a web-based frontend using a Java ORB approach with IIOP, a second web-based frontend ECI to link to Business logic, an interface to allow messaging through the facilities of MQSeries, as well as the traditional 3270 frontend.

The sample is implemented as a set of COBOL programs, copybooks, BMS maps, and mapsets. These are supplied in both source code and are also compiled for use with CICS TS V1.3 in an LE environment. In addition to the COBOL programs the code is provided for the Java ORB and Web, HTML pages, and the code for Parts 6 and 7.

Files Used by the COBOL Application

Table B-1. Files Used by the COBOL Application

File	Description
Loadlib
nact01.cobol	This is the load module for the program that provides the frontend interface (presentation logic) for 3270 terminals as part of the sample application. It is the first program executed when the transaction NACT is run.
nact02.cobol	This is the load module for the program, which provides the Create, Read, Update, Delete (CRUD) functions of the sample application. It is designed to be LINKed to in order to allow any number of front-ends to use its services.
nact03.cobol	This is the load module for the program, which provides the convenience print function as part of the sample application.
nact04.cobol	This is the load module for the program, which provides the error and ABEND handling logic for the sample application.
nact05.cobol	This is the load module for the program, which provides the Name Search (Browse) function for the sample application. It is designed to be LINKed to in order to allow any number of frontends to use its services.
nactset.map	This is the assembled module for the maps used by the Designing & Programming CICS Applications book sample application.
RDO
cics0adp.txt	These are the CICS Resource Definitions, which must be installed for the COBOL Application to run.
cicsjadp.txt	These are the CICS Resource Definitions, which must be installed for the Web Component to run.
Sample_JCL
csdupdte.jcl	This is sample JCL to update a CSD with the resource definitions for the sample application.
vsam.jcl	This is sample JCL to DELETE/REDEFINE/SETUP for the sample VSAM datasets.
Source
naccbrws.cobcopy	This COBOL Copybook is the linkage COMMAREAs version of the interface to the Browse (NACT05) program.
nacccrud.cobcopy	This COBOL Copybook is the linkage COMMAREAs version of the interface to the CRUD (Create, Read, Update, and Delete) NACT02 program.
naccerrh.cobcopy	This COBOL Copybook is the linkage COMMAREAs version of the interface to the Error Handler (NACT04) program.
nacctrec.cobcopy	This COBOL Copybook is the linkage COMMAREAs version of the Account record layout.
nact01.cobol	This is the source file for the program, which provides the frontend interface (presentation logic) for 3270 terminals as part of the sample application. It is the first program executed when the transaction NACT is run.
nact02.cobol	This is the source file for the program, which provides the CRUD functions of the sample application. It is designed to be LINKed to in order to allow any number of frontends to use its services
nact03.cobol	This is the source file for the program, which provides the convenience print function as part of the sample application.
nact04.cobol	This is the source file for the program, which provides the error and abend handling logic for the sample application.
nact05.cobol	This is the source file for the program, which provides the Name Search (Browse) function for the sample application. It is designed to be LINKed to in order to allow any number of frontends to use its services.
nacset.dsect	This is the DSECT file for the maps used by the sample application.
nactset.map	This is the source file for the maps used by the sample application.
nacwbrws.cobcopy	This COBOL Copybook is the working storage version of the interface to the Browse (NACT05) program.
nacwcrud.cobcopy	This COBOL Copybook is the working storage version of the interface to the CRUD (NACT02) program.
nacwerrh.cobcopy	This COBOL Copybook is the working storage version of the interface to the Error Handler (NACT04) program
nacwlits.cobcopy	This COBOL Copybook is used in working storage and contains a number of commonly used variables, which are static while the application is running, but may be changed at a later date. These include, transaction names, program names, filenames, system traps, and abends.
nacwlock.cobcopy	This COBOL Copybook is used in working storage and contains a description of the logical locking (“in use”) record. It is only used in the CRUD (NACT02) program but could, theoretically, be used in some other program.
nacwtrec.cobcopy	This COBOL Copybook is the working storage version of the Account record layout.
Data
cicsadp.txt	The file contains the data to be placed in the sample VSAM file.