Changing the FOCUS Defaults

In this section:

You can customize many of the default FOCUS space allocations, command lists and naming conventions while doing your install. Customizable items include:

Record Buffer Size

The default buffer size has been made unlimited. This is the required size for both the LINREC and DATREC buffers and may no longer be changed.

Setting the Maximum Number of Cache Pages

How to:

FOCUS sites can limit the maximum number of cache pages allowed per FOCUS session. Check your IBM documentation for cache requirements. During installation, you can set a cache page limit of between 3 and 524,288 pages (the hardware maximum), with each page 4096 bytes in length. The FOCUS default is 0 pages. The HiperFOCUS default is 256.

Individual users or batch jobs can reset cache page limits to one less than the site-selected maximums by using the SET CACHE command.

Syntax: How to Set the Cache Page Limit

SET CACHE = {0|n}

where:

0

The default FOCUS setting allocates no space for cache. Cache is inactive.

n

Is the number of 4K-byte pages of contiguous storage allocated to cache memory. The minimum is two pages. The maximum value is either 524287, or one less than the site-specified maximum value.

In normal use, the number of pages requested by users should be far less than the hardware maximum to avoid degrading the performance of the paging subsystem.

Configuring Default Space Allocations for Work Files: IBITABLA

FOCUS dynamically allocates output data sets not allocated by the user. To change the default space attributes for these dynamically allocated ddnames, edit member IBITABLA of the install_hlq.F.HOME.DATA physical library.

To change the FOCUS default allocations for output data sets, you must copy file IBITABLA to the install_hlq.HOME.ERR physical library that will be allocated to ddname ERRNLS. IBITABLA is a fixed columnar file and you must make all changes in the appropriate columns, which are as follows:

Column Name

Starting Column

Length

DDname

01

8

Allocation units (CYLS,TRKS)

10

4

Primary space

15

3

Secondary space

19

3

Number of Directory entries (PDS)

23

2

Sysout class (OFFLINE only)

26

1

Volume

28

6

Unit (SYSDA, DASD, HIPER, NOHIPER*)

35

8

Unit Count (multi-volume)

44

2

*Use NOHIPER as a unit name to exclude particular data sets from HiperFOCUS.

Example: Sample of Distributed IBITABLA

IBITABLA defines the default allocations for all dynamically allocated Information Builders files. It is provided to allow each customer to tailor these defaults as required, thereby creating a local copy of IBITABLA.

*...+....1....+....2....+....3....+....4....+
HOLD     CYLS   5  10                       3,
HOLDMAST TRKS   5   5 36          NOHIPER    ,
SAVE     CYLS   5  10                       3,
REBUILD  CYLS   5  10                       3,
FOCSML   CYLS   5   5                       2,
FOCUS    CYLS   5   5                       1,
FOCSTACK TRKS   5   5                       2,
FOCSORT  CYLS   5   5                       1,
OFFLINE  CYLS            A                   ,
SESSION  TRKS   5   5                       2,
FOCCOMP  TRKS   5   5 12                     ,
HOLDACC  TRKS   5   5 12                     ,
FMU      TRKS   5   5 12                     ,
TRF      TRKS   5   5 12                     ,
FOCPOOLT CYLS   5  20             NOHIPER   4,
FUSION   CYLS   5  50             NOHIPER   4,
MDI      CYLS   5  20             NOHIPER   4,
FOC$HOLD CYLS   5   5                       2,
EXTINDEX CYLS   5   5                       2,

Adjusting the Number of Allowable Data Exceptions

How to:

FOCUS allows ten data exception interrupts before terminating a run with the following error message:

(FOC204) TOO MANY INTERRUPTS. RUN TERMINATED.

You can change this limit with the SET MAXDATAEXCPT command.

Syntax: How to Set a Maximum Number of Data Exceptions in a Session or Request

Issue the following command in any supported profile, in a FOCEXEC, or at the FOCUS prompt:

SET MAXDATAEXCPT={10|n}

Issue the following command in a TABLE request

ON TABLE SET MAXDATAEXCPT {10|n}

where:

n

Is a one to four-digit number that represents how many data exceptions can occur before the session is terminated. 10 is the default value. The value zero (0) allows an unlimited number of data exceptions. The value one (1) terminates the session at the first data exception.

If MAXDATAEXCPT is changed in a request, a new count is established for the request. The session counter is saved and is restored after the request executes.

Each time you issue the command outside of a TABLE request, the running counter is reset to zero.

This command is not supported on a FOCUS Database Server (sink machine).


Information Builders