Update the CSD
The CICS CSD data set must be updated with the transaction definitions and program resources that are used by MainView AutoOPERATOR for CICS. The transaction definitions become part of the internal CICS Program Control Table (PCT); the program definitions become part of the internal CICS Processing Program Table (PPT).
This procedure modifies or adds resource groups and group lists to the CICS CSD. The resource groups contain the resource definitions for the PCT and PPT which identify MainView AutoOPERATOR for CICS transactions and programs to a CICS system. The group lists identify the resource groups that are installed at CICS initialization.
The CSDs for each CICS region that communicate with a BBI-SS PAS must be modified.
The BBSAMP members CMRCSDAL, CMRCSDLA, CMRCSDLB and CMDCSDEL contain sample JCL with online program and transaction resource definitions. Use the JCL to define the resource groups that required for MainView AutoOPERATOR for CICS. Each BBSAMP member contains documentation for customizing the JCL.
To modify resource groups and lists
Read the comments in BBSAMP member CMRCSDAL and modify the JCL accordingly.CMRCSDAL creates the BMCMVOLT and BMCMVAAO groups. These groups contain the following resources
Group Name
Resources
BMCMVOLT
Common resources:
- OLTFSET program
- FST2 transaction
- BMCE transaction
BMCMVAAO
MainView AutoOPERATOR for CICS resources
- OLTVCAO program
The CMRCSDAL job submits the CSDcccDF members based on your modifications, where ccc is OLT or AAO.
For more information about the members in the BBSAMP data set, refer to Sample-data-set-members.
- Submit the JCL.
- Check the output for a return no higher than 4.
- Modify and run the BBSAMP member CMRCSDLA.The CMRCSDAL member referred to in Step 1 explains which member to use if you are installing MainView for CICS along with MainView AutoOPERATOR for CICS. In this case, refer to the MainView for CICS Customization Guidefor installation information. These members modify the group list that is used at CICS initialization that contains the BMC Software resource groups.
Remove members from groups BOOLEPCT and BOOLEPPT.Review the instructions in BBSAMP member CMRCSDEL to modify and run the CMRCSDEL job. The CMRCSDEL job deletes obsolete resource definitions from the CICS CSD by removing resource definitions from the existing BOOLEPPT and BOOLEPCT groups.
This job also inserts the correct CSDcccrr members based on the specifications that you enter where
- ccc: corresponds to parameter PRODUCT setting in BBSAMP member CMRCSDEL
- rr: corresponds to the CICS version and release numbers that are defined in BBSAMP member CMRCSDEL
Implement EXCI connection and session definitionsProgram, transaction, connection, and session definitions are required to use the EXCI function. Ensure that all CICS systems have the appropriate EXCI connection and session definitions installed and in service. MainView for CICS provides the necessary program and transaction definitions with BMCE (transaction) and OLTFSET (program).
You must create the connection and session definitions yourself. The connection definitions must specify the EXCI protocol, IRC access method, and CONNTYPE(GENERIC).
Refer to the IBM document CICS External Interfaces Guide for more information about the EXCI interface.
Modify the Program List Table (PLT)The PLT specifies which programs are executed in the post-initialization phase of CICS startup. This procedure modifies the PLT to initiate BBI-SS PAS to CICS communication at CICS startup. Using the PLT to modify MainView AutoOPERATOR for CICS is optional. However, if you do not use the PLT, you must manually start BBI-SS PAS to CICS communication by using the FST2 transaction from the MVS console.
There are two different procedures in this section:
You must complete one of these procedures based upon whether you have an existing PLT or are creating a new PLT. Either procedure automates the initiation of BBI-SS PAS to CICS communication.
To modify an existing PLT
Complete this procedure if you have an existing PLT that you want to modify. Modify the PLT by inserting the appropriate program or using the CMRPLT macro. BMC Software recommends that you manually insert the program name.
To insert the program name manually, find the following statement:
TYPE=ENTRY,PROGRAM=DFHDELIMInsert the following program name immediately after the PROGRAM= DFHDELIM statement:
DFHPLT TYPE=ENTRY,PROGRAM=OLTFSETTo use the CMRPLT macro, find the following statement at the end of the table:
DFHPLT TYPE=FINALInsert the CMRPLT macro invocation immediately before the DFHPLT TYPE=FINAL statement:
CMRPLT MODE=AUTO- Assemble the newly revised PLT.You must include the BBSAMP data set in the assembler SYSLIB concatenation if you use the CMRPLT macro.
Add the PLTPI parameter to the SIT to identify this updated PLT to CICS:
PLTPI=xxwherexx is the suffix of this PLT.
When you have completed the above steps, you have modified the PLT for automatic start up of BBI-SS PAS to CICS communication.
To create a new PLT
Complete this procedure if you need to create a new PLT. Create a new PLT in your CICS table library using a member name that matches the naming conventions used at your site. The new member should contain either a CMRPLT macro invocation or the appropriate program name:
To use the program name, add this statement after the PROGRAM=DFHDELIM statement:
DFHPLT TYPE=ENTRY,PROGRAM=OLTFSETTo use the CMRPLT macro, add this macro invocation:
CMRPLT MODE=AUTO- Assemble the newly revised PLT.You must include the BBSAMP data set in the assembler SYSLIB concatenation if you use the CMRPLT macro.
Add the PLTPI parameter to the SIT to identify this updated PLT to CICS:
PLTPI=xxwhere xx is the suffix of this PLT.
When you have completed the above steps, you have modified the PLT for automatic startup of BBI-SS PAS to CICS communication.