Activating Distributed FileManager in System PROCLIB

Activating DFM involves adding a startup procedure to a new system PROCLIB member called DFM, for example, SYS1.PROCLIB(DFM). Once DFM is added to PROCLIB, DFM can be started by a system operator command. The operator command, which can be part of initial program load, identifies the DFM member (see Starting Up Distributed FileManager).

APPC/MVS and the APPC/MVS transaction scheduler (both are started by operator command) must be active before DFM LU 6.2 conversations can take place on z/OS®.

Figure 1 is an example of the contents of the DFM member.

Figure 1. DFM Member Example

//DFM     PROC  PARMS='NORMAL'
//***************************************************************
//*                                                             *
//*  DFM START UP PROCEDURE                                     *
//*                                                             *
//***************************************************************
//DFM      EXEC PGM=GDEISBOT,
//             PARM='&PARMS',
//             REGION=0K,
//             TIME=1440
//IEFPARM  DD   DSN=SYS1.PARMLIB,DISP=SHR
//* CHANGE THE STEPLIB STATEMENT AS REQUIRED IF YOUR INSTALLATION
//* DOESN'T HAVE THE LE RUNTIME DATA SET IN ITS LINK LIST.
//*STEPLIB  DD  DSN=SYS1.SCEERUN,DISP=SHR
//SYSPRINT DD   SYSOUT=*
//SYSUDUMP DD   SYSOUT=*
//*
//*  THE TWO FILES ASSOCIATED WITH THE DD STATEMENTS CDRATRC AND
//*  SYSOUT CAN BE USED TO DIAGNOSE DFM STARTUP PROBLEMS RELATED
//*  TO CDRA. (CDRA IS INVOKED DURING STARTUP FOR CERTAIN CCSID
//*  VALUES IN THE SYS1.PARMLIB MEMBER DFM00.)
//*
//*  YOU MUST ALLOCATE THE TWO FILES AS RECFM=FBA, LRECL=133,
//*  AND DSORG=PS BEFORE STARTING DFM WITH THE DD STATEMENTS
//*  ACTIVE.
//*
//*  NOTE THAT SYSOUT IS REQUIRED AND CDRATRC IS OPTIONAL
//*  WHEN USING CDRA AND THE DEFAULT INSTALLATION IS SET UP TO
//*  USE CDRA IF YOUR HOST CODE PAGE IS OTHER THAN 500.
//*
//*  CDRATRC  DD  DSN=SYS1.CDRATRC,DISP=SHR    CDRA API TRACING
//*  SYSOUT   DD  DSN=SYS1.CDRAOUT,DISP=SHR    C RUNTIME MESSAGES
//SYSOUT   DD  DUMMY <- DEFAULT = CDRA WITH RUNTIME MESSAGES DISCARDED

Note: LE is required to use CDRA, if LE is installed and is not in the link list, SYS1.PROCLIB(DFM) and SYS1.SAMPLIB(GDETPDEF) should be modified so their STEPLIB DD statements refer to the proper LE run time library. Refer to DFMREADM in SYS1.SAMPLIB for details.