Defining the debugging profiles data sets as remote files

Define remote files when you want to use profiles that are stored in a region that is connected using MRO or ISC.

About this task

CICS® provides the following sample definitions:

Figure 1. Resource definitions for debugging profiles data sets defined as remote files
*-------------------------------------------------------------------* 
*    Define base file for Debugging Profiles (non-RLS remote)       * 
*-------------------------------------------------------------------* 
DEFINE FILE(DFHDPFMB) GROUP(DFHDPVSR)                                 
DESCRIPTION(Debugging Profile Base File - VSAM Remote)                
        REMOTESYSTEM(CICA)        REMOTENAME(DFHDPFMB)                
*-------------------------------------------------------------------* 
*    Define path file for Debugging Profiles (non-RLS remote)       * 
*-------------------------------------------------------------------* 
DEFINE FILE(DFHDPFMP) GROUP(DFHDPVSR)                                 
DESCRIPTION(Debugging Profile Path File - VSAM Remote)                
        REMOTESYSTEM(CICA)        REMOTENAME(DFHDPFMP)                

If you define remote files, you need to install corresponding file definitions in the remote system.

Procedure

  1. Copy the sample FILE definitions for DFHDPFMB and DFHDPFMP to another group.
  2. Add the DSNAME attribute.
    For DFHDPFMB
    Specify the name of the debugging profiles base data set, as shown in the following example:
    DSNAME ==> CICSTS64.CICS.DFHDPFMB
    For DFHDPFMP
    Specify the name of the debugging profiles base data set, as shown in the following example:
    DSNAME ==> CICSTS64.CICS.DFHDPFMP

    In these examples, the prefix of the data set reflects the release of CICS TS, and the release level is assumed to be CICS TS beta.

  3. Optional: Alternatively, you can omit the DSNAME attribute, and instead include a DD card in the CICS startup JCL, as shown in the following example. In the example, the high level qualifier (CICSTSnn.CICS) assumes the release level of CICS TS beta.
    //DFHDPFMB DD DSN=CICSTS64.CICS.DFHDPFMB,DISP=SHR
    //DFHDPFMP DD DSN=CICSTS64.CICS.DFHDPFMP,DISP=SHR
  4. Install the FILE definitions.