Operational considerations


PARMLIB product configuration

For more information on changing a PARMLIB member, configuring BMC AMI mainframe products, using a non-default CMSC or parameter suffix value, and implementing the zIIP Enablement Service, see the CMSC Administration section in this topic.

Copying sample PARMLIB members

Copy the provided sample to your site’s common PARMLIB data sets for BMC.

Warning

Important

BMC AMI mainframe products version 17.02 and later, require the BMC AMI Common Mainframe Services Controller (CMSC) release 16.05 with all current maintenance applied.

Updating the CMSC with PARMLIB information

  1. Make your product’s PARMLIB members available in the //CWPARM concatenation of the BMC AMI Common Mainframe Services Controller (CMSC). The PARMLIB data set can be allocated as either a PDS or a PDSE.
  2. After making changes to your PARMLIB members, use the z/OS MODIFY command to update the CMSC with the changes you made to the PARMLIB member.

    Warning

    Important

    The MODIFY command requires proper OPERATOR authority.

    The verb MODIFY can be abbreviated, F.

    Refreshing all PARMLIB Members:

    F cmscname,PARMLIB REFRESH

    Refreshing a Single Parameter Member:

    F cmscname,PARMLIB REFRESH member_name

    For example, you updated the parameters in member FACM00:

    F cmscname,PARMLIB REFRESH FACM00

  3. Specify the name of CMSC PARMLIB members DDSNnnnn (default is DDSN00, or the specified default in your site’s CMSC start-up) with the DDNAMEs and DATASET NAMEs of all BMC AMI products, such as File-AID, BMC AMI DevX Code Debug for TSOBMC AMI DevX Abend-AID, etc. A sample is located in hlq.SLCXCNTL(DDSN00). 
    DDSNnnnn provides the names of BMC run-time libraries installed at your site. You will need the DDSNnnnn names if you wish to use Simple Deploy for configuring your BMC AMI mainframe products.

CMSC administration

BMC AMI mainframe products use parameter libraries, or PARMLIBs for setting their configuration and customizations values. We recommend storing your site’s PARMLIB members in a common library. A copy of your product’s parameter files must reside in the //CWPARM concatenation of the BMC AMI Common Mainframe Services Controller (CMSC).

The CWPARM is the DD from which the CMSC retrieves the parameters. This DD is a concatenated list of all data sets containing the PARMLIB members for each of the BMC AMI mainframe products. The CMSC will only read members into storage that contain the product prefixes specified in BMC AMI product PARMLIB member parameters. Sample parameter files provided in SLCXCNTL may be copied to the desired CWPARM data set and then modified to site-specific requirements.

CMSC start-up parameters (BMC AMI product PARMLIB member parameters) specify the default 1 to 4 character suffix for all the BMC AMI product PARMLIB members. If the parameter value for a given product is omitted (null or blank), the default suffix will default to 00.

The product parameter is specified followed by the equal sign, and then the 1 to 4 character suffix (for example: LMCL=01 points to PARMLIB member LMCL01).

BMC AMI product PARMLIB member parameters

Product PARMLIB Member Parameters

Two-Character Product Code Override

Product

AABD

AB

BMC AMI DevX Abend-AID BDCAS

AADC

AD

BMC AMI DevX Abend-AID DCAS

AAFA

AF

BMC AMI DevX Abend-AID Fault Analytics

AATD

AT

BMC AMI DevX Abend-AID TDCAS

AAVW

AV

BMC AMI DevX Abend-AID Viewer

CMSC

--

BMC AMI Common Mainframe Service Controller

CSS

CX

BMC AMI Common Shared Services

CWGL

--

BMC Global Parameters

DDSN

DD

Simple Deploy

FACM

FC

File-AID Common Component

FADA

DA

BMC AMI DevX File-AID/Data Solutions

FADE

F1

File-AID DB2 Environment Information

FAMV

FA

BMC AMI DevX File-AID/MVS

FAFR

FR

BMC AMI DevX File-AID/RDX

FAFD

