Topaz for Total Test Sample Training Programs

The Enterprise Common Components (ECC) sample library (hlq.SLCXCNTL) includes sample programs you can use to demonstrate Topaz for Total Test functionality and to verify the Topaz for Total Test installation. We recommend that, in addition to these procedures, you test your own application programs before considering the installation complete.

Topaz for Total Test Sample Training Files

Member	Function
CSDKTXD	Member CSDKTXD contains the RDO definitions for the CICS test program. It defines the programs, transactions, and files used by KTX2DEMO and KTXDDEMO.
CWKTCDB2	Sample JCL used to prepare the Db2 test program and also Create, and Grant a Db2 table. The last step also executes the program.
CWKT	COBOL source code for use with with Db2 table.
CWKTCOBX	COBOL source code for use with QSAM input file.
CWKTDATE	COBOL source code for sub program used with test programs CWKTCOBX, CWKTDB2X, CWKTVSKS, KTX2DEMO, and KTXDDEMO.
CWKTSUBC	COBOL source code for sub program used with test programs CWKTCOBX, CWKTDB2X, and CWKTVSKS.
CWKTVSKS	COBOL source code for use with VSAM input file.
KTX2DEMO	COBOL source code for use with CICS commands.
KTXDDEMO	COBOL source code for use with CICS commands.
LAUNCHDB	Sample JCL for use with Xpediter/Eclipse launch configuration for test program CWKTDB2X.
LAUNCHCX	Sample JCL for use with Xpediter/Eclipse launch configuration for test program CWKTCOBX.
LAUNCHKS	Sample JCL for use with Xpediter/Eclipse launch configuration for test program CWKTVSKS.
RUNNERDB	Information on how to create a RunnerDB2.jcl file for use with test program CWKTDB2X.
RUNNERCX	Information on how to create a Runner.jcl file for use with test program CWKTCOBX.
RUNNERKS	Information on how to create a Runner.jcl file for use with test program CWKTVSKS.
TTTDATD	Used as a QSAM input file for test program CWKTDB2X.
TTTDATH	Used as a QSAM input file for test program CWKTCOBX.
VSAMKSDC	Sample JCL used to create a VSAM KSDS copy file for test program KTX2DEMO.
VSAMKSDS	Sample JCL used to create a VSAM KSDS input file for test program CWKTVSKS and KTX2DEMO.

Compile and Bind Programs

Use the Compuware Shared Services (CSS) COBOL Language Processor (LP) to compile the sample programs and write source listings to a DDIO file. Refer to the BMC Compuware Shared Services Compuware Source Support Best Practices for information on using the COBOL Language Processor.

Option 1: Use ISPF CSS Utilities to convert existing compile JCL by selecting Option 2.1 (Convert existing compile JCL to use LP).
Option 2: Use ISPF CSS Utilities to create new compile JCL by selecting Option 2.2 (Create compile JCL to use LP).
Option 3: Use the ISPF Xpediter/TSO Compile Facility by selecting Option 1 (PREPARE) from the Xpediter/TSO Primary Menu. Refer to the Xpediter/TSO and Xpediter/IMS COBOL User Guide for more information.
Option 4: Manually convert compile and bind JCL and set up LP parameters to write source listings to a DDIO file. Refer to the BMC Compuware Shared Services User/Reference for more information.

Important

Xpediter requires certain compile options that vary depending on the COBOL version being used to compile. For example, NOOPTIMIZE must be used with Enterprise COBOL V4; however, OPTIMIZE(1) and OPTIMIZE(2) can be used with Enterprise COBOL V6 when TEST is also used. Refer to the BMC Compuware Shared Services User/Reference and Compuware Shared Services Compuware Source Support Best Practices.
Some of these sample programs are main programs and others are subprograms. Some subprograms are statically linked and called.
The SYSLMOD output from these compiles should be directed to a dataset used by your application programmers for training sessions. It is strongly recommended that this be a dataset other than the ECC LOADLIB library.

CWKTCOBX Test Program

CWKTCOBX is a COBOL QSAM demo program that utilizes sub programs CWKTDATE and CWKTSUBC. Compile CWKTDATE and CWKTSUBC first before CWKTCOBX.

The LAUNCHCX member contains sample JCL. Use it in an Xpediter/Eclipse Batch debug launch configuration to execute the CWKTCOBX program and to easily generate Topaz for Total Test unit tests.

The RUNNERCX member contains information on how to create a Runner.jcl file for use with test program CWKTCOBX in a Topaz for Total Test Project JCL folder.

CWKTDB2X Test Program

CWKTDB2X is a COBOL demo program that accesses a Db2 table and utilizes sub programs CWKTDATE and CWKTSUBC. Compile CWKTDATE and CWKTSUBC first before CWKTDB2X. The CWKTCDB2 member contains sample JCL used to prepare the test program and also Create and Grant a Db2 table. The last step also executes the program.

The LAUNCHDB member contains sample JCL. Use it in an Xpediter/Eclipse Batch debug launch configuration to execute the CWKTDB2X program and to easily generate Topaz for Total Test unit tests.

The RUNNERDB member contains information on how to create a RunnerDB2.jcl file for use with test program CWKTDB2X in a Topaz for Total Test Project JCL folder.

CWKTVSKS Test Program

CWKTVSKS is a COBOL VSAM KSDS demo program that also utilizes sub programs CWKTDATE and CWKTSUBC. Compile CWKTDATE and CWKTSUBC first before CWKTVSKS.

Use the VSAMKSDS member to create a sample VSAM KSDS input file. The dataset created from this member is used in the LAUNCHKS and RUNNERKS JCL members.

The LAUNCHKS member contains sample JCL. Use it in an Xpediter/Eclipse Batch debug launch configuration to execute the CWKTVSKS program and to easily generate Topaz for Total Test unit tests.

The RUNNERKS member contains information on how to create a Runner.jcl file for use with test program CWKTVSKS in a Topaz for Total Test Project JCL folder.

KTX2DEMO

The CICS COBOL sample program KTX2DEMO and related sub program CWKTDATE demonstrate a wide variety of supported EXEC CICS commands. Functions demonstrated in this program are file I/O, Transient Data queue, Channels and Containers, delay, Write to operator, cancel, retrieve, start, and syncpoint.

In addition to the main program KTX2DEMO you will need to first compile and link sub program CWKTDATE. Both programs need to be linked with AMODE(31),RMODE(ANY). Refer to the Xpediter for CICSdocumentation on compiling and linking.

2 VSAM files need to be created using the VSAMKSDS and VSAMKSDC members to create sample VSAM KSDS input files.

The required RDO entries for this program can be added via the CSDKTXD sample member.

KTXDDEMO

The CICS COBOL sample program KTXDDEMO and related sub program CWKTDATE demonstrate the initial group of supported EXEC CICS commands. In addition to the main program KTXDDEMO, you will need to first compile and link sub program CWKTDATE. Both programs need to be linked with AMODE(31),RMODE(ANY). Refer to the Xpediter for CICS documentation on compiling and linking.