Tailor the RLX/CAF Installation Defaults
RLX
/CAF Installation DefaultsTailor 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:- Add any job and job parm statements required by your site.
- 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 theRLXJTA andRLXJTR jobs that allocated and restored theRLXdistribution libraries.
- Specify the name of the default Db2 subsystem through the DSN keyword (appearing below in bold italic type) of the CAF@DFLT macro. TheRLX/CAF SHARE_THREAD feature is enabled by default and the remainingRLX/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 useRLX/CAF as their Db2 attachment facility. See theRLX/CAF documentation before changing any of the other defaults.
- 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.////STEP1 EXEC DEFAULTS, // PROJECT='RAI',<< specify job and jobparm statements here >>// LIBRARY=R< specify 1st level dataset qualifier200,< specify 2nd level dataset qualifie// 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 DDNAMErSHRTHRD=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 //DSN=DSN, /Specify Db2 default subsystem name