Task 2—Updating the CICS system definition file

Summary: In this task, you will update the CSD file.

This task is required.

Before You Begin

The following information can be updated by using the sample JCL that is provided in hilevel.BBSAMP(CSOCICS):

• Define program resources
• Define transaction resources
• Create files entries for the VSAM options file (COPOPT)
• Create file entries for the VSAM print file (COPRINT)

Program resources

The program processing table (PPT) statements are contained in member CSOCICS of hilevel.BBSAMP. Below table lists the PPT entries that are required for CICS. The language for the modules is CICS Assembler.

Required PPT Entries

The remaining entries in the sample PPT could be required, depending on which optional installation tasks you have completed. (Each optional installation task contains a note if it requires an entry in the PPT.)

Below table lists the PPT entries that could be required by your site if the indicated optional activities are completed during installation.

Additional PPT Entries

Transaction resources

The Transid statements are also contained in member CSOCICS of hilevel.BBSAMP. The following Transids are available:

• COPA
• COPI
• COPM
• COPP
• COPQ
• COPR
• COPS
• COPT
• COPX

All Transids except COPA and COPM are for the Optimizer’s internal use only. If you enter any other Transids from a terminal, an error message is displayed.

Only two transactions are required to run the product:

• COPM, for the CICS transaction ID to start the Monitor
• COPS, for shutdown during CICS shutdown, or to shut down the Optimizer from the Monitor

Monitor transactions cannot be remote. You can add the remaining Transids as appropriate for your site. For more information, see Table Additional PPT Entries.

You can change the Transids to meet site standards. However, if you change one transaction, you must change all transactions. The Optimizer saves the first three characters of the Transid in the COPOPT options file the first time that the Optimizer is started. The only way you can change these Transid characters is to change the COPOPT file and restart the Optimizer.

If you change the Transids, you must perform one of the following tasks:

• Bring CICS down, and delete, redefine, and reinitialize the COPOPT file
• Shut down the Optimizer, and delete, define, and initialize the COPOPT file

Requirements for COPM Transid

Observe the following requirements for COPM Transid:

• The Transid must be three or four characters.
• The Transid cannot end in the letters A, P, Q, R, S, T, or X.

The Monitor can exploit the alternate screen size of terminals that are larger than 24 lines by 80 characters. To use this feature, define the COPM transaction as follows:

SCRNSZE=ALTERNATE

Requirements for COPS Transid

Observe the following requirements for COPS Transid:

• The Transid must end with the letter S.
• The Transid must be four characters.
• The first three characters must match the first three characters of the COPM Transid.

Optional transid definitions

The following optional transactions might be appropriate for your site:

• CICS online product authorization
• Printing and resetting statistics at intervals
• Printing at time of trace
• Starting with a sequential terminal
• Transid security

CICS online product authorization

The transaction COPA provides an interface for the MVS environment that creates product authorization JCL for processing CPU IDs and passwords. After you create the JCL, you must submit a batch job to process the product authorization codes.

The COPA transaction can be changed to any valid CICS transaction name. If you are using existing CICS transaction and program definition groups, the following entries must be added:

These definitions are supplied in the CSOCICS member of the BBSAMP library. 

At intervals option

If your site intends to use the At Intervals option to print or reset statistics, you must define the COPP, COPQ, and COPR Transids.

If you want to change the Transids, observe the following requirements:

• The first three characters must match the first three characters of the COPM Transid.
• The Transids must be four characters.
• One Transid must end in P, another Transid must end in Q, and the third Transid must end in R.

At time of trace option

If your site intends to use the At Time of Trace option to print the trace, a COPT Transid entry in the PCT is necessary. For more information, see the Using section.

To change the COPT Transid, observe the following requirements:

• The first three characters must match the first three characters of the COPM Transid.
• The Transid must be four characters.
• The Transid must end with T.

Sequential terminals

If your site intends to start the Optimizer with a sequential terminal, a COPI Transid entry in the PCT is necessary.

To change the COPI Transid, observe the following requirements:

• The first three characters must match the first three characters of the COPM Transid.
• The Transid must be four characters.
• The Transid must end with the letter I.

Transid security

If your site has a security package that provides Transid protection, and you will be using the Monitor to print screens or a trace on a printer, you might want to add a COPX Transid for printing. This PCT entry lets you have security on the first Transid, COPM.

To change the COPX Transid, observe the following requirements:

• The first three characters must match the first three characters of the COPM Transid.
• The Transid must be four characters.
• The Transid must end with the letter X.

COPOPT and COPRINT file entries

SUPEROPT has two optional file control table (FCT) entries—COPOPT (the VSAM options file) and COPRINT (the VSAM print file). You might want to create these files for your site. These files enhance certain options. The files are independent of one another, so one or both files can be used.

BMC Software recommends that you create these files for your site. If you do not define the files, changes you make in the Monitor are not saved.

To use either file, you must perform the following actions:

• Add the appropriate entries to your CSD definitions
• Allocate one or both files

COPOPT file entry

If you intend to change any of the Monitor options and want to save the changed options across CICS initializations, you must have a COPOPT file entry.

You can save Monitor options for optimization, data stream traces, and statistics. These options are described in the Using section. If the default options are satisfactory, this file entry is not necessary.

If you try to start the Optimizer when the COPOPT file is closed for any other reason, such as defining the COPOPT file as OPEN,DEFERRED, the Optimizer will not start.

To change certain options and retain the new settings the next time that CICS is initialized, create the COPOPT VSAM file. The Monitor panels display options for the following items:

