In this section: How to: |
This section describes installation of HiperFOCUS. It also discusses the new HiperBUDGET facility of HiperFOCUS.
HiperFOCUS is installed and customized using SET commands in the FOCPARM member of ERRORS.DATA. You can install HiperFOCUS by simply adding SET HIPERINSTALL=ON to the FOCPARM entries and accepting the defaults. However, since this would not establish limits on the number of hiperspaces that FOCUS could create, it is strongly recommended that you establish operating limits via the SET parameters that follow and those in the following section on the IBI Subsystem. Together, the SET commands establish the working parameters of the HiperBUDGET facility of HiperFOCUS.
All SET options (except for SET HIPERFOCUS) can be issued only from the FOCPARM member of the ERRORS file. Issuing these commands from a FOCUS session produces a FOC964 error.
SET HIPERINSTALL={ON|OFF}
where:
Installs HiperFOCUS.
Disables HiperFOCUS.
SET HIPERSPACE=nnn
where:
Is the number of (4K) pages to aggregate for hiperspace. There is no default limit. (Equivalent to SET TCBLIM under the IBI Subsystem—if both parameters establish different limits, FOCUS enforces the lower.)
SET HIPERFILE=nnn
where:
Is the maximum number of (4K) pages in an individual hiperspace. The default size is 524288 (4K) pages or 2 GB. (Equivalent to SET FILELIM under the IBI Subsystem—if both parameters establish different limits, FOCUS will enforce the lower.)
SET HIPERCACHE=nnn
where:
Is the number of (4K) pages in HIPERCACHE. The default size is 256 (4K) pages or 1M.
SET HIPEREXTENTS=nnn
where:
Is the permissible number of extents. The default is 127.
SET HIPERLOCKED={ON|OFF}
where:
Disallows processing of user interface commands.
Allows processing of user interface commands (such as SET HIPERFOCUS). OFF is the default.
SET HIPERFOCUS={ON|OFF}
where:
Activates a HiperFOCUS session when HiperFOCUS is installed. ON is the default.
Deactivates a HiperFOCUS session.
How to: |
The IBI Subsystem provides communication between address spaces running Information Builders products on the same z/OS system. HiperBUDGET uses the subsystem to regulate and report on the overall use of hiperspace on that system. It accomplishes this by enforcing pre-defined limits on hiperspace consumption set at the system, server, user and file levels. Limits set at lower levels may never exceed those set at higher levels.
You must set these values by either using the console or running job SUBSYSIH, which is described in Subsystem Sample JCL and Zaps.
SET MVSLIM = {nnn|-1}
where:
Is the maximum number of 4k hiperspace pages for all Information Builders products on the operating system.
Specifies no hiperspace limit checking for the operating system.
SET SERVLIM = {nnn|-1}
where:.
Is the maximum number of 4k hiperspace pages allowed for multiple users on a per server basis.
Specifies no limit/per server checking.
SET TCBLIM = {nnn|-1}
where:
Is the maximum number of 4K hiperspace pages/per user.
Specifies no limit/per user checking.
TCBLIM is equivalent the SET HIPERSPACE parameter described in the HiperFOCUS installation section. If both parameters are specified, the smaller value takes precedence. To set this value in FOCPARM, you must use the parameter name HIPERSPACE.
SET FILELIM = {nnn|-1}
where:
Is the maximum number of 4K hiperspace pages per individual file.
Specifies no limit/per file checking.
FILELIM is equivalent to the SET HIPERFILE parameter described in the IBI Subsystem Installation. If both parameters are specified, the smaller value takes precedence. To set this value in FOCPARM, you must use the parameter name HIPERFILE.
? HBUDGET
The ? HBUDGET query shows the Hiperspace limits specified and actual utilization statistics, including: limits set at the system, server, user and file levels; the number of busy pages; the number of hiperextents allowed; and the ddnames and sizes of files allocated in hiperspace or spilled to disk.
>? HBUDGET Total system limit is not set Total server limit is not set Total hiperspace limit is not set Single file size limit is 524288 pages Total amount of busy pages is 616 pages Number of extents is set to 127 DDname :Reserved :Hiperspace : Spilled :Spill DDn
| Information Builders |