Task 4—Executing the batch set options program


Summary: In this task, you will execute the batch Set Options (COPBSET) program.

This task is optional. Usually, it is not necessary to run COPBSET unless you want to preset Optimizer options before the Optimizer is started. You can also run this batch program when you do not want to set options through the Monitor.

Before You Begin

The batch Set Options program COPBSET changes options in the COPOPT options file, according to the parameters that are specified in your batch JCL. Some of these options can also be set through the Monitor, while other options are available only through execution of COPBSET.

Some options can be set in batch only. Most of these options should be set under the direction of BMC Customer Support only.

Warning

Note:

The Optimizer must be shut down when the batch Set Options program is executed.

Below table lists options that can be changed on the Monitor panels:

Monitor Panel Options That Can Be Changed

Panel

Option Controlled Through the Monitor

Initialization Options

Change

  • CICS Termid (default)
  • VTAM Netname

Option 1.1.1

Turn on or turn off Global Optimization Control

  • CRTs
  • Printers

Options 1.2.1 and 1.2.2

Turn on or turn off

  • Imaging for CRTs
  • Imaging for printers
  • Input Suppression
  • Erase Input Key Allowed

Option 1.3.1

Turn on or turn off SCS Printer Optimization

Options 1.6.1 and 1.6.2

Change

  • Allocation size for Imaging and SCS storage
  • Data stream storage size for work area storage
  • 3270 buffer storage size for work area storage

Option 1.6.3

Change

  • Reuse storage for Dynamic Terminal Areas
  • Number allocated for Dynamic Terminal Areas and Transid Statistic Areas

The option to display text on the Monitor panels in uppercase characters or mixed-case characters is not available from the Monitor panels.

DISPLAY UPPER/LOWER is the default option.

For example, if DISPLAY UPPERCASE is specified, the words SCS Horizontal Tabs are displayed as SCS HORIZONTAL TABS. This option does not apply to the F6=Case function key. This key affects the data that a terminal operator enters.

Guidelines for using the batch set options program

Adapt the control statements in Table Control Statements for COPBSET to your site. Observe the following guidelines:

  • If you have specified a password through the Monitor, include the PASSWORD control statement, followed by your password. You must provide this entry to set the options only if you have an existing COPOPT options file. The PASSWORD control statement does not create a password for the Monitor.
  • To use the default options, specify only DEFAULT OPTIONS. The DEFAULT OPTIONS control statement overrides all other options.
  • IMAGING STORAGE can be 0 to 2097144 for MVS/ESA, OS/390, and z/OS environments.

Set options program control statements

Below tables lists the control statement syntax for the COPBSET Set Options program. The default setting for the option is underlined.

Control Statements for COPBSET

Control Statements

Notes

PASSWORD=xxxxxxxx

Include this statement only if you have previously set a password for the Monitor. This statement does not create a password; it only verifies that you are authorized to change the COPOPT file.

DEFAULT OPTIONS

This control statement overrides all other options.

OPTIMIZER (ON|OFF) CRTS
OPTIMIZER (ON|OFF) PRTS
IMAGING (ON|OFF) CRTS
IMAGING (ON|OFF) PRTS
INPUT (ON|OFF)
ERASE INPUT (NO|YES)
SCS (ON|OFF)
NETNAME (OFF|ON)
REUSE (NO|YES)
IMAGING STORAGE=xxxxxxx
DATA STREAM STORAGE=xxx
3270 BUFFER=xx
DYNAMIC TERMINALS=xxxxx 

These options can also be set through the Monitor panels.

DISPLAY (UPPER/LOWER|UPPERCASE)

This option can be changed in batch only.

IMAGING SO/SI (ON|OFF)
SCS LOCAL-COPY (OFF|ON)
SCS MIX SHFNL (OFF|ON)
(KEEP|DISCARD) USER SCS SHF
VIRTUAL SNA (OFF|ON)
ENHANCE READB (OFF|ON)
BUFFER WRAP (ON|OFF)
TRACE SUPPORT (ON|OFF)
SCS NULLS (VALID|INVALID)
(GENERATE MF ORDER|GENERATE NO MF ORDER)
TRANSIENT DATA ID=

These options are available only under the direction of BMC Customer Support.

To execute the COPBSET program

Warning

Note:

To execute the batch Set Options program, the Monitor must be shut down.

  1. Select hilevel.BBSAMP(COPBSET).
  2. Adapt the JCL for your site.

    Figure provides sample JCL to execute the Set Options program. To set the options, use the information in Table Control Statements for COPBSET as the SYSIN input.

    Sample JCL to Execute COPBSET Batch Set Options Program

    //CSOBSET JOB (ACCOUNT),NAME
    //BSET EXEC PGM=COPBSET
    //STEPLIB  DD DSN=BMC.CSO.LOAD,DISP=SHR
    //COPOPT   DD DSN=BMC.CSO.COPOPT,DISP=SHR COPOPT VSAM FILE
    //SYSPRINT DD SYSOUT=*
    //SYSUDUMP DD SYSOUT=*
    //SYSIN    DD *
    PASSWORD=ABCDEFGH
    IMAGING OFF CRTS
    SCS OFF
    /*
  3. Submit the job.




 

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

3270 SUPEROPTIMIZER/CICS 3.0.06