FD

BMC AMI DevX File-AID for Db2

FAIE

FE

File-AID IMS Environment Information

FAIX

FI

BMC AMI DevX File-AID for IMS

HCI

HC

Host Communications Interface

IWCM

IM

Code Pipeline Server

IWCT

IT

Code Pipeline Component Transport task

IWCI

II

Code Pipeline Communications Interface task

HSCM

QF

BMC AMI DevX Performance Test

LMCL

LM

License Management Client

STR

SB

BMC AMI Strobe

XATZ

--

BMC AMI DevX Total Test Functional Test

XVGB

X1

BMC AMI DevX Code Debug for CICS Code Coverage

XDGB

X2

BMC AMI DevX Code Debug for CICS Global

XDDB

X3

BMC AMI DevX Code Debug for CICS DBPA

XD$$

X4

BMC AMI DevX Code Debug for CICS Index member

XCHG

XG

BMC AMI DevX Xchange

XTSO

XT

BMC AMI DevX Code Debug for TSO

XCOV

XV

BMC AMI DevX Code Coverage

XVGB

X1

BMC AMI DevX Code Debug for CICS Code Coverage

XDGB

X2

BMC AMI DevX Code Debug for CICS Global

XDDB

X3

BMC AMI DevX Code Debug for CICS DBPA

XCHG

XG

BMC AMI DevX Xchange

XTSO

XT

BMC AMI DevX Code Debug for TSO

Warning

Important

We recommend that the CMSC be started using the MVS START command with the LINES=(nnnnnn,WARNING) option, where nnnnnn represents the number of lines (in thousands), to be printed by the CMSC. This causes a warning message to be issued instead of causing the CMSC to be cancelled when the specified number of lines have been written. 

If WARNING is not specified, then the CMSC will be cancelled by the system.  Closing/freeing and reallocating/opening CWMTDSP, using the MAINTENANCE_DISPLAY_OUTLIM parameter or using the MAINTDSP operator command, does not prevent that from happening. 

For example, in the command below the specified number of lines, that is 1000, represents 1,000,000 lines:

S CMSC,LINES=1000

Validating PARMLIB member contents

Program MSCUPRMD is a PARMLIB utility that employs the current CMSC API to display a PARMLIB member's contents as they are known to the CMSC. MSCUPRMD is a TSO command processor so it is recommended that this program reside in the linklist.

If the command is issued from native TSO, the data is displayed to the screen. If the command is issued in ISPF, the data is displayed in a temporary data set.

The MSCUPRMD command can display the active BMC BMC Global Parameter member by specifying values of either CWGL or GLOBAL as the name of the PARMLIB member.

Error
Warning

Although CMSCxxxx PARMLIB members can be displayed, verified, and refreshed using the MSCUPRMD command, a refreshed CMSCxxxx PARMLIB member will not be used until the CMSC using that member is restarted. When a CMSCxxxx PARMLIB is displayed, it may not show the parameters that are currently being used by an active CMSC, because the member may have been refreshed after the CMSC was started.

Command syntax

TSO MSCUPRMD MEMB=member_name|CWGL|GLOBAL,CMSC=cmsc_id[,VERIFY|REFRESH]

where,

  • member_name  represents the name of the PARMLIB member you wish to display. It is a required keyword and its value cannot exceed 8 characters in length.
  • CWGL is the prefix attributed to the global parameter member.
  • GLOBAL is the value given to display the global parameter member
  • cmsc_id is the name of the CMSC that the PARMLIB member is defined to. Its value must be 4 characters in length and will default to a value of 'CMSC', if omitted.
Warning

Important

  • The PARMLIB member specified on the MSCUPRMD command is not displayed if the VERIFY or REFRESH options are specified.
  • Both MEMB=CWGL and MEMB=GLOBAL result in the active BMC Global Parameter member being displayed.
  • The CWGLxxxx member is optional. However, if it does not exist, zAdviser will not be enabled.

 

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

BMC AMI Enterprise Common Components 17.02