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.JPZvrs.XMIT.
the location of the target dataset. Look for
SAG.JPZvrs.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.JPZvrs.TAR HLQ.JPZvrs.LOAD HLQ.MLCvrs.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 AG 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 (JPZBTvrs) 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 cofiguration.
$ mkdir -p /opt/softwareag
b. Copy the supplied JPZvrs.tar.Z package.
$ cp "//’HLQ.JPZvrs.TAR(JPZTAR)’" /opt/softwareag/JPZvrs.tar.Z
c. Extract the contents of JPZvrs.tar.Z.
$ cd /opt/softwareag
$ uncompress < JPZvrs.tar.Z | tar -oxf -
You should now see the jpz-installer directory.
10. Create a PDS dataset in 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.JPZvrs.JOBS.
11. Create a PDS dataset in 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.
12. 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.