Previous Topic: Configuring CA DRAS

Next Topic: Modifying the CA DRAS Control Statements


Customize BY3CJST

Member BY3CJST in CAI.CBY3PROC provides the sample JCL needed to execute CA DRAS in your environment. The example below explains the required DD statements and defines which libraries need to be allocated. Modify these statements to reflect your data set choices.

//CADRAS EXEC PGM=CAHFDRAS,TIME=NOLIMIT,REGION=0M,PARM='TRAP(OFF)/'   
//STEPLIB  DD DISP=SHR,DSN=CAI.CBY3LOAD (DRAS LOADLIB)                
//*        DD DISP=SHR,DSN=CAI.CVDELOAD (VIEW REPOSITORY LOADLIB)     
//*        DD DISP=SHR,DSN=CAI.CADSLOAD (DISPATCH REPOSITORY LOADLIB) 
//*        DD DISP=SHR,DSN=CAI.CSARLOAD (SASC RUNTIME LIBRARY)        
//DRASCFG  DD DISP=SHR,DSN=CAI.CBY3OPTN(CAHFDCFG) (CONFIGURATION FILE)
//SYSOUT   DD SYSOUT=*,HOLD=YES                                       
//SYSPRINT DD SYSOUT=*,HOLD=YES                                       
//DRASLOG  DD SYSOUT=*,HOLD=YES                                       
//DRASTRC  DD SYSOUT=*,HOLD=YES                                       
//*                                                                   
//* AFP-TO-PDF TRANSFORM DD STATEMENTS                                
//*                                                                   
//*A2PDREPT DD DUMMY                                                  
//*A2PDPARM DD DISP=SHR,DSN=CAI.CBY3OPTN(CAHAA2PP)                    
//*A2PDFCT  DD DISP=SHR,DSN=CAI.CBY3OPTN(CAHAMFCT)                    
//*PDEFPDS  DD DISP=SHR,DSN=SYS1.PDEFLIB                              
//*FONTPDS  DD DISP=SHR,DSN=SYS1.FONTLIBB                                                                          

The CA DRAS task can be executed as a started task or a batch job. Depending on site-specific requirements, it is recommended that it be defined as a started task to ensure a higher dispatching priority and greater throughput. To run CA DRAS as a started task, the STC JCL must be copied into a system PROCLIB.

Note: Use the REGION=0M parameter in the JCL on the Job Card statement for the task, to allocate the maximum system default size.

Additional customization requirements are based on the individual report repositories that are being used for each CA DRAS task. It is possible to have multiple repositories controlled by one CA DRAS task, even if you are storing and accessing reports from different repository systems. For example, you can have one CA DRAS task controlling user access to a CA View repository, as well as a CA Dispatch database.

Note: For more information about the customization requirements for each repository system, see the following sections for CA View and CA Dispatch.

The following table explains the JCL statements in BY3CJST.

DDname

Purpose

STEPLIB

Points to the library containing CA DRAS server modules as well as the libraries that contain the agent modules and main modules for each report repository system.

DRASCFG

Points to the data set containing CA DRAS configuration statements.

SYSOUT

Points to the data set that is to receive IBM C runtime error messages.

SYSPRINT

Points to the data set that is to receive CA DRAS informational messages.

DRASTRC

Points to the data set that is to receive the CA DRAS runtime trace.

DRASLOG

Points to the data set that is to receive the CA DRAS message log.