Transcript
DATAMINER FOR Z/OS 7.1C Installation Guide
Overview
This document explains how to install DATAMINER FOR Z/OS. The DATAMINER product family consists of four components: • DATAMINER Batch—batch data manipulation and report writer • DATAMINER/Online—an online (CICS) VSAM editing system • DATAMINER/VE—a general purpose VSAM API • DATAMINER/ISPF Editor—ISPF dataset browsing and editing system DATAMINER Batch is the basic component that all sites use. The Online component is included in the basic installation. Batch sites can install the optional DATAMINER/VE and DATAMINER/ISPF Editor components as needed. The DATAMINER installation procedure consists of up to seven tasks, depending on the components you want to install. These tasks are summarized in the following table. Task
Summary
1
Obtain a DATAMINER product key, and download the DATAMINER installation ZIP file.
2
Extract, select, and transfer installation datasets to your mainframe.
3
Load the installation datasets into PDSs.
4
For ISPF only: Place ISPF PDSs into the correct concatenation on your system.
5
For CICS only: Install load modules into your CICS system.
6
For DB2 only: Bind the Database Request Module (DBRM).
7
All sites: Install the DATAMINER product key.
Copyright © 2012 by CSI International 1
DATAMINER FOR Z/OS 7.1C Installation Guide
Task 1—Obtain Product Key and Download Distribution Files
DATAMINER software is distributed by download from the CSI website as a single ZIP archive. Use the following steps. 1. Contact a CSI account representative at 800-795-4914 or
[email protected] to obtain an account number and a product key. You will install the product key after you install the software. 2. Using your CSI account number, download the DATAMINER ZIP file from the following website to your PC: http://www.csi-international.com/products/zOS/DataMiner/DataMiner.htm The ZIP file contains all the files needed for the four DATAMINER components. There are six sequential datasets in the ZIP. These datasets are described in the next task. End of Task 1.
Copyright © 2012 by CSI International 2
DATAMINER FOR Z/OS 7.1C Installation Guide
Task 2—Transfer PC Files to Your Mainframe
Transfer (FTP) extracted files on your PC to temporary sequential datasets on your mainframe. Use the following steps. 1. Unzip the installation archive to extract the files on your PC. 2. Determine which of the following six datasets you need to install. Dataset 1: DATAMINER Load Library
Required for all installations PC File:
DM71C.LOAD
Contents:
All the load modules
Size:
361K
Dataset 2: DATAMINER Source Library
Required for all installations PC File:
DM71C.SOURCE
Contents:
Members to install the product key, a sample DB2 bind job, and DataMiner batch examples
Size:
29K
Dataset 3: DATAMINER DBRM Library Optional—adds DB2 access to DATAMINER Batch component PC File: DM71C.DBRM Contents: The DB2 request module Size: 10K Dataset 4: DATAMINER Object Library
Optional—adds DATAMINER/VE component PC File:
DM71C.OBJ
Content:
The VNATB object module
Size:
4K
Dataset 5: DATAMINER Panel Library
Optional—install with dataset 6 to add DataMiner/ISPF editor PC File:
DM71C.PANEL
Content:
The ISPF panels for DataMiner ISPF interface
Size:
54K
Dataset 6: DATAMINER Message Library
Optional—install with dataset 5 to add DataMiner/ISPF editor PC File:
DM71C.MESSAGEL
Content:
The ISPF error messages for DataMiner ISPF interface
Size:
2K
Copyright © 2012 by CSI International 3
DATAMINER FOR Z/OS 7.1C Installation Guide
3. For each dataset you need, choose a sequential mainframe dataset (transfer dataset) you can use to temporarily store the corresponding PC file (page 3). You can use any name for a transfer dataset. If you manually allocate a dataset, make sure it is defined with a record format of FB and record length of 80. Add the name of a each transfer dataset you will use to the Dataset Worksheet below. The worksheet has spaces for all six datasets. (You will add the PDS names in the next task.) Dataset Worksheet Dataset 1: DATAMINER Load Library
Transfer Dataset: ___________________________________ PDS Name:
___________________________________
Format:
PDS, RECFM=U, LRECL=0 (unspecified) BLKSIZE=16000 (or larger)
3390 Allocation: CYL(2,1) and 5 directory blocks Dataset 2: DATAMINER Source Library
Transfer Dataset: ___________________________________ PDS Name:
___________________________________
Format:
PDS, RECFM=FB, LRECL=80, BLKSIZE=3200 (or larger)
3390 Allocation: TRK(2,1) and 5 directory blocks Dataset 3: DATAMINER DBRM Library
Transfer Dataset: ___________________________________ PDS Name:
___________________________________
Format:
PDS, RECFM=FB, LRECL=80, BLKSIZE=3200 (or larger)
3390 Allocation: TRK(1,1) and 1 directory block Dataset 4: DATAMINER Object Library
Transfer Dataset: ___________________________________ PDS Name:
___________________________________
Format:
PDS, RECFM=FB, LRECL=80, BLKSIZE=3200 (or larger)
3390 Allocation: TRK(1,1) and 1 directory block
Copyright © 2012 by CSI International 4
DATAMINER FOR Z/OS 7.1C Installation Guide
Dataset Worksheet Dataset 5: DATAMINER Panel Library
Transfer Dataset: ___________________________________ PDS Name:
___________________________________
Format:
PDS, RECFM=FB, LRECL=80, BLKSIZE=3200 (or larger)
3390 Allocation: TRK(2,1) and 5 directory blocks Dataset 6: DATAMINER Message Library
Transfer Dataset: ___________________________________ PDS Name:
___________________________________
Format:
PDS, RECFM=FB, LRECL=80, BLKSIZE=3200 (or larger)
3390 Allocation: TRK(1,1) and 1 directory block 4. Use a TN3270 emulator to transfer the PC files for the datasets you need. If necessary, exit ISPF so that your TSO session is at the TSO ready prompt. Next use the file transfer screen on the emulator. The fields you need to set are listed in the table below. The field names are generic; different transfer products may label them differently. Field
Explanation
Host filename
The name of a transfer dataset you listed in the Dataset Worksheet.
PC filename
The name of the corresponding PC file to transfer (for example, DM71C.LOAD). See the list on page 3.
Host
The target mainframe’s operating system. Select TSO.
Data or Translation
You must disable translation. In other words, you must specify all of the following: • Binary (not ASCII) • No CRLF (do not add CR or LF to lines) • No TRUNC (do not truncate lines)
Transfer Options
The following values are known to work: FB (fixed block), LRECL=80, BLKSIZE=3120
End of Task 2.
Copyright © 2012 by CSI International 5
DATAMINER FOR Z/OS 7.1C Installation Guide
Task 3—Copy the Transfer Datasets into PDSs
Load each transfer dataset on your mainframe into its respective PDS. Use the following steps. 1. Choose a PDS name for each transfer dataset, and add each name to the Dataset Worksheet (page 4). 2. Allocate each PDS, using the information in the Dataset Worksheet. 3. From the ISPF primary menu, go into Option 6 (Command). 4. Type a RECEIVE command. Use the following line as an example: RECEIVE INDSN('DATAMINE.INSTALL.LOAD') where DATAMINE.INSTALL.LOAD is the name of a transfer dataset. 5. Press
. ISPF asks you to enter any RESTORE parameters. 6. Enter the RESTORE parameters. Type the following command to specify the PDS to which you want to RESTORE the dataset: DSNAME('my.datamine.loadlib') where my.datamine.loadlib is the PDS name you chose for the dataset. Press . Note: The transfer dataset is no longer needed.
7. Repeat from step 4 to RECEIVE and RESTORE the other PDSs you listed in the Dataset Worksheet. For example, if you plan on using only the DATAMINER batch component and DB2 access is planned, you would receive/restore the load library (dataset 1), the source library (dataset 2), and the DBRM library (dataset 3). End of Task 3.
Copyright © 2012 by CSI International 6
DATAMINER FOR Z/OS 7.1C Installation Guide
Task 4—Finish Installation for ISPF
Perform this task only if you have installed the ISPF editor. Before you can use the ISPF component, there are three more things you must do and one more thing that is recommended. 1. Do one of the following: • Ensure that the DATAMINER load library (dataset 1) is in the concatenation for ISPLLIB in your ISPF PROC, or • Ensure that the load modules CSIDMTSO, VNATB, and VNATB2 are in a load library that is in the ISPLLIB concatenation. 2. Do one of the following: • Ensure that the PDS into which you put the ISPF panels (dataset 5) is in the concatenation for ISPPLIB, or • Copy the DATAMINER panels (dataset 5) into a dataset that is in your ISPPLIB concatenation. 3. Do one of the following: • Ensure that the DATAMINER messages PDS (dataset 6) is in the ISPMLIB concatenation, or • Copy the member from the DATAMINER messages library into a dataset that is in your ISPMLIB concatenation. 4. (Optional) To make using DATAMINER more convenient, use the PGM keyword to add DATAMINER to the ISPF primary menu. For example, DM,'PGM(CSIDMTSO)' End of Task 4.
Task 5—Finish Installation for CICS
Perform this task only if you plan to use the online VSAM editor. After you restore the load modules to a load library, use CEDA to install the modules in your CICS system. You can move the modules to a load library that is in the load-library concatenation if you want; the only two load modules needed for CICS are CSIDMOMD and VNAT. Note: VNAT must be installed to run with EXECKEY=CICS.
Both programs (CSIDMOMD and VNAT) are written in assembler and can be put into any group you want. You can also use any transaction ID; the default is MINE. Neither program needs a TWA. End of Task 5.
Copyright © 2012 by CSI International 7
DATAMINER FOR Z/OS 7.1C Installation Guide
Task 6—Finish Installation for DB2
Perform this task only if you have installed the DB2 access component. After you have restored the Database Request Module (CSIDMBSQ—dataset 3) to a PDS, bind the DBRM. A sample bind job is in the DATAMINER source PDS member DB2BIND. End of Task 6.
Task 7—Install the Product Key
You must install a product key for DATAMINER to run. Assemble and link the PRODKEY macro as described in the document “CSI Product Keys in z/OS,” available at CSI’s website (http://www.csi-international.com/):
http://www.csi-international.com/authcodes/Product%20Keys%20in%20zOS.pdf End of Task 7.
Copyright © 2012 by CSI International 8
