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 3: BMC PARMLIB Implementation

Related topics

Installation-and-Configuration-Guide

PARMLIB-Members

This milestone contains tasks that help prepare for configuration of Code Debug CICS for both a new install and an upgrade.

This task requires the Code Debug CICS installer.

Complete the following tasks to prepare for Code Debug CICS configuration.

Task 3.1 Implement the BMC PARMLIB

Starting with release 17.02, BMC mainframe products, including Code Debug CICS, use parameter libraries (PARMLIBs) in conjunction with the BMC AMI Common Mainframe Services Controller (CMSC) to configure each product as well as common components. The CMSC was installed as part of the Enterprise Common Components installation.

In this task, you will implement the BMC PARMLIB for Code Debug CICS. This consists of creating default members and updating the CMSC with them. The sample members are suffixed with 00 and should contain the values you want for all CICS test regions in which Code Debug CICS and Code Coverage are installed. The sample members suffixed with PROD contain suggested values for CICS production regions in which Code Debug CICS and Code Coverage are installed.

This task is necessary for both new installation and an upgrade of Code Debug CICS to release 17.02.

Important

Whenever you modify an existing BMC PARMLIB member or add a new member, you will need to use the CMSC REFRESH command to update the contents of the CMSC cache.

Task 3.1.1 Create the Default Members

Copy the associated members from the Code Debug CICS SMXDSAMP library members into your BMC PARMLIB data set. The SMXDSAMP library members are set up for the most common settings in a test region.

 BMC PARMLIB Members for Test Regions

Product

Contents

Member
Prefix

Default
Member

SMXDSAMP
Library Members

Code Debug CICS

Code Debug CICS Parameters

XDGB

XDGB00

XDGB00, XDGBALL

Code Debug CICS

Code Debug CICS System Facilities and Code Coverage Test Parameters

XDDB

XDDB00

XDDB00, XDDBALL

Code Coverage

Code Coverage Parameters

XVGB

XVGB00

XVGB00, XVGBALL

If you are planning to install Code Debug CICS and Code Coverage for use in a production region, copy the following member from your Code Debug CICS SMXDSAMP library into your BMC PARMLIB data set.

BMC PARMLIB Members for Production Regions 

Product

Contents

Member
Prefix

SMXDSAMP
Library Member

Code Debug CICS

Suggested Code Debug CICS Parameter settings for production regions

XDGB

XDGBPROD

Task 3.1.2 Update the CMSC with your PARMLIB Members

Use the z/OS MODIFY (F) command to update the CMSC with the PARMLIB members you created.

Refreshing All PARMLIB Members

F cmscname,PARMLIB REFRESH

Refreshing a Single Parameter Member

F cmscname,PARMLIB REFRESH member_name


Important

During the refresh process, parameter values are validated. If they are found to be invalid, an error message is written to the FDBDLOG SYSOUT data set associated with the ECC CMSC instance where the member is being refreshed. If an error is detected, the contents of the in-core member will not be refreshed. You must correct the error and refresh the member before attempting to use it.

 

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