Customizing the Xchange PARMLIB

Starting with release 17.02, BMC AMI mainframe products, including Xchange, 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 PARMLIB for Xchange. 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 Xchange and Code Coverage are installed. The sample members suffixed with PROD contain suggested values for CICS production regions in which Xchange and Code Coverage are installed.

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

Tip

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.

Create the Default Members

Copy the associated members from the Xchange 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
Xchange	Xchange Global Parameter settings	XDGB	XDGB00	XDGB00, XDGBALL
Xchange	Xchange DBPA Parameter	XDDB	XDDB00	XDDB00, XDDBALL
Code Coverage	Code Coverage Global Parameter settings	XVGB	XVGB00	XVGB00, XVGBALL

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

BMC PARMLIB Members for Production Regions

Product	Contents	Member Prefix	SMXDSAMP Library Member
Xchange	Suggested Xchange Global Parameter settings for production regions	XDGB	XDGBPROD

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

Tip

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.