In this section: |
The components described in this installation manual are distributed in nine partitioned data sets:
FOCLIB.LOAD |
The FOCUS load library. |
FUSELIB.LOAD |
Load library of user-written routines. |
FUSELIB.DATA |
The FUSELIB maintenance library. |
ERRORS.DATA |
Text of FOCUS error messages. |
FOCCTL.DATA |
The FOCUS maintenance library. |
FOCSTYLE.DATA |
Library of sample Stylesheet files. |
MASTER.DATA |
Library of sample file descriptions. |
FOCEXEC.DATA |
Library of sample FOCUS procedures. |
WINFORMS.DATA |
Library sample MAINTAIN procedures. |
In order to use the intelligent partitioning feature with 2-gigabyte FOCUS databases, users must first create an ACCESS.DATA PDS. This PDS has the same characteristics as the MASTER.DATA PDS. For detailed instructions, see the Describing Data manual.
If your site has licensed the zIIP enablement feature, you can offload processing to a zIIP engine by issuing the command SET ZIIP=ON. To enable this feature for all users, you can issue this command in a global profile such as FOCPARM. Note: All load libraries invoked on the zIIP processor must be APF authorized. If any load module in your STEPLIB allocation is not authorized, FOCUS will set ZIIP=OFF and start in an unauthorized state. The job will then run on the Central Processor. For more information about offloading FOCUS processing to a zIIP engine, see the z/OS Guide to Operations chapter in the Overview and Operating Environments manual.
Only the FOCLIB.LOAD and the ERRORS.DATA libraries are actually required for execution. FUSELIB.LOAD is optional. Library space requirements and DCB attributes are provided in Basic Installation Steps.
The FOCLIB.LOAD library contains all load modules needed to execute the basic FOCUS system. It contains both the re-entrant and the non-re-entrant modules, and the main load module, named FOCUS. All modules are delivered fully resolved and ready for execution.
Some of these modules have aliases, and it is critical that all names and aliases be retained if you move them from one load library to another. Aliases all have the same entry point as the member names of the corresponding modules. Should you lose an alias during a copy or a move operation, you can always reassign it with the linkage editor. Sample JCL for this follows:
//LINK EXEC PGM=IEWL,PARM='NCAL,LIST,LET,RENT,SIZE=1024K' //SYSLMOD DD DISP=SHR,DSN=prefix.FOCLIB.LOAD //MAINTAIN DD DISP=SHR,DSN=prefix.FOCCTL.DATA //SYSUT1 DD UNIT=SYSDA,SPACE=(CYL,(5,5)) //SYSPRINT DD SYSOUT=* //SYSLIN DD * INCLUDE SYSLMOD(QVSAMX) < Re-entrant module INCLUDE MAINTAIN(QVSAMX) < Cntl for QVSAMX will assign alias QFOCSAM NAME QVSAMX(R)
The optional FUSELIB.LOAD library contains a number of small load modules that implement user-written functions that can be invoked from FOCUS computational expressions. These functions, contributed by users, expand the basic FOCUS computational facilities. We recommend making this library available to all FOCUS users. The FUSELIB.LOAD library functions are documented in the Using Functions manual.
The FUSELIB.DATA library members contain the linkage editor control statements for the FUSELIB subroutines.
This library is only required when applying FOCUS maintenance to the user-written subroutines.
The ERRORS.DATA library contains the text of all error messages generated by the basic FOCUS system. This library is required. If the ERRORS PDS is not allocated, the following error is displayed:
ERROR READING FOCPARM INSTALL FILE
Several members of this library correspond to major FOCUS functional areas, and additional members are created when you install data adapters, such as the IMS/DB Data Adapter. An ERRORS.DATA library must be allocated to ddname ERRORS whenever FOCUS is started or FOCUS is terminated.
Members of this partitioned data set are not numbered sequentially and if you copy a member or members from one PDS to another, make sure you specify NONUM. Do not add or delete records from the error-messages files—FOCUS error messages are accessed by relative record number, not by the error numbers displayed.
The FOCCTL.DATA data set is called the maintenance library because, among other things, it contains the linkage editor control statements needed to maintain the load modules in FOCLIB.LOAD. It also contains other components you can install using this manual that are not part of the basic FOCUS system, as well as examples of batch JCL and TSO CLISTs. FOCCTL.DATA is thus an essential data set even though not actually needed to execute FOCUS. It contains the linkage editor control statements for each member of FOCLIB.LOAD, under the same membername.
Note: Each version of the FOCCTL.DATA data set differs significantly from prior versions, and the maintenance library of one release cannot be used to modify the load library of another.
The load modules in FOCLIB.LOAD and their linkage editor control statements in FOCCTL.DATA are associated by a common member name. For example, the ORDER statements for the re-entrant module CORFOC are contained in member CORFOC of FOCCTL.DATA. The linkage editor control statements always specify entry-point names that are not necessarily the same as the load module member names.
This data set contains sample Stylesheet files that are not required by FOCUS for normal execution.
These two data sets contain file descriptions (MASTER) and procedures (FOCEXEC) used to test FOCUS after it is installed, and the FOCUS TOOLKIT and FOCUS MENU components, which are not required by FOCUS for normal execution.
This data set contains all sample Maintain application procedures and is not required.
Information Builders |