Step 3. Allocate a System GMJD Library (File-to-File Customers Only)

This step is optional and applies only to systems that have the File-to-File feature of BDT.

A generic master job definition (GMJD) library is a data set that contains precoded file-to-file transaction definitions. There are two types of GMJD libraries: private and system. Users may define private GMJD libraries or they may use a system GMJD library that you create.

If you want to create a system GMJD library you must first allocate a partitioned data set for it. You can allocate it using ISPF, the TSO ALLOCATE command, or a batch job (using the IEFBR14 program; see Figure 1 for sample JCL).

Requirements are:

Name: Any name. Later you will specify this name on a DD statement in the BDT start procedure at Step 1. Write a BDT Start Procedureor on a DYNALLOC statement at DYNALLOC—Dynamically Allocate BDT Data Sets) that is in the initialization stream invoked by the BDT start procedure.
Size: Customer-determined, depending on the total size of all the transaction definitions that will be stored there.
Organization: Partitioned. Each transaction definition must be stored as a member of the data set. The name of the member is also the name of the transaction definition. The member name may be any valid member name except Q or the name of a BDT command.
Record Format: Fixed (F) or fixed blocked (FB)
Record Length: 80
Block Size: Maximum of 32720

Transaction definitions that are stored in a GMJD library may contain passwords that are not encrypted. To prevent unauthorized exposure of these passwords you should RACF-protect the system GMJD library. Only BDT should be authorized to access the library.

For information on how to use a system GMJD library, see z/OS BDT File-to-File Transaction Guide .

Figure 1. A Sample DD Statement to Allocate a Data Set for a System GMJD Library. It is contained in SYS1.SAMPLIB member BDT$ALOC.

//GMJDLIB  DD  UNIT=3380,VOL=SER=BDTDRV,DISP=(NEW,CATLG),
//             DSN=SYS1.GMJD,SPACE=(CYL,(10,1,111)),
//             DCB=(RECFM=FB,LRECL=80,BLKSIZE=3120)