Before You Begin Installing Jopaz
You must do the following prerequisite steps before you begin your Jopaz installation.
1. Create an empty z/OS dataset with following attributes:
DSN=SAG.JPZvrs.XMIT
DSORG=PS
DCB=(RECFM=FB,LRECL=80,BLKSIZE=3120)
SPACE=(CYL,(5,5))
2. Using an FTP connection in binary mode, copy the XMIT file with the same DSN as the previously created dataset and paste it on your mainframe machine.
A prompt appears asking you if the existing dataset should be overwritten.
3. Confirm the prompt.
4. Copy the JCL unpack job UPJPZ.jcl using an FTP connection in ASCII mode to an accessible location on z/OS.
5. Take the supplied UPJPZ.jcl job and change:
the location of the XMIT file. Look for SAG.JPZ vrs.XMIT.
the location of the target dataset. Look for SAG.JPZ vrs.CONT.
the HLQ in the RENAMEU statement.
the CLASS and MSGCLASS parameters of the job header to their respective valid values. This depends on your machine configuration.
6. Run the job as a JES batch job.
After unpacking, there should be three datasets under the specified HLQ:
HLQ.JPZ vrs.TAR
HLQ.JPZ vrs.LOAD
HLQ.MLC vrs.LOAD
Note:
This step is optional.
If you want the MVS Load Libraries for productive use of Jopaz in a location other than the delivery High Level Qualifier, you can move them to another HLQ. Please note their new location.
8. Find and note the location of the Jopaz license file. The required Jopaz license key is provided by Software GmbH logistics.
You must either use an existing license library dataset or create a new one. If you decide to create a new one, the necessary attributes for it are:
DSN=SAG.JPZvrs.LICS
DSORG=PO
DCB=(RECFM=FB,LRECL=80,BLKSIZE=3120)
SPACE=(CYL,(1,1,1))
Transfer the license file to your mainframe using an FTP in ASCII mode. Place the license file (JPZBT vrs) as a member in the license library dataset.
9. Copy and uncompress the .tar.Z archive in the UNIX System Services filesystem with the following lines of code.
a. Create a directory in the UNIX System Services filesystem to use as the JPZ installation directory. These installation instructions use /opt/softwareag as the default installation directory, but you must change it according to your system configuration.
$ mkdir -p /opt/softwareag
b. Copy the supplied JPZ vrs.tar.Z package.
$ cp "//’HLQ.JPZvrs.TAR(JPZTAR)’" /opt/softwareag/JPZvrs.tar.Z
c. Extract the contents of JPZ vrs.tar.Z.
$ cd /opt/softwareag
$ uncompress < JPZvrs.tar.Z | tar -oxf -
You should now see the jpz-installer directory.
10. Create a PDS dataset on z/OS to store the JZOS job templates of Jopaz.
You can either use the sample job zos_create_pds.jcl in the jpz-jcl-templates folder or create the PDS dataset in your usual way. If you decide to create the PDS dataset yourself, please make sure that the following attributes are included:
DSN=SAG.JPZvrs.JOBS
DSORG=POE
DCB=(RECFM=FB,LRECL=80,BLKSIZE=1600)
SPACE=(CYL,(10,10,10))
As an example, you can use the following notation: HLQ.JPZ vrs.JOBS.
11. Create a PDS dataset on z/OS to store the Jopaz configuration files created during installation.
To create the dataset, you can use the sample job zos_create_pds.jcl in /opt/softwareag/jpz-installer/jpz-jcl-templates or you can create it in the usual way:
DSN=SAG.JPZvrs.CONF
DSORG=POE
DCB=(RECFM=FB,LRECL=80,BLKSIZE=1600)
SPACE=(CYL,(10,10,10))
12. Create a PDS dataset on z/OS with the following attributes to store all Db2 static SQL DBRM plans at runtime:
DSN=SAG.JPZvrs.DBRM
DSORG=POE
DCB=(RECFM=FB,LRECL=80,BLKSIZE=32720)
SPACE=(CYL,(10,10,10))
The DSN is referenced later by the jpz_variable_input_file.txt in variable JPZ_DBRM_DSN used to configure the Jopaz installation.
Note:
This step is applicable only if you plan on using Jopaz for Db2.
13. Install the Adabas Service for Java (AJZ) by following the instructions in the README.TXT file located in the Adabas Client folder of the jpz-installer directory.
The installation process includes creating the AJZvrs.LOAD load library and installing the AJZJVMP front-end procedure. These are referenced later by the jpz_variable_input_file.txt used to configure the Jopaz installation.
Note:
This step is applicable only if you plan on using Jopaz for Adabas.