CICS Programs to Virtualize Panel

Using CA Service Virtualization › Using the Workstation and Console with CA Service Virtualization › Creating Service Images › Create Service Image by Recording › Transport Protocols › Record CICS (LINK DTP MRO) › CICS Programs to Virtualize Panel

Use the CICS Programs to Virtualize panel to:

Explore the CICS regions that are connected to DevTest LPAR Agents
Explore the programs that are defined to these CICS regions
Select the programs to virtualize
Manually add programs to virtualize
Set the filters to refine the CICS LINK statements, transactions, and CICS users that are virtualized
Establish a group membership to virtualize CICS programs in a group of CICS regions

The following graphic shows the main areas of the CICS Programs to Virtualize panel:

The CICS Programs to virtualize selection panel has two main areas.

Available Programs

The Available Programs area lets you explore CICS regions that are connected to DevTest with the DevTest CICS Agent and see the programs that are defined there.

You can explore the known CICS regions and programs by:

LPAR (z/OS Logical Partition)
CICSPlex
User-defined grouping
Region

VTAM APPLIDs (application IDs) identify the CICS regions.

Program Name Prefix

Defines the prefix that the recorder uses to filter which programs to display. The Available Programs area only displays programs that begin with the specified prefix. Always add a program prefix.

Max

Defines the maximum number of programs to display from one CICS region.

The CICS Programs to virtualize selection panel with the CICS LINK recording example environment shown.

Clicking LPAR shows the known LPARs (in this case, S0W1).

Clicking the plus sign next to S0W1 shows the known CICS regions in SOW1: CICST242, CICSTS32, CICSTS41, and CICSTS42.

Clicking the plus sign next to CICSTS41 shows the known programs that match the prefix DEMOGET on CICSTS41 (DEMOGETB and DEMOGETN).

The list under SOW1 also contains DEMOGETB and DEMOGETN because they are programs that were found in the LPAR.

The CICS Programs to virtualize selection panel with nodes expanded to show more detail.

Clicking CICSPlex shows the known CICSPlexs and reveals DEVPLEX1 and DEVPLEX2.

Clicking the plus sign next to DEVPLEX1 shows the known CICS regions: CICST242, CICSTS41, and CICSTS42.

Clicking the plus sign next to CICSTS41 shows the known programs that match the prefix on CICSTS41 (DEMOGETB and DEMOGETN).

The list under DEBPLEX1 also contains DEMOGETB and DEMOGETN because they are programs that were found in the CICSPlex.

Note: For a CICS region to be a member of a CICSPlex group, you must modify a DevTest CICS agent user exit. For more information, see "CICS Agent User Exits" in Agents.

The CICS Programs to virtualize selection panel with User Groups expanded.

Clicking User Group shows the known user groups and reveals GROUP1 and GROUP2.

Clicking the plus sign next to GROUP1 shows the known CICS regions: CICST242, CICSTS41, and CICSTS42.

Clicking the plus sign next to CICSTS41 shows the known programs that match the prefix on CICSTS41 (DEMOGETB and DEMOGETN).

The list under GROUP1 also contains DEMOGETB and DEMOGETN because they are programs that were found in the user group.

Note: For a CICS region to be a member of a user group, you must modify a DevTest CICS agent user exit. For more information, see "CICS Agent User Exits" in Agents.

The CICS Programs to virtualize selection panel with Region expanded.

Clicking Region shows the known CICS Regions and reveals CICST242, CICSTS32, CICSTS41, and CICSTS42.

Clicking the plus sign next to CICSTS41 shows the groups that contain this CICS region.

Clicking the plus sign next to S0W1 (the LPAR group of which this region is a member) shows the known programs that match the prefix on CICSTS41 (DEMOGETB and DEMOGETN).

The list under GROUP1 also contains DEMOGETB and DEMOGETN because they are programs that were found in the user group.

The CICS Programs to virtualize selection panel with Program expanded.

When the program information is retrieved by clicking a CICS region, the grouping by Program folder appears.

Clicking Program reveals all known CICS programs; DEMOGETB and DEMOGETN in this case.

Clicking the plus sign next to DEMOGETB expands the known CICS regions and groups containing DEMOGETB.

Programs to Virtualize

To add programs, double-click them and they appear in the Programs to Virtualize panel. Or, click Add on the Programs to Virtualize panel to add a program manually.

When a program is listed in the Programs to Virtualize panel, double-click it to add filters and groupings.

In this example, program DEMOGETB is virtualized in CICS region CICSTS41. Group S0W1 and LPAR are ignored unless the Any Region check box is selected.

Filters allow you to specify which of the CICS LINKs to DEMOGETB are virtualized.

Screenshot of the Add or Edit Programs window for CICS LINK recordings, with Any Region selected.

Selecting the Any Region check box clears the Region text box and indicates that DEMOGETB will be virtualized in ALL CICS regions in LPAR group S0W1 (all CICS regions residing in LPAR S0W1).

Screenshot of the Add or Edit Programs window for CICS LINK recordings, with filters entered.

In the previous graphic, filters are used to narrow the programs to virtualize.

Link Transaction ID: Indicates that CICS LINKs to DEMOGETB are virtualized only if they are coded with TRANSID(‘TRN1’).
Link System ID: Indicated that CICS LINKs to DEMOGETB are virtualized only if coded with SYSID(‘SYSB’).
EIB Transaction ID: Indicates that CICS LINKs to DEMOGETB are virtualized only if executed while running under the transaction DEM3.
User ID: Indicates that CICS LINKs to DEMOGETB are virtualized only if executed while running under user ID CICSUSR1.