Optimizer startup

This section provides instructions for starting the Optimizer and using COPBPRINT to print screen data that is routed to a VSAM file.

Overview of optimizer startup

When you have completed the installation and customization, you can start the Optimizer. Use any procedures that are explained in this section. Before you start the Optimizer, check the items in following table:

Optimizer Options Checklist

X	Task	Action
	You want to change the default options	Perform one of the following actions: Use the batch Set Options program COPBSET (supplied by BMC Software), if you have a COPOPT file. Access the Monitor without starting the Optimizer. Set the options, then start the Optimizer.
	You want to retain the option changes you have made from the Monitor	Ensure that you have a COPOPT options file defined. If the COPOPT file has not been created, or is not available, any changes that you make to the Monitor are not retained after the Optimizer is shut down. To create a COPOPT file, see Installation Customization.
	The Erase Input key is used in your data center	Input Suppression might not work properly. Using the Erase Input key could adversely affect your screens and the database that contains the information that is updated by these screens.
	Your site uses SCS printers, and they accept the horizontal tab control code	Ensure that Horizontal Tabs are turned on (default).

Erase input key

Note:

This key may be labeled ErInp, Erase Input, or something similar, depending on the type of terminal keyboard used. Do not confuse the Erase Input key with the Erase EOF key.

If the Erase Input key is used, you can use options 1.2.1, 1.2.2, and 1.2.3 on the Monitor panels to perform the following tasks:

Exclude or include the necessary transactions from Input Suppression
Exclude or include Termids from Input Suppression
Turn off Input Suppression
Set Erase Input Key Allowed optimization to Yes

This setting decreases inbound data stream optimization, but lets you use the Erase Input key.

Exclude/include the necessary transactions from Erase Input Key Allowed optimization.
Exclude/include Termids from Erase Input Key Allowed optimization.

The Erase Input key clears all unprotected fields to nulls and sets the corresponding modified data tag (MDT) bits off.

The Erase EOF key clears all characters in one unprotected field to nulls (from the location of the cursor to the end of the field) and sets the corresponding MDT bits on. This key may be labeled Erase EOF or something similar. The Erase EOF key can be used with Input Suppression.

Horizontal tabs

If your site uses SCS printers, determine whether these printers support the horizontal formatting control codes. To help you determine whether horizontal tabbing is supported, review the following guidelines:

Most IBM 3287 printers with a serial number that begins with the number 5 (or lower) do not support horizontal tabs.
If your IBM 3287 printer has the Change Space Feature, it does not support tabbing. The Change Space Feature is indicated in the test pattern by a X'80' bit at Offset 52.
Some non-IBM printers have a problem when the horizontal tab data is split across request/response units (RUs). Most printers have corrected the problem.
Most PC ASCII printers do not support tabbing.

If horizontal tabs are not supported, exclude SCS printers from horizontal tabs by using option 1.3.2 to perform the following tasks:

Turn off Horizontal Tabs
Exclude or include a specific or generic Termid
Exclude or include a list of SCS printer Termids by creating a table

Start methods

Table lists methods for starting SUPEROPT.

Methods to Start the Optimizer

Method	Action	Notes
Use the CICS startup program list table (PLTPI)	Modify the CICS PLTPI to support this method. Add an Optimizer entry to your PLTPI as explained in Installation Customization.	BMC Software recommends this method for starting the Optimizer
Use a defined sequential terminal data set	Perform one of the following actions: Add the Transid that you specified in your PCT for COPINIT to an existing sequential terminal data set Create a new sequential input terminal data set.
Enter COPM or your Transid	When you access the Monitor for the first time, it displays the Monitor Initialization Options panel.	This method lets you set or reset options before starting the Optimizer. See Using. After the Monitor panels have been viewed, the Initialization Options panel will not display again unless the Optimizer has been shut down.

Sample sequential terminal entries

The following figure contains sample entries for defining a sequential terminal to start the Optimizer in an MVS environment. These parameters are contained in hilevel.BBSAMP(COPSEQ).

Sample MVS Entries to Create a Sequential Terminal for CICS

DFHSG PROGRAM=TCP,               *00010000
   ACCMETH=(...,SAM),             *00020000
   DEVICE=(DASD),                 *00030000
...                               00040000
DFHTCT TYPE=INITIAL,SUFFIX=SQ,   *00050000
   APPLID=CICS,                   *00060000
   ERRATT=(LASTLINE,INTENSIFY),   *00070000
   RAMAX=1100,                    *00080000
   RAPOOL=10,                     *00090000
   ACCMETH=(VTAM,NONVTAM)          00100000
DFHTCT TYPE=SDSCI,               *00110000
   DSCNAME=SEQIN,                 *00120000
   MACRF=R, (OS ONLY)             *00130000
   DEVADDR=SYS100, (DOS ONLY)     *00140000
   DEVICE=DASD                     00150000
DFHTCT TYPE=SDSCI,               *00160000
   DSCNAME=SEQOUT,                *00170000
   MACRF=W, (OS ONLY)             *00180000
   DEVADDR=SYS100, (DOS ONLY)     *00190000
   DEVICE=DASD                     00200000
DFHTCT TYPE=LINE,                *00210000
   ACCMETH=SAM,                   *00220000
   ERRATT=NO,                     *00230000
   INAREAL=80,                    *00240000
   TRMTYPE=DASD,                  *00250000
  class="CONV",                  *00260000
   ISADSCN=SEQIN,                 *00270000
   OSADSCN=SEQOUT                  00280000
DFHTCT TYPE=TERMINAL,            *00290000
   TIOAL=80,                      *00300000
   TRMIDNT=SEQT,                  *00310000
   TRMSTAT=TRANSCEIVE,            *00320000
   LASTTRM=LINE                    00330000
...                               00340000

Optimizer status when the COPOPT file exists

If the COPOPT file exists, and it is open and enabled, one of the following events occurs:

If the Optimizer was stopped before the last CICS shutdown, optimization remains inactive until you start it from the Primary Menu.
If the Optimizer was active before the last CICS shutdown, the Optimizer will be started.

Start failures

The Optimizer will not start if you added an entry in the file control table (FCT) for COPOPT, and one of the following conditions exists:

The VSAM COPOPT file is disabled. (For example, verification has not been performed.)
The VSAM COPOPT file is defined but did not have an initialization record written to it.
The VSAM COPOPT file is closed. (For example, the DD or DLBL statement for the COPOPT file is missing from the CICS JCL.)

You can start the Optimizer without the COPOPT file. If the COPOPT file is not available, any options that have been set for your site will not be available. The Optimizer does not assume that you want to use the default data stream optimization options. Rather than optimize data streams according to the defaults, SUPEROPT does not activate data stream optimization.

Note:

If you start the Optimizer without the COPOPT file, the default options are used. Changes that you make to the defaults are not saved when you shut down the Optimizer.

If the Optimizer does not start, and you did not define the COPOPT options file, check the CSSL log for messages. The Message Library contains explanations and user responses for these messages. Take appropriate action as indicated.

If you still cannot start the Optimizer, contact BMC Software Customer Support.

This section contains the following topic: