Executing programs

The SCLM FLMTRNSL macro is similar to a JCL EXEC (EXECUTE) card. Figure 1 shows a single JCL card that runs a program named IEFBR14.

Figure 1. JCL: Execute IEFBR14

//STEP1    EXEC    PGM=IEFBR14

Figure 2 shows an SCLM FLMTRNSL macro that performs the same task as the JCL card in Figure 1.

Figure 2. SCLM: Execute IEFBR14

FLMTRNSL   COMPILE=IEFBR14,FUNCTN=BUILD,PORDER=0

FLMTRNSL's COMPILE option specifies the name of the program to execute (IEFBR14). The FUNCTN parameter specifies here that IEFBR14 will be invoked when the user requests a BUILD, and the PORDER value of 0 tells SCLM that neither an option list nor a ddname substitution list will be passed to IEFBR14.

The next figure is a slightly more complex example. We want to use a translator program named GAC to copy the contents of TSOSCxx.DEV1.SOURCE(MEMBER1) into TSOSCxx.DEV1.LIST(MEMBER1). The GAC program itself requires a SYSIN data set, which is empty in this example.

Figure 3. JCL: Execute GAC

//STEP1    EXEC    PGM=GAC
//SYSIN    DD      DUMMY
//INPUT    DD      DSN=TSOSCxx.DEV1.SOURCE(MEMBER1),DISP=SHR
//OUTPUT   DD      DSN=TSOSCxx.DEV1.LIST(MEMBER1),DISP=SHR

Figure 4 shows the SCLM language definition that performs the same task as the JCL in Figure 3.

Figure 4. SCLM Language Definition: Execute GAC

FLMTRNSL   COMPILE=GAC,FUNCTN=BUILD,PORDER=0
FLMALLOC   IOTYPE=A,DDNAME=SYSIN
 FLMCPYLB   NULLFILE
FLMALLOC   IOTYPE=A,DDNAME=INPUT
 FLMCPYLB   TSOSCxx.DEV1.SOURCE(MEMBER1)
FLMALLOC   IOTYPE=A,DDNAME=OUTPUT
 FLMCPYLB   TSOSCxx.DEV1.LIST(MEMBER1)

As before, the FLMTRNSL macro is used to specify the name of the program to run. The FLMALLOC and FLMCPYLB statements allocate the existing data sets to ddnames.