Customizing RestartPlus for Your Installation

Copy Load Library to an APF Authorized Dataset

RestartPlus requires APF authorization to run. We recommend, therefore, that you copy all the modules in the load library to an APF authorized linklist dataset. Alternatively, you may simply APF authorize the distribution load library and add it to the linklist.

Building the RestartPlus Journal

RestartPlus retains information about unreferenced members in its Journal. This dataset must be created at installation time, before the RestartPlus Supervisor or Agent can be run. A JCL stream is provided to help create these datasets. It is supplied as a member of the source distribution library.

If you are upgrading from a previous releases of RestartPlus , you can skip this step and use your existing journal and journal data.

UC4INIT

This stream allocates and initializes the RestartPlus Journal.

//**********************************************************************

//* *

//* U C 4 R E S T A R T P L U S *

//* *

//* JOURNAL INITIALIZATION JOBSTREAM *

//* *

//**********************************************************************

//* *

//* GLOBALLY CHANGE THE FOLLOWING VARIABLES TO APPROPRIATE VALUES:*

//* *

//* $SLIB - FULLY QUALIFIED STEPLIB DSN *

//* $JLOC - UNIT, VOLSER, STORCLASS ETC. FOR JOURNAL *

//* $JNAME - FULLY QALIFIED JOURNAL NAME *

//* *

//**********************************************************************

//UC4DELET EXEC PGM=IDCAMS

//SYSPRINT DD SYSOUT=*

//SYSIN DD *

DELETE $JNAME

SET MAXCC = 0

//UC4INIT EXEC PGM=REPOSINI

//* NOTE - STEPLIB IS NOT REQUIRED IF //* IS INSTALLED IN AN AUTHORIZED LINKLIST DATASET

//STEPLIB DD DISP=SHR,DSN=$SLIB

//SYSPRINT DD SYSOUT=*

//JOURNAL DD DSN=$JNAME,

// DISP=(NEW,CATLG),

// $JLOC,

// DCB=(DSORG=PS),

// SPACE=(CYL,(100),,CONTIG)

The JCL stream contains symbols that should be modified for local site conventions and then submitted to allocate and initialize the Journal. The symbols that must be changed in the jobstream are as follows:

$SLIB

Fully qualified RestartPlus distribution load library DSN.
$JNAME

Fully qualified RestartPlus Journal DSN that you have chosen. The DSN chosen must be a dataset name for which all users have READ access
$JLOC

UNIT, VOLSER, STORCLASS, etc. for RestartPlus Journal.

Note: If RestartPlus will be run on more than one system, the Journal must reside on a shared DASD device.

After changing these symbols, review the jobstream to ensure they have been properly substituted, and then submit the job. All steps of the job should complete with a return code of 0.

Calculating the Size of the RestartPlus Journal Dataset

The RestartPlus Journal initialization procedure (UC4INIT) is delivered with a default Journal space allocation of 100 cylinders. On a 3390, this would provide an optimal Journal capacity of approximately 3,200 partitioned JOBs. The maximum dataset entry capacity would be approximately 6,000 JOBs.

The general rule of thumb for RestartPlus Journal space allocation is 32 JOBs per 3390 cylinder. This allocation scheme allows a fairly optimal distribution of dataset entries across the Journal space and should minimize the chance of data not being recorded because of a full Journal.

If necessary, you should alter the JCL space allocation on the JOURNAL DD for the estimated number of JOBs to be tracked at your site.

Keep in mind that the total Journal allocation must be specified as primary space only-no secondary space allocation amount is allowed.

Installing the UC4REST PROC

The UC4REST PROC simplifies the running of the RestartPlus run-time module. It is supplied as member UC4REST in the source library. It must be copied to a system procedure library.

Sample of this PROC:

//UC4REST PROC TYPE=,START=,END=,RETCODE=,GDGOPT=,SIMULAT=,STPCODE=

//**********************************************************************

//* *

//* R E S T A R T P L U S *

//* *

//* RUN TIME MODULE PROC *

//* *

//* TYPE= : PR- PRODUCTION RUN (DEFAULT), RR- RESTRAT/RERUN *

//* SU- SUPPRESS *

//* *

//* RESTART/RERUN INFO - *

//* IF TYPE=RR AND START IS NOT SPECIFY, STARTING POSITION IS *

//* DETERMINED BY JOURNAL DATA *

//* *

//* START= : IF TYPE=RR, STEP NUMBER (1-255), STEPNAME, OR *

//* PROCSTEP.STEP TO RESTART RERUN JOB *

//* END= : IF TYPE=RR, STEP NUMBER (1-255), STEPNAME, OR *

//* PROCSTEP.STEP TO END RERUN JOB *

//* RETCODE= : IF TYPE=RR, RC FOR RUN TIME MODULE TO POST *

//* GDGOPT= : IF TYPE=RR, YES (DEFUALT) - ADJUST GDG BIAS INFO *

//* NO - DO NOT PERFORM GDG BIAS PROCESSING *

//* SIMULAT= : YES - SIMULATE PROCESSING, NO (DEFAULT) - PERFORM *

//* NORMAL PROCESSING *

//* STPCODE= : IF TYPE=RR, STEPNAME=RC, PROCSTEP.STEPNAME=RC, POST *

//* THE SPECIFIED RC FOR THE SPECIFIED STEP *

//* *

//**********************************************************************

//UC4REST EXEC PGM=UC4REST,PARM='RT=&TYPE,RS=&START,ES=&END,GO=&GDGOPTX

// ,SI=&SIMULAT,SC=&STPCODE,RC=&RETCODE'

//* NOTE - STEPLIB IS NOT REQUIRED IF //* IS INSTALLED IN AN AUTHORIZED LINKLIST DATASET

//STEPLIB DD DISP=SHR,DSN=uc4_restart_loadlib

//SYSPRINT DD SYSOUT=*

// PEND

If you have installed RestartPlus to a linklist dataset, you may remove the STEPLIB statement in the UC4REST PROC. Otherwise, you must change the "uc4_restart_loadlib" DSN value to the name of the APF authorized library that contains RestartPlus .

Installing the UC4SUP Job

The UC4SUP job is responsible for running the RestartPlus Supervisor. It is supplied as member UC4SUP in the source library. It must be copied to a dataset that contains the JCL for your system-started tasks.

Sample of this job:

//UC4SUP JOB (acctinfo),'user info',CLASS=c,MSGCLASS=m,PERFORM=4,

// TIME=1440,REGION=6M,USER=username,PASSWORD=password

//UC4SUP EXEC PGM=UC4SUP

//* NOTE - STEPLIB IS NOT REQUIRED IF RestartPlus

//* IS INSTALLED IN AN AUTHORIZED LINKLIST DATASET

//STEPLIB DD DISP=SHR,DSN=uc4_restart_loadlib

//JOURNAL DD DISP=SHR,DSN=uc4_restart_journal

//SYSPRINT DD SYSOUT=*

//SYSUDUMP DD SYSOUT=*

You must modify the JOB card for your environment.

You must also change "uc4_restart_journal" to the name of the Journal that you allocated earlier.