What program name do I put on the EXEC card?

PGM=EZTPA00 for Easytrieve Report Generator 11.6. Older procs that say PGM=EZT or PGM=EZTCOM still start the product, and Broadcom marks those names deprecated.

Which DD names does every Easytrieve step need?

STEPLIB (or JOBLIB) for the product load library, SYSIN for source, and SYSPRINT for the listing. EZOPTBL points at the options table when the region has no default. Business files add one DD per FILE statement.

How does a FILE statement connect to a data set?

The Easytrieve file-name is the DD name. FILE TRANSIN is //TRANSIN DD in the same step. SYSNAME on FILE is the override when the DD name and the Easytrieve name differ.

When do I add a link-edit step?

When the program is stored as a load module and later jobs execute PGM=that-module. PARM LINK(module-name) plus SYSLIN feeds IEWL. Compile-and-go jobs skip that step.

Easytrieve JCL Integration Cheat Sheet - EZTPA00, DD Names, Compile and Go

Easytrieve JCL Integration Cheat Sheet

JCL is how z/OS finds EZTPA00, feeds it source, and attaches the data sets the FILE statements name. This sheet is the short version: the EXEC program, the DD names that show up on every step, and one compile-and-go skeleton. Dataset names below are placeholders. Your site HLQ and the options-table DSN live in the installation notes.

DD names

DDs on an Easytrieve step
DD	Purpose
STEPLIB	Easytrieve load library (CBAALOAD) and any DB2 or IMS libraries
SYSIN	Source member, or inline PARM plus source
SYSPRINT	Compile listing and runtime messages
EZOPTBL	Options table when the region has no site default
EZTVFM	Work space for virtual files
PANDD	Macro library, when the program uses macros
SYSLIN	Object passed to IEWL on a compile-then-link job
File DD	Same name as the FILE statement (TRANSIN, MASTER, RPTOUT)

Compile and go

One step compiles the member and runs it when the compile is clean. The DD names TRANSIN and RPTOUT must match FILE statements in DAYRPT. REGION=4M is a common starting size for larger reports.

jcl

1
2
3
4
5
6
7
8
//GO       EXEC PGM=EZTPA00,REGION=4M
//STEPLIB  DD DISP=SHR,DSN=your.easytrieve.r116.CBAALOAD
//EZOPTBL  DD DISP=SHR,DSN=your.easytrieve.r116.EZOPTBL
//EZTVFM   DD UNIT=SYSDA,SPACE=(4096,(100,100))
//SYSPRINT DD SYSOUT=*
//TRANSIN  DD DISP=SHR,DSN=PROD.DAILY.TRANS
//RPTOUT   DD SYSOUT=*
//SYSIN    DD DSN=DEV.EZT.SOURCE(DAYRPT),DISP=SHR

Compile, then link

PARM LINK(module) at the top of SYSIN names the load module. SYSLIN carries the object into IEWL. A later job executes PGM=that-module and only needs the file DDs.

jcl

