Starting Your Product › How to Configure Without CA MSM › Configuring CA DRAS › Sample Configuration File

Sample Configuration File

A sample configuration file is provided in the CBY3OPTN file, member name CAHFDCFG. A definition of each of the generic statements is provided in the next section. For setting the product-specific statements, see the section that contains information about the product you are using.

SET    SERVER ID(DRASSVR)                              
SET    THREADS(12)                                                  
SET    LANGUAGE(T1252X1140)                                        
SET    CLIENT TYPE(WINDOWS)  
SET    CLIENT TRANSLATION(ON)
SET    LONGWAIT(60)                                                
SET    MESSAGE SUPP(ON)                                            
SET    MESSAGE ECHO(CAHFMTK016I) ROUT(11) DESC(6)                  
SET    MESSAGE ECHO(CAHFMTK021I) ROUT(11) DESC(6)                  
SET    MESSAGE ECHO(CAHFSCM001I) ROUT(11) DESC(6)                  
SET    MESSAGE ECHO(CAHFSPT010I) ROUT(11) DESC(6)                  
SET    MESSAGE ECHO(CAHFSPT011I) ROUT(11) DESC(6)        
SET    MESSAGE ECHO(nnn)         ROUT(11) DESC(6)                  
SET    MESSAGE ECHO(ON)                                            
ACCESS REPOSITORY NAME(nnnnnnnn) PATH('nnn.nnnnnn') PRODUCT(nnnn)

Standard CAHFDCFG Control Statements

These generic control statements are required for all products.

SET SERVER

The Server ID acts as a main identifier for the server on the network. All servers within a given network must have unique IDs. In this example, the SERVER ID has been defined as DRASSVR. The value defined in the Server ID field has no correlation to any other system identifier. It is a user-defined field with a maximum length of 8 bytes.

SET THREADS

The value defined in the THREADS parameter determines how many concurrent tasks are started to process work in the CA DRAS region. This is a tuning parameter, and increasing the count can improve server throughput if excessive delays are observed. Increasing this count cannot necessarily improve the throughput if the value has already been increased to the optimum setting for your system and workload. If performance improvement cannot be obtained by increasing the value in this field, contact your local technical support center for further assistance. The default is 12.

SET LANGUAGE

The language parameter specifies that data are generated in the chosen language.

SET CLIENT TYPE

Indicates the operating system of the client software. The default value of (WINDOWS) must be used.

SET CLIENT TRANSLATION

This setting tells the DRAS server how the EBCDIC to/from ASCII code page translation is performed.

ON (the default setting) indicates:

• The translation is shared between the z/OS based DRAS server and Windows-based DRAS client. Thus, both the server and client require the code page tables.
• Compatibility is guaranteed with currently supported older levels of the DRAS client which reside in CA OM Web Viewer.

  Note: If US-to-US code page is not used (the default), the On setting can cause more maintenance for the Document Viewer administrator because a code page table must be built for each language and then must reside on every user's PC and on the DRAS server.

OFF indicates:

• The z/OS based DRAS server does the translation.

  Note: If US-to-US code page (the default) is not used, maintenance is reduced because only one code page table must be built and it resides on the server.

• Be aware of the possibility of older DRAS client applications not supporting this feature.

  Note: In a mixed DRAS environment where two or more DRAS servers with different CLIENT TRANSLATION settings are set, when adding folders in CA OM Web Viewer, the DRAS discovery cannot list all active repositories.

SET LONGWAIT

Indicates the number of minutes a user can be inactive before a session time-out occurs.

SET MESSAGE SUPP

Specifies the level of messages written to the DRAS log. If message suppression is ON, informational messages are not written to the log.

For definitions of the Message and Access Repository Name control statements for your particular product, see one of the following:

• Modifying CA DRAS Control Statements for CA View
• Modifying CA DRAS Control Statements for CA Dispatch

Note: The SET MESSAGE DEST control statement is obsolete and must NOT appear in the configuration file. CA DRAS does not start if it finds this statement.

Configuring CA DRAS for CA View

The following section provides the information to configure CA DRAS for cooperative viewing from a CA View Report Repository.

Modify BY3CJST for CA View

The following JCL has been customized for CA View.

//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.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

Note: If CA Deliver is in use at your site and has been installed in a separate load library, it is necessary to add that library into your STEPLIB DD concatenation for CA DRAS. CA View needs access to CA Deliver load modules.