Tailor the
RLX
/CAF Installation Defaults

Tailor the
RLX
/CAF installation defaults for shared thread applications.
After you restore the
RLX
distribution libraries from tape or cartridge, you should edit and submit the CAF$TPD member of the CRAIJCL data set. The JCL and assembly language source module contained in CAF$TPD will assemble and link-edit the
RLX
/CAF installation defaults module that supports the shared thread mode of operation between
RLX
and
RLX
/CAF. In addition, if you define a set of defaults for the
RLX
/CAF profile options, you need not explicitly specify them separately for each application. For example, you can specify the name of a Db2 subsystem to which your program should connect as a default. Thereafter you need not explicitly specify profile options except to override them.
To tailor the jobstream that assembles and link-edits the
RLX
/CAF profile defaults module, proceed as follows:
  1. Add any job and job parm statements required by your site.
  2. Specify values for the amper variables &PROJECT and &LIBRARY in the invocation of the instream procedure named DEFAULTS. You should code the same values for project and library as were specified for the
    RLX
    JTA and
    RLX
    JTR jobs that allocated and restored the
    RLX
    distribution libraries.
  3. Specify the name of the default Db2 subsystem through the DSN keyword (appearing below in bold italic type) of the CAF@DFLT macro. The
    RLX
    /CAF SHARE_THREAD feature is enabled by default and the remaining
    RLX
    /CAF defaults can be accepted without change. The DSN operand of the CAF@DFLT macro identifies the name of the default Db2 subsystem to which your application connects. This specification makes it unnecessary to explicitly specify a subsystem name for any Db2 applications that use
    RLX
    /CAF as their Db2 attachment facility. See the
    RLX
    /CAF documentation before changing any of the other defaults.
  4. Submit the job to assemble and link-edit the module.
The following code sample shows the
RLX
/CAF defaults macro. The items in bold italic type represent the parameters you should specify when you edit the CAF$DFLTS member.
//
<< specify job and jobparm statements here >>
//STEP1 EXEC DEFAULTS, // PROJECT='RAI',
< specify 1st level dataset qualifier
// LIBRARY=R
200
,
< specify 2nd level dataset qualifie
r
// UNIT=SYSDA UNIT NAME FOR DASD DATA SETS //A.SYSIN DD * TITLE 'CAF$TPD - CAF TABLE OF PROFILE DEFAULTS' *---------------------------------------------------------------------- * * FUNCTION * ======== * * RLX/CAF TABLE OF PROFILE DEFAULTS * * *---------------------------------------------------------------------- CAF$TPD CAF@DFLT LOAD=, /GLOBAL LOAD LIBRARY DDNAME
DSN=DSN, /Specify Db2 default subsystem name
SHRTHRD=YES, /ALLOW THIS APPL. THREAD BE SHARED RETRY=0, /RETRY Db2 CONNECTION 0 TIMES PLAN=, /DEFAULT Db2 PLAN NAME MSGDD=CAFPRINT, /DEFAULT CAF MESSAGE FILE PLANEXIT=, /WAIT 30 SEC BEFORE ATTEMPT ESTAE=, /ISSUE ESTAE IN RLX/CAF ERROR=ABEND, /ON ERROR ISSUE ABEND UPPER=NO, /TRANSLATE MESSAGED TO UPPERCASE TERMCNTL=YES, /INTERCEPT TERMINATION TO CLOSE PLANS DIAGCNTL=NO, /TRIGGER DIAGNOSTICS CONTROL DIAGLIM=1, /ABEND AFTER 1 ERROR DOC=NO /PRINT NO MACRO DOC //