1
2
3
4
5
6
7
8
9
10
11
12
13
14
//COMPLK  EXEC PGM=EZTPA00,REGION=4M
//STEPLIB  DD DISP=SHR,DSN=your.easytrieve.r116.CBAALOAD
//SYSPRINT DD SYSOUT=*
//SYSLIN   DD UNIT=SYSDA,SPACE=(400,(100,50)),DISP=(,PASS),DSN=&&SYSLIN
//SYSIN    DD *
PARM LINK(MTHRPT)
* source follows
/*
//LKED     EXEC PGM=IEWL
//SYSPRINT DD SYSOUT=*
//SYSLIN   DD DSN=*.COMPLK.SYSLIN,DISP=(OLD,DELETE)
//SYSLIB   DD DISP=SHR,DSN=your.easytrieve.r116.CBAALOAD
//SYSLMOD  DD DISP=SHR,DSN=PROD.EZT.LOAD
//SYSUT1   DD UNIT=SYSDA,SPACE=(CYL,(1,5))

PARM on SYSIN

SYNTAX checks the source and stops before object code.
COMPILE writes object to SYSLIN for a separate link.
LINK(module) names the load module the binder writes.
COMPAT keeps 6.4 behavior while you migrate a program to 11.6.

When the step fails

JCL symptoms
Symptom	Look at
S806 on EZTPA00	STEPLIB and CBAALOAD concatenation
Options table message	EZOPTBL, or the EZTINI default
Data set not found for a file	DD name versus FILE name
Compile RC 12	SYSPRINT, first error line
S013	SPACE or DISP on EZTVFM or an output DD

Explain it like I'm five

The EXEC card calls the Easytrieve program. SYSIN is the homework you hand it. STEPLIB is the shelf where that program lives. Each FILE name is a labeled bin; the DD with the same name is the actual box of cards you put in that bin. SYSPRINT is the paper it writes its notes on.

Exercises

Write a compile-and-go step for FILE MASTER and FILE ERRLIST.
Name the DD that is missing when EZTPA00 abends S806.
Add PARM LINK(CLMRPT) and say which later step consumes SYSLIN.
A program uses FILE CLAIMS and the JCL says //CLAIM DD. What do you change?

Quiz

Test Your Knowledge

1. New Easytrieve 11.6 JCL runs:

PGM=EZTPA00
PGM=IEFBR14
PGM=DFSORT
PGM=IDCAMS only

2. SYSIN holds:

PARM plus source, or the member to compile
The load library
Printer carriage control only
RACF profiles

3. A business FILE named TRANSIN needs:

A DD named TRANSIN in the step
A DD named SYSUT1 always
No DD if FILE is coded
A sort work DD only

4. S806 on EZTPA00 usually means:

STEPLIB does not contain CBAALOAD
A TITLE is missing
SUM listed the wrong field
The report LINESIZE is 80

5. Compile-and-go omits SYSLIN because:

The step compiles and runs in one execution
JCL cannot have SYSIN
IEWL replaces EZTPA00
File DDs are illegal

DD names

DDs on an Easytrieve step
DD	Purpose
STEPLIB	Easytrieve load library (CBAALOAD) and any DB2 or IMS libraries
SYSIN	Source member, or inline PARM plus source
SYSPRINT	Compile listing and runtime messages
EZOPTBL	Options table when the region has no site default
EZTVFM	Work space for virtual files
PANDD	Macro library, when the program uses macros
SYSLIN	Object passed to IEWL on a compile-then-link job
File DD	Same name as the FILE statement (TRANSIN, MASTER, RPTOUT)

Compile and go

One step compiles the member and runs it when the compile is clean. The DD names TRANSIN and RPTOUT must match FILE statements in DAYRPT. REGION=4M is a common starting size for larger reports.

jcl

1
2
3
4
5
6
7
8
//GO       EXEC PGM=EZTPA00,REGION=4M
//STEPLIB  DD DISP=SHR,DSN=your.easytrieve.r116.CBAALOAD
//EZOPTBL  DD DISP=SHR,DSN=your.easytrieve.r116.EZOPTBL
//EZTVFM   DD UNIT=SYSDA,SPACE=(4096,(100,100))
//SYSPRINT DD SYSOUT=*
//TRANSIN  DD DISP=SHR,DSN=PROD.DAILY.TRANS
//RPTOUT   DD SYSOUT=*
//SYSIN    DD DSN=DEV.EZT.SOURCE(DAYRPT),DISP=SHR

Compile, then link

PARM LINK(module) at the top of SYSIN names the load module. SYSLIN carries the object into IEWL. A later job executes PGM=that-module and only needs the file DDs.

jcl

1
2
3
4
5
6
7
8
9
10
11
12
13
14
//COMPLK  EXEC PGM=EZTPA00,REGION=4M
//STEPLIB  DD DISP=SHR,DSN=your.easytrieve.r116.CBAALOAD
//SYSPRINT DD SYSOUT=*
//SYSLIN   DD UNIT=SYSDA,SPACE=(400,(100,50)),DISP=(,PASS),DSN=&&SYSLIN
//SYSIN    DD *
PARM LINK(MTHRPT)
* source follows
/*
//LKED     EXEC PGM=IEWL
//SYSPRINT DD SYSOUT=*
//SYSLIN   DD DSN=*.COMPLK.SYSLIN,DISP=(OLD,DELETE)
//SYSLIB   DD DISP=SHR,DSN=your.easytrieve.r116.CBAALOAD
//SYSLMOD  DD DISP=SHR,DSN=PROD.EZT.LOAD
//SYSUT1   DD UNIT=SYSDA,SPACE=(CYL,(1,5))

PARM on SYSIN

SYNTAX checks the source and stops before object code.
COMPILE writes object to SYSLIN for a separate link.
LINK(module) names the load module the binder writes.
COMPAT keeps 6.4 behavior while you migrate a program to 11.6.

When the step fails

JCL symptoms
Symptom	Look at
S806 on EZTPA00	STEPLIB and CBAALOAD concatenation
Options table message	EZOPTBL, or the EZTINI default
Data set not found for a file	DD name versus FILE name
Compile RC 12	SYSPRINT, first error line
S013	SPACE or DISP on EZTVFM or an output DD

Explain it like I'm five

Exercises

Write a compile-and-go step for FILE MASTER and FILE ERRLIST.
Name the DD that is missing when EZTPA00 abends S806.
Add PARM LINK(CLMRPT) and say which later step consumes SYSLIN.
A program uses FILE CLAIMS and the JCL says //CLAIM DD. What do you change?

Easytrieve JCL Integration Cheat Sheet

DD names

Compile and go

Compile, then link

PARM on SYSIN

When the step fails

Explain it like I'm five

Exercises

Quiz

Test Your Knowledge

Related Concepts

JCL execution

DD statements

FILE statement

Related Pages

Easytrieve JCL Integration Cheat Sheet

DD names

Compile and go

Compile, then link

PARM on SYSIN

When the step fails

Explain it like I'm five

Exercises

Quiz

Test Your Knowledge

Related Concepts

JCL execution

DD statements

FILE statement

Related Pages