x

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)

x

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.

x

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.

x

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.

x

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.

x

This data set contains sample Stylesheet files that are not required by FOCUS for normal execution.

x

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.

x

This data set contains all sample Maintain application procedures and is not required.