Using an Exit Routine with IEBDG

IEBDG provides a user exit so you can analyze or further modify a newly constructed record before it is placed in the output data set. This exit routine is specified on the CREATE statement.

The CREATE statement defines the contents of records to be made available to a user routine or to be written directly as output records.

After processing each potential output record, the user routine should provide a return code in register 15 to instruct IEBDG how to handle the output record. The return codes are listed in Figure 1.

When an exit routine is loaded and you return control to IEBDG, register 1 contains the address of the first byte of the output record.

Figure 1. IEBDG User Exit Return Codes

Codes: Meaning
00 (X'00'): The record is to be written.
04 (X'04'): The record is not to be written. The skipped record is not to be counted as a generated output record; processing is to continue as though a record were written. If skips are requested through user exits and input records are supplied, each skip causes an additional input record to be processed in the generation of output records. For example, if a CREATE statement specifies that 10 output records are to be generated and a user exit indicates that two records are to be skipped, 12 input records are processed.
12 (X'0C'): The processing of the remainder of this set of utility control statements is to be bypassed. Processing is to continue with the next DSD statement.
16 (X'10'): All processing is to halt.