In this section: |
The installation process starts with the following three steps regardless of which environments you use:
The remaining installation steps depend on the environments you install. DBCTL Instructions, contains instructions for installing DBCTL, and XMI Server Instructions, contains instructions for installing the XMI server.
The FOCUS distribution tape contains two partitioned datasets, or libraries, that support the Interface:
The IMS.DATA PDS contains a sample Master File for the IMS DI21PART database. Before using it, you have to copy this file description, as described in Prepare the Interface Run-time Libraries, and you must create a corresponding FOCPSB.
Allocate space for these two libraries before unloading them. The following chart describes the allocation parameters and disk space requirements (in tracks) for each library:
Library |
Description |
Disk Type |
---|---|---|
3390 | ||
IMS.LOAD |
Primary Allocation (tracks) Secondary Allocation Directory Blocks(BLKSIZE=13030, RECFM=U,DSORG=PO) |
30 5 20 |
IMS.DATA |
Primary Allocation (tracks) Secondary Allocation Directory Blocks(LRECL=80, BLKSIZE=1600, RECFM=FB, DSORG=PO) |
20 5 25 |
Depending on the device used at your site, your allocations may differ from those in the table.
Note: The high-level qualifier you specify for each library should be the same as the high-level qualifier used for other FOCUS datasets at your site. The examples throughout this appendix use the identifier 'prefix' to refer to this high-level qualifier.
Use the following sample JCL to unload the contents of the tape. Add a JOB card, VOL=SER values, and UNIT values. The VOL=SER values are provided on the external tape label.
Make any changes needed to conform to your site's standards, and then submit the JCL for execution.
//UNLOAD EXEC PGM=IEBCOPY //LOADIN DD DSN=IMS.LOAD,DISP=SHR, // UNIT=unittype,VOL=SER=volid, // LABEL=(7,SL,EXPDT=98000) //DATAIN DD DSN=IMS.DATA,DISP=SHR, // UNIT=unittype,VOL=SER=volid, // LABEL=(8,SL,EXPDT=98000) //LOADOUT DD DSN=prefix.IMS.LOAD,DISP=OLD //DATAOUT DD DSN=prefix.IMS.DATA,DISP=OLD //SYSPRINT DD SYSOUT=A //SYSIN DD * COPY INDD=LOADIN,OUTDD=LOADOUT COPY INDD=DATAIN,OUTDD=DATAOUT /*
where:
Is the unit type on which a dataset resides, such as TAPE or CART.
Is the volume identifier (serial number) of a direct access volume to contain an Interface library.
Is the high-level qualifier for your site's Interface libraries.
In this section: |
At this point, you may need to create or modify seven run-time libraries. At execution time, users allocate these libraries with a CLIST, a FOCEXEC, or with batch JCL, as described in Environments.
Many sites create private and public versions of the FOCEXEC, MASTER, FOCPSB, and ACCESS libraries to make maintenance easier. For example, you can create private FOCEXEC libraries for users' personal sets of FOCEXECs and retain one general site FOCEXEC library for all users to access.
If you want private and public libraries, you can create the additional libraries now. (First check to see if private libraries already exist.) The additional libraries should have the same DCB attributes as the original libraries.
Each Interface user must have access to the libraries described in the following sections.
The MASTER library was created when FOCUS was installed. The library is allocated to ddname MASTER and its members are Master Files.
A Master File describes the segments and fields in an IMS database. Each database accessed by the Interface must be described to FOCUS in a Master File.
Before running any of the examples from this manual, copy the following member from 'prefix.IMS.DATA' to 'prefix.MASTER.DATA':
Member Name |
Description |
---|---|
DI21PART |
Describes the IMS DI21PART database. |
You must create 'prefix.FOCPSB.DATA,' the FOCPSB library; at execution time it will be allocated to ddname FOCPSB. Its members are FOCPSBs. A FOCPSB describes an IMS PSB.
The following example illustrates how to create the FOCPSB library using the IEFBR14 utility
//STEP1 EXEC PGM=IEFBR14 //FOCPSB DD DSN=prefix.FOCPSB.DATA,DISP=(NEW,CATLG), // DCB=(RECFM=FB,LRECL=80,BLKSIZE=1600), // SPACE=(TRK,(p,s,d)),VOL=SER=xxx
where:
Is the high-level qualifier for your site's FOCUS production libraries.
Is the primary space allocation.
Is the secondary space allocation.
Is the allocation for directory blocks.
Is a valid volume id for your site.
Before running any of the examples from this manual, create a member in 'prefix.FOCPSB.DATA' to correspond to the PSB for the DI21PART database. Creating FOCUS Descriptions, discusses FOCPSBs and Sample File Descriptions, illustrates a sample PSB and FOCPSB for the DI21PART Master File.
If you install the DBCTL environment (see Section D.DBCTL Instructions, DBCTL Instructions), you should create 'prefix.ACCESS.DATA,' the ACCESS library; at execution time it will be allocated to ddname ACCESS. Its members are Access Files. Access Files are optional in the IMS/DB Interface; they can be used to select the PSB for a request. Each Access File has a corresponding Master File in the MASTER libr ary.
The following example illustrates how to create the ACCESS library using the IEFBR14 utility
//STEP1 EXEC PGM=IEFBR14 //ACCESS DD DSN=prefix.ACCESS.DATA,DISP=(NEW,CATLG), // DCB=(RECFM=FB,LRECL=80,BLKSIZE=1600), // SPACE=(TRK,(p,s,d)),VOL=SER=xxx
where:
Is the high-level qualifier for your site's FOCUS production libraries.
Is the primary space allocation.
Is the secondary space allocation.
Is the allocation for directory blocks.
Is a valid volume id for your site.
The FOCEXEC library was created when FOCUS was installed. The library was allocated to ddname FOCEXEC and its members are FOCUS procedures (FOCEXECs).
The Interface load library ('prefix.IMS.LOAD') was unloaded from the distribution tape. This library contains essential Interface software, including the Interface load module, member IMSX.
There are three installation alternatives for allocating the Interface load library. At execution time, FOCUS searches for the Interface modules first in the datasets allocated to ddname USERLIB; if USERLIB is not allocated or does not contain the modules, FOCUS searches the datasets allocated to ddname STEPLIB. You can therefore do any of the following:
//STEPLIB DD DSN=prefix.FOCLIB.LOAD,DISP=SHR // DD DSN=prefix.IMS.LOAD,DISP=SHR
COPY 'prefix.IMS.LOAD(*)' 'prefix.FOCLIB.LOAD(*)' NONUM //STEPLIB DD DSN=prefix.FOCLIB.LOAD,DISP=SHR
//STEPLIB DD DSN=prefix.FOCLIB.LOAD,DISP=SHR //USERLIB DD DSN=prefix.IMS.LOAD,DISP=SHR
All options are valid for both TSO and batch access. However, under TSO, ddname STEPLIB cannot be allocated dynamically with the ALLOCATE command; therefore, if it is to be used, it must be allocated in the logon procedure. All three options produce equivalent execution time overhead, but USERLIB requires 26K bytes of extra storage for I/O buffers.
The ERRORS library ('prefix.ERRORS.DATA') was created when FOCUS was installed. It contains the text of the FOCUS error messages. Member FOCIMS of 'prefix.IMS.DATA' contains the text of all the error messages generated by the IMS/DB Interface. You must copy this member to the ERRORS library:
COPY 'prefix.IMS.DATA(FOCIMS)' 'prefix.ERRORS.DATA(FOCIMS)' NONUM
At execution time, allocate the receiving dataset as ddname ERRORS:
ALLOCATE F(ERRORS) DA('prefix.ERRORS.DATA') SHR REUSE
The file of messages is delivered without line numbers; this feature is preserved through the NONUM option of the TSO COPY command.
Information Builders |