The CICS BAC components that you need in your CICS® regions consist of:
You might also want to take advantage of CICS TS features that allow you to activate automatically CICS BAC support during CICS initialization and terminate it automatically during CICS shutdown processing.
The following checklist summarizes the main steps described in the following topics:
Ensure the CICS BAC load modules are available to your CICS region before attempting to activate CICS BAC. The load modules are installed in the SCBKLOAD load library when you installed CICS BAC. The CICS BAC Program Directory provides information about the location and name of the load library. To make the load modules available to CICS, you can:
Although the first method is recommended, it requires you to restart the CICS region after you've modified the JCL. The second method allows you make the CICS BAC modules available without restarting CICS. However, keeping product load modules in their respective data sets is normally recommended
CICS BAC requires the following CICS resource definitions to enable CICS BAC support in a CICS region:
You can use the CICS CEDA transaction to define the above, as shown in the examples later in this section. Alternatively, the SCBKSAMP data set contains JCL and input statements that you can customize and use to define the resources using the CICS DFHCSDUP batch utility program. The SCBKSAMP members for the transaction, program, and file definitions are CBKTRANS, CBKPROGS, and CBKFILES, respectively. For more information about defining CICS resources using the DFHCSDUP utility, see the CICS Resource Definition Guide. for your release of CICS TS.
Regardless of which of the two methods you choose to define the CICS BAC resources, you should allow any parameters not explicitly specified in the commands described in this section to take their default values. Also, for ease of use, use the same group name for all definitions.
Define the CICS BAC transaction so that you can activate and control CICS BAC in the CICS region. You should define the CICS BAC transaction, even though you can start CICS BAC by including an entry in the CICS region PLTPI table.
Except for the last character, the CICS BAC transaction ID is not fixed, but KBKM is the preferred ID. If the KBK transaction prefix conflicts with existing definitions, or does not meet your installation standards, specify a different prefix, ensuring the first three characters are in the character set allowed by CICS. The fourth character of the transaction identifier must be the letter M. To avoid confusion, we recommend that you use the KBK prefix if possible. Note that you cannot change the prefix of CICS BAC program names.
You can use the CEDA command shown in Figure 3 to define the CICS BAC transaction resource definition in an active CICS region.
CEDA DEFINE GROUP(cbkgroup) TRANSACTION(kbkM) PROGRAM(CBKCMNDS)
TASKDATALOC(ANY) TASKDATAKEY(CICS)
You can use the sample commands in Figure 4 to define the programs and mapsets that CICS BAC requires.
CEDA DEFINE GROUP(cbkgroup) PROGRAM(CBKCBIRS) DATALOCATION(ANY) LANGUAGE(ASSEMBLER) EXECKEY(CICS)
CEDA DEFINE GROUP(cbkgroup) PROGRAM(CBKCENQU) DATALOCATION(ANY) LANGUAGE(ASSEMBLER) EXECKEY(CICS)
CEDA DEFINE GROUP(cbkgroup) PROGRAM(CBKCMNDS) DATALOCATION(ANY) LANGUAGE(ASSEMBLER) EXECKEY(CICS)
CEDA DEFINE GROUP(cbkgroup) PROGRAM(CBKCIOBJ) DATALOCATION(ANY) LANGUAGE(ASSEMBLER) EXECKEY(CICS)
CEDA DEFINE GROUP(cbkgroup) PROGRAM(CBKCMODA) DATALOCATION(ANY) LANGUAGE(ASSEMBLER) EXECKEY(CICS)
CEDA DEFINE GROUP(cbkgroup) PROGRAM(CBKCMODB) DATALOCATION(ANY) LANGUAGE(ASSEMBLER) EXECKEY(CICS)
CEDA DEFINE GROUP(cbkgroup) PROGRAM(CBKCMODC) DATALOCATION(ANY) LANGUAGE(ASSEMBLER) EXECKEY(CICS)
CEDA DEFINE GROUP(cbkgroup) PROGRAM(CBKCMODD) DATALOCATION(ANY) LANGUAGE(ASSEMBLER) EXECKEY(CICS)
CEDA DEFINE GROUP(cbkgroup) PROGRAM(CBKCMODE) DATALOCATION(ANY) LANGUAGE(ASSEMBLER) EXECKEY(CICS)
CEDA DEFINE GROUP(cbkgroup) PROGRAM(CBKCRHST) DATALOCATION(ANY) LANGUAGE(ASSEMBLER) EXECKEY(CICS)
CEDA DEFINE GROUP(cbkgroup) PROGRAM(CBKCSETF) DATALOCATION(ANY) LANGUAGE(ASSEMBLER) EXECKEY(CICS)
CEDA DEFINE GROUP(cbkgroup) PROGRAM(CBKCSETP) DATALOCATION(ANY) LANGUAGE(ASSEMBLER) EXECKEY(CICS)
CEDA DEFINE GROUP(cbkgroup) PROGRAM(CBKCSETQ) DATALOCATION(ANY) LANGUAGE(ASSEMBLER) EXECKEY(CICS)
CEDA DEFINE GROUP(cbkgroup) PROGRAM(CBKCSETT) DATALOCATION(ANY) LANGUAGE(ASSEMBLER) EXECKEY(CICS)
CEDA DEFINE GROUP(cbkgroup) PROGRAM(CBKCSHUT) DATALOCATION(ANY) LANGUAGE(ASSEMBLER) EXECKEY(CICS)
CEDA DEFINE GROUP(cbkgroup) PROGRAM(CBKCSRSC) DATALOCATION(ANY) LANGUAGE(ASSEMBLER) EXECKEY(CICS)
CEDA DEFINE GROUP(cbkgroup) PROGRAM(CBKCSRVR) DATALOCATION(ANY) LANGUAGE(ASSEMBLER) EXECKEY(CICS)
CEDA DEFINE GROUP(cbkgroup) PROGRAM(CBKCSTAT) DATALOCATION(ANY) LANGUAGE(ASSEMBLER) EXECKEY(CICS)
CEDA DEFINE GROUP(cbkgroup) PROGRAM(CBKFSXnn) DATALOCATION(ANY) LANGUAGE(ASSEMBLER) EXECKEY(CICS)
CEDA DEFINE GROUP(cbkgroup) PROGRAM(CBKMTENU) DATALOCATION(ANY) LANGUAGE(ASSEMBLER) EXECKEY(CICS)
CEDA DEFINE GROUP(cbkgroup) PROGRAM(CBKMTxxx) DATALOCATION(ANY) LANGUAGE(ASSEMBLER) EXECKEY(CICS)
CEDA DEFINE GROUP(cbkgroup) PROGRAM(CBKSPXnn) DATALOCATION(ANY) LANGUAGE(ASSEMBLER) EXECKEY(CICS)
CEDA DEFINE GROUP(cbkgroup) MAPSET(CBKMAP1)
Define the CICS BAC control file using the sample CEDA command shown in Figure 5.
CEDA DEFINE GROUP(cbkgroup) FILE(CBKCNTL) DSNAME(hlq.control.file) LSRPOOLID(NONE)
When you have defined the CICS BAC transaction, programs, and file resources, you can install the definitions in the running CICS region using the CEDA INSTALL command:
CEDA INSTALL GROUP(cbkgroup)
where cbkgroup is the group name you specified for the CICS BAC resource group in the CSD.
To install the CICS BAC resources automatically during CICS initialization, add your CICS BAC group name to a CICS startup list using the CEDA ADD command:
CEDA ADD GROUP(cbkgroup) LIST(listname)
where cbkgroup is the group name you specified for the CICS BAC resource group in the CSD, and listname is the name of the startup list to which you want to add the group name.
Alternatively, you can edit the ADD GROUP command in one of the sample DFHCSDUP jobs, such as CBKFILES, to specify an appropriate group name.
CICS BAC also uses following CICS services. These services are:
In addition to its own comprehensive security mechanisms to protect CICS BAC resources (see CICS BAC security), CICS BAC also uses CICS external interface (EXCI ) security; see CICS BAC support for CICS EXCI security.