Install the GenevaERS Demo
Prerequisites:
- IBM z13 mainframe or later
- IBM z/OS V2R3 or later
- Java Version 21 or later
- IBM DFSORT or compatible sort utility
Download the release contents
The installation process for the GenevaERS Performance Engine will create several MVS datasets. It also copies a Java .jar file to a z/OS UNIX directory; this is the run control application (RCA).
In a new tab on your browser, navigate to the GenevaERS Performance Engine Demo page.
https://github.com/genevaers/Demo
On the right side of the GitHub page, click Releases, which is below the About section. Click on the green “Latest” button. Download the following files to your local drive:
- GVBDEMO.JCL.XMI
- GVBDEMO.GVBLOAD.XMI
- GVBDEMO.WBXMLI.XMI
- rcapps-4.1.0_<RCnn>.jar
Pre-allocate MVS datasets
The prefix for the MVS datasets is the same as your TSO ID. Using the TSO ID as the high-level qualifier of the installation of the MVS datasets simplifies the installation.
Copy the following JCL and paste it into a JCL library member in your mainframe session:
//ALCDEMO JOB (ACCT),CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1),NOTIFY=&SYSUID.
//*
// EXPORT SYMLIST=*
// SET HLQ=<your-tso-prefix>
//*
//DELFILES EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//SYSIN DD *,SYMBOLS=EXECSYS
DELETE &HLQ..GVBDEMO.GVBLOAD.XMI PURGE
DELETE &HLQ..GVBDEMO.WBXMLI.XMI PURGE
DELETE &HLQ..GVBDEMO.JCL.XMI PURGE
IF MAXCC LE 8 THEN /* IF OPERATION FAILED, */ -
SET MAXCC = 0 /* PROCEED AS NORMAL ANYWAY */
//*
//ALLOCATE EXEC PGM=IEFBR14
//GVBLOAD DD DSN=&HLQ..GVBDEMO.GVBLOAD.XMI,
// DISP=(NEW,CATLG,DELETE),
// UNIT=SYSDA,
// SPACE=(TRK,(3000,300)),
// DCB=(DSORG=PS,RECFM=FB,LRECL=80,BLKSIZE=3120)
//WBXML DD DSN=&HLQ..GVBDEMO.WBXMLI.XMI,
// DISP=(NEW,CATLG,DELETE),
// UNIT=SYSDA,
// SPACE=(TRK,(10,10)),
// DCB=(DSORG=PS,RECFM=FB,LRECL=80,BLKSIZE=3120)
//JCL DD DSN=&HLQ..GVBDEMO.JCL.XMI,
// DISP=(NEW,CATLG,DELETE),
// UNIT=SYSDA,
// SPACE=(TRK,(10,10)),
// DCB=(DSORG=PS,RECFM=FB,LRECL=80,BLKSIZE=3120)
Update the JOB statement above to conform to your installation’s standards. Set the value of HLQ above to your TSO Prefix. Submit the job to pre-allocate the transfer data sets.
Upload XMI files corresponding to the MVS datasets to your mainframe
Using your preferred file transfer technique, upload the following files in binary mode from your local drive to your mainframe, overwriting the transfer data sets that have just been allocated:
- GVBDEMO.JCL.XMI
- GVBDEMO.GVBLOAD.XMI
- GVBDEMO.WBXMLI.XMI
RECEIVE XMI files to extract MVS datasets
Copy the following JCL and paste it into a JCL library member in your mainframe session:
//RCVDEMO JOB (ACCT),CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1),NOTIFY=&SYSUID.
//*
// EXPORT SYMLIST=*
// SET HLQ=<your-tso-prefix>
//*
//DELFILES EXEC PGM=IDCAMS
//SYSPRINT DD SYSOUT=*
//SYSIN DD *,SYMBOLS=EXECSYS
DELETE &HLQ..GVBDEMO.GVBLOAD PURGE
DELETE &HLQ..GVBDEMO.WBXMLI PURGE
DELETE &HLQ..GVBDEMO.JCL PURGE
IF MAXCC LE 8 THEN /* IF OPERATION FAILED, */ -
SET MAXCC = 0 /* PROCEED AS NORMAL ANYWAY */
//*
//RECEIVE EXEC PGM=IKJEFT01,DYNAMNBR=30
//SYSTSPRT DD SYSOUT=*
//SYSTSIN DD *,SYMBOLS=EXECSYS
PROFILE NOPREFIX
RECEIVE INDSN(&HLQ..GVBDEMO.GVBLOAD.XMI)
DSN(&HLQ..GVBDEMO.GVBLOAD) RELEASE
RECEIVE INDSN(&HLQ..GVBDEMO.WBXMLI.XMI)
DSN(&HLQ..GVBDEMO.WBXMLI) RELEASE
RECEIVE INDSN(&HLQ..GVBDEMO.JCL.XMI)
DSN(&HLQ..GVBDEMO.JCL) RELEASE
Update the JOB statement above to conform to your installation’s standards. Set the value of HLQ above to your TSO Prefix. Submit the job to expand the transfer data sets into the installation data sets.
Allocate z/OS UNIX directory to contain RCA .jar file
Logon to z/OS UNIX and use mkdir to create a directory under your user ID
mkdir /u/<userid>/RCA
Copy RCA .jar file to z/OS UNIX directory
Using your preferred file transfer technique, upload the following file in binary mode from your local drive to the zFS file system of your mainframe:
rcapps-4.1.0_<RCnn>.jar
Creating symbolic link and adding permissions
touch rcapps-latest.jar;
rm rcapps-latest.jar;
ln -s rcapps-4.1.0_<RCnn>.jar rcapps-latest.jar
Generate the DEMO data
Update the JCL in <your-tso-prefix>.GVBDEMO.JCL(GENDATA) according to the comments there and submit the job to generate the demo data. The test data comprises the following 10 files, the 3 Order Item files being the largest totalling 27,500,000 records by default:
- <your-tso-prefix>.GVBDEMO.CUSTOMER
- <your-tso-prefix>.GVBDEMO.CUSTNAME
- <your-tso-prefix>.GVBDEMO.ORDER
- <your-tso-prefix>.GVBDEMO.ORDITM01
- <your-tso-prefix>.GVBDEMO.ORDITM02
- <your-tso-prefix>.GVBDEMO.ORDITM03
- <your-tso-prefix>.GVBDEMO.PRODUCT
- <your-tso-prefix>.GVBDEMO.PRODDESC
- <your-tso-prefix>.GVBDEMO.CUSTADDR
- <your-tso-prefix>.GVBDEMO.STOREADR
Run the DEMO JCL
The DEMO itself comprises the following 4 jobs:
- RUNEXT1
- RUNFMT1
- RUNFMT2
- RUNFMT3
Update the JCL in <your-tso-prefix>.GVBDEMO.JCL library according to the comments there and submit the first job RUNEXT1 to execute the GenevaERS Demo Run Control and Extract phases. This job will submit the 3 Format phase jobs upon completion.
Review the following control reports in your job output
RCARPT - This report is from program RCA (the Run Control Phase), which specifies the work to be done in the current run. It also optimizes the work to allow the upcoming Extract Phase to perform multiple operations in a single pass of the source data.
REFRRPT - This report is from program GVBMR95R (the Reference Phase), which pre-processes reference data to conserve memory and optimize lookups in the Extract Phase
EXTRRPT - This report is from program GVBMR95E (the Extract Phase), which reads one or more source data files, performs table lookups and transformations, and writes one or more output files.
MR88RPT - This report is from program GVBMR88 (the Format Phases), which sorts, summarizes, and formats the data as necessary.
Review the following data sets that were output from this run:
- <your-tso-prefix>.GVBDEMO.PASS1.DAGSTATO
- <your-tso-prefix>.GVBDEMO.PASS1.DCOBYSTO
- <your-tso-prefix>.GVBDEMO.PASS1.DCUSTORO
- <your-tso-prefix>.GVBDEMO.PASS1.DEXLKUP0