Appendix C: The Trader 2 Application

---

This appendix contains a description of the Trader 2 stock trading application. Most of the components of this application were loaded into the WebSphere Studio Asset Analyzer database to demonstrate the functions and features of the product.

Application overview

The Trader 2 application is used to maintain a stock portfolio held by an individual.

This application enables you to:

• Obtain quotes (in batch mode, you list portfolios and their values)

• Buy more shares of a company’s stock

• Sell currently held shares of a company’s stock

The Trader application uses two data sources:

• Company data

• Customer data

The company file contains the stock name and the past week’s quotes. The customer file contains a record for each customer and company that they own, including the number of shares held.

For batch applications, there are example versions that use two VSAM files, two DB2 tables, or two IMS DB PSBs.

In the CICS application, the transaction input is taken directly from an online user’s interactions. In the batch application, the user’s input is replaced with a sequential file that contains several records that represent the day’s transactions.

Note 

This application does not reflect real-world securities processing. It is merely designed to demonstrate the features of the Application Development Tools.

Components of the Trader 2 application

We downloaded the components for the Trader 2 application from the Web and copied them into data sets based on the instructions found in Appendix C of Introduction to the IBM Application Development Tools for z/OS and OS/390, SG24-6887.

Table C-1 on page 187, Table C-2 on page 188, Table C-3 on page 189, Table C-4 on page 191, Table C-5 on page 192, and Table C-6 on page 192 list all of the components of the Trader 2 application that we loaded into the WSAA database for our demonstrations.

Figure C-1 on page 187, Figure C-2 on page 189, Figure C-3 on page 190, Figure C-4 on page 191, Figure C-5 on page 192, and Figure C-6 on page 193 depict how WSAA represents the information after it is loaded.

Table C-1: Trader 2 application data sets

Name	Description
Source code	DEMOS.PDPAK.SOURCE
Copybooks	DEMOS.PDPAK.COPYLIB
JCL	DEMOS.PDPAK.JCL
Proc	DEMOS.PDPAK.PROCLIB
Map	DEMOS.PDPAK.MAPS

Figure C-1: Library summary of Trader 2 application data sets

Table C-2: Trader 2 source components

Name	Description
Source code	DEMOS.PDPAK.SOURCE
MYTRADMV	COBOL CICS main routine (VSAM)
MYTRADS	COBOL CICS subroutine (VSAM)
MYTRADMD	COBOL CICS main routine (DB2)
MYTRADDD	COBOL CICS subroutine (DB2)
MYTRADMI	COBOL CICS main routine (IMS)
MYTRADI	COBOL CICS subroutine (IMS)
TRADERB	Batch COBOL for VSAM
TRADERD	Batch COBOL for DB2
TRADERI	Batch COBOL for IMS

Figure C-2: Library details of Trader 2 source members

Table C-3: Trader 2 copybook components

Name	Description
Copybooks	DEMOS.PDPAK.COPYLIB
COMPFILE	Record layout for the VSAM Company file
COMPANY	DCLGEN for the Company table
CUSTOMER	DCLGEN for the Customer table
CUSTFILE	Record layout for the VSAM Customer file
NEWTRAD	BMS Map for CICS
TRANFILE	Record layout for the QSAM Transaction file
PCB	IMS PCB model
DLIUIB	IMS DLIUIB
DLI	IMS standard declarations
DLICUST	Layouts for both segments of the Customer database
DLICOMP	Layouts for the segment of the Company database
SQLCA	DB2 SQLCA

Figure C-3: Library details of Trader 2 copybook members

Table C-4: Trader 2 JCL components

Name	Description
JCL	DEMOS.PDPAK.JCL
DEFVSAM1	IDCAMS DEFINE statements for the VSAM files
TRADERB	Batch job to execute program TRADERB using QSAM
TRADERBS	Batch job to execute program TRADERB using VSAM
TRADERD	Batch job to execute program TRADERD using DB2
TRADERI	Batch job to execute program TRADERI using IMS

Figure C-4: Library details of Trader 2 JCL components

Table C-5: Trader 2 proc components

Name	Description
Proc	DEMOS.PDPAK.PROCLIB
IMSGO	IMS compile, link, and go procedure

Figure C-5: Library details of Trader 2 proc components

Table C-6: Trader 2 map components

Name	Description
Map	DEMOS.PDPAK.MAPS
NEWTRAD	BMS Map for CICS

Figure C-6: Library detail of Trader 2 map components

---