• Optimization control
• Imaging and Input Suppression
• SCS printer, program tab (PT) generation, and SNA data compression
• Conventional and Imaging features
• User exits
• Dynamic terminal areas
• Storage allocation
• Data stream exclusion statistics
• Fixed and wraparound data stream tracing
• Statistics

For more information about these options, see Using section.

The DDNAME or DTFNAME of this file must be COPOPT

Read-only mode fails if the options file has not been updated at least once through CICS.

COPRINT file entry

To use a VSAM file as the destination for one of the Monitor print options, you must have a COPRINT entry in the FCT. To use separate files for the print options, duplicate the entry but provide different values for the DDNAME or DTFNAME designations. The name COPRINT is not required. You can change the print file name to suit your site if you use the same COPRINT file definition.

If you intend to use any Monitor option that routes the trace output to a VSAM file for later retrieval, or for statistics, create the COPRINT VSAM file. The Monitor panels display options for the following items:

• Fixed and wraparound data stream tracing
• Printing or resetting statistics

For more information about these options or other print options, see the Using section.

The DDNAME or DTFNAME is not restricted to COPRINT. Use a name that suits your site. Type the name that was chosen in the VSAM File ID field on the Monitor panels.

REUSE option

The REUSE option lets you use the EMPTYREQ option of the CEMT command to empty the COPRINT file after you have copied or printed the information that you have captured. For example, to close the file, type the following information:

CEMT SET FI(COPRINT) CLO EMPTYREQ

When you want to reopen the file, type the following information:

CEMT SET FI(COPRINT) OPE

The information in the COPRINT file will be removed because the high-used relative byte address (RBA) pointer is reset to zero.

MRO installations

If you use the VSAM options (COPOPT) and/or print (COPRINT) files and start the Optimizer with a PLTPI, the files must be local. If the VSAM files are remote, a U601 abend will result. This is a CICS restriction. If a PLTPI is not used, both files can be remote.

To update the CSD file

1. Select hilevel.BBSAMP(CSOCICS).

2. To customize CSOCICS, follow the instructions at the top of the CSOCICS member.

   A sample of the member for MVS environments is shown in Figure.

   Sample BBSAMP Member CSOCICS

   //STEP1 EXEC PGM=DFHCSDUP,REGION=1000K
   //STEPLIB    DD DSN=YOUR.CICS.SDFHLOAD,DISP=SHR      *** CHANGE ***
   //DFHCSD     DD DSN=YOUR.CICS.DFHCSD,DISP=SHR        *** CHANGE ***
   //SYSPRINT   DD SYSOUT=*
   //SYSIN      DD *
   DEFINE FILE(COPOPT) GROUP(BMCCSO)
              DESCRIPTION(SUPEROPT OPTIONS FILE)
              DSNAME(?BBCHILV.BMC.CSO.COPOPT)
              LSRPOOLID(1) DSNSHARING(ALLREQS)
              STRINGS(2)
              STATUS(ENABLED) OPENTIME(FIRSTREF)
              DISPOSITION(SHARE) DATABUFFERS(4)
              INDEXBUFFERS(2) TABLE(NO)
              RECORDFORMAT(V) ADD(YES) BROWSE(NO)
   DELETE(NO) READ(YES) UPDATE(YES)
              JOURNAL(NO) JNLREAD(NONE)
              JNLSYNCREAD(NO) JNLUPDATE(NO)
              JNLADD(NONE) JNLSYNCWRITE(YES)
              RECOVERY(NONE) FWDRECOVLOG(NO)
              BACKUPTYPE(STATIC)
   *
   DEFINE FILE(COPRINT) GROUP(BMCCSO)
              DESCRIPTION(SUPEROPT PRINT FILE)
              DSNAME(?BBCHILV.BMC.CSO.COPRINT)
              LSRPOOLID(1)
              DSNSHARING(ALLREQS) STRINGS(2)
              STATUS(ENABLED) OPENTIME(FIRSTREF)
              DISPOSITION(SHARE) DATABUFFERS(4)
              INDEXBUFFERS(2) TABLE(NO)
              RECORDFORMAT(V) ADD(YES)
              BROWSE(NO) DELETE(NO) READ(NO)
              UPDATE(NO) JOURNAL(NO) JNLREAD(NONE)
              JNLSYNCREAD(NO) JNLUPDATE(NO) JNLADD(NONE)
              JNLSYNCWRITE(YES) RECOVERY(NONE)
              FWDRECOVLOG(NO)
              BACKUPTYPE(STATIC)
   *
   DEFINE PROGRAM(COPHELP) GROUP(BMCCSO) LANGUAGE(ASSEMBLER) RELOAD(NO)
   DESCRIPTION(BMC SUPEROPTIMIZER)
   RESIDENT(NO) USAGE(NORMAL) USELPACOPY(NO)
   STATUS(ENABLED) CEDF(YES) DATALOCATION(ANY)
   EXECKEY(CICS)
   *
   DEFINE PROGRAM(COPINIT) GROUP(BMCCSO) LANGUAGE(ASSEMBLER) RELOAD(NO)
   DESCRIPTION(BMC SUPEROPTIMIZER)
   RESIDENT(NO) USAGE(NORMAL) USELPACOPY(NO)
   STATUS(ENABLED) CEDF(YES) DATALOCATION(ANY)
   EXECKEY(CICS)
   * 
3. Save your changes.
   
4. Submit the job.