Space announcement This documentation space provides the same content as before, but the organization of the content has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

Milestone 9: Assembling or compiling and link edit test programs


If your site is not using—and does not plan to use—Xchange test programs, you may skip this milestone and continue with Milestone-10-Enabling-CICS-support.

The CPWR.MLXGnnn.SLXGSAMP files comprise programs in various programming languages that you can use to validate Xchange functionality. The PDS member names suggest the languages used, and the comment box in each file briefly describes the file.

The roles involved are: Xchange Installer

  1. Compile and link the members listed in the following table to create a system that can be used to demonstrate Xchange batch functionality.
  2. Any of the demonstration programs listed—except XGBCHDB2—can now be used to verify that Xchange is functioning correctly.

Test programs

Member Name

Description

CWXGCOB

The driver program.

CWXGDATE and CWXGSUBC

Called subprograms.

CWXGDATA

Data used in the system.

CWXGJCLC

JCL to run the system.

XGBASM

An Assembler program.

XGBASMLE

A High-Level Assembler program for LE.

XGBCOBLE

A COBOL program for LE.

XGBPLI

A PLI program.

XGBPLILE

A PLI program for LE.

XGBCHDB2

A program with Db2 calls.


Important

If your site has Code Debug for TSO or Code Debug CICS and you want to use them with the test programs listed in this step, compile the programs with the appropriate BMC AMI Common Shared Services (CSS) language processors. For more information, see BMC AMI Common Shared Services User/Reference Guide.


CICS transaction support test programs


Important

If your site does not require CICS transaction support, you may skip the rest of this step.

Compile and link the programs listed in the following table for use in demonstrating Xchange CICS transaction support. The resource definitions for the following programs or transactions will be added in Task-10-1-Enable-CICS-transaction-support.

CICS Transaction Support Test Programs

Program Name or Transaction Name

Description

XGDEMCBL

A COBOL program with a transaction ID of XGCB.

XGDEMASM

The main Assembler program that links to XGLINKTD or transfers control to XGXCTLTD. The transaction ID for XGDEMASM is XGAS.

XGLINKTD

An Assembler program that links to XGLINK02.

XGLINK02

An Assembler program.

XGXCTLTD

An Assembler program.

XGCCOBLE

A COBOL program for LE. The transaction ID for XGCCOBLE is XGCL.

XGCPLI

A PLI program with a transaction ID of XGPL.

XGCPLILE

A PLI program for LE. The transaction ID is XGPE.

XGCDB2

A program with Db2 calls. XGCD is the transaction ID.

IMS message level support test programs


Important

If your site does not require IMS Message Level Support, you may skip the rest of this step.

The test programs listed in the following table are provided for use in demonstrating Xchange IMS Message Level Support.

IMS Message Level Support Test Programs

Program Name and
Transaction Name

Language Application

XGIASM

Assembler

XGICOB

COBOL (non-LE)

XGIPLI

PL/I

XGICOBLE

COBOL (LE)

To set up these test programs, perform the following steps:

  1. Define the Xchange IMS test programs and their associated transactions to IMS.
    1. Edit the definitions found in CPWR.MLXGnnn.SLXGDATA member XGIDEFT, substituting the desired message class codes for each occurrence of xx, then add those definitions to the appropriate section of your site's IMS STAGE 1 SYSGEN input stream.
    2. Perform an IMS CTLBLKS gen.
  2. Perform an IMS CTLBLKS gen. Perform PSBGENs for the Xchange IMS test programs using your site's standard PSBGEN utility JCL. Use CPWR.MLXGnnn.SLXGDATA member XGIDEFP as input to the PSBGEN utility.
  3. Generate the appropriate ACB control blocks for the Xchange IMS test programs using your site's standard ACBGEN utility.
  4. Run the IMS online change utility to load the control blocks you have generated into the inactive IMS system libraries. These control blocks are ACBLIB and MODBLKS.
  5. Assemble and compile the IMS test programs using your site's standard JCL.
  6. Use CPWR.MLXGnnn.SLXGDATA member XGIMFS as the MFS source to your site's standard JCL for running an MFSGEN. Run this job and verify that the MFS output is correctly created.
  7. Recycle the IMS system and/or execute the necessary /MODIFY PREPARE and /MODIFY COMMIT commands to activate your new control blocks.

Important

Sites with IMS must perform the tasks in Milestone-12-Enabling-IMS-support before using the Xchange demonstration programs listed in the above table (IMS Message Level Support Test Programs).

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*