The generalized format for the EXEC statement is:
//IEFPROC EXEC PGM=IASXWR00[,REGION=nnnnnK,]
// [PARM=‘cxxxxxxxx[,seprname]]’
// [PARM=‘cxxxxxxxx[,seprname][,CERTIFY=Y|N]]’
The stepname must be IEFPROC, as shown. The parameter requirements
are as follows:
- PGM=IASXWR00
- The name of the external writer load module. It must be IASXWR00,
as shown.
- REGION=nnnnnK
- This parameter specifies the region size for the external writer
program. The value nnnnn is a 1- to 5-digit number that is multiplied
by 1K (1024 bytes) to designate the region size. The region size can
vary according to the size of buffers and the size of your output
writing routine. Insufficient region size will cause the external
writer to abend.
- [PARM=‘cxxxxxxxx[,seprname][,CERTIFY=Y|N]]’
- [PARM=‘cxxxxxxxx[,seprname][]’
- Specifies output writer routine characteristics.
- c
- An alphabetic character, either P (for
printer) or C (for card punch), that specifies
the control characters for the class of output the output writing
routine will process.
- xxxxxxxx
- From one to eight (no padding required) single-character SYSOUT
class names. These characters specify the classes the output writing
routine will process and establish the priority for those classes,
with the highest priority at the high-order (leftmost) end of the
character string.
Note: If the START command includes class
name parameters, they override all of the class names coded here.
If you do not code class names on the procedure EXEC statement or
the START command, then the external writer will wait for a MODIFY
command from the operator before processing any output.
- seprname
- This is the name of the output separator routine to run with
the output writing routine. If you omit this subparameter, no output
separator pages are produced.
IEFSD094 is the IBM-supplied output
separator routine. If you write your own output separator routine,
and name it here, put it in SYS1.LINKLIB (or a library concatenated
to LINKLIB through a LNKLSTxx member of parmlib).
Note: Do
not use CERTIFY as the name of your output
separator routine. For your separator routine to be invoked, you
must either code its name on this subparameter or name it in the parameters
on the START command.
- CERTIFY=Y|N
- Indicates whether (Y) or not (N) you want to ensure that all
data is safely written to the output device. CERTIFY=Y indicates
that data will not be lost even if the external
writer abnormally terminates, such as would occur if the output data
set becomes full.
Note: - The use of the certify function increases processing overhead
and decreases efficient space utilization by the output data set.
- If you write your own output writing routine and require the CERTIFY
function, you need to modify your code to be similar to that supplied
by IBM. Refer to "Using the CERTIFY Function" within section Programming Considerations for the Output Writing Routine for further details.
- IBM cannot guarantee data set integrity when writing multiple
data sets to a PDS/PDSE member even if you specify CERTIFY=Y. See Functions of the Output Writer Routine for further details.