Using the Utility enhancements

z/OS® V2R1 adds the following DFSMSdfp utility enhancements:

The IEBCOPY utility is enhanced with user exit capabilities for specifying control statements and for specific member selection.
IEBCOPY's group copy function is expanded to include PDS to PDS member group copies. A new statement, COPYGROUP, provides the same functions as the existing COPYGRP statement, and expands it to support group copies when both the input and the output data set are PDSs.
IEBCOPY's SELECT statement also has been enhanced to allow wild card characters in the specification of member names, when used with the COPYGROUP statement. Member name filter pattern masking, using the asterisk (*) and percent (%) characters, allows you to specify a wide range of similar member names. If you use member name filter pattern matching on a SELECT statement with COPYGROUP, you can also code a corresponding EXCLUDE statement with member name filter pattern matching.

The IEBCOPY utility is also enhanced to provide an ABEND code and the associated reason code in a structure returned in register 0, for certain ABENDs. Starting in z/OS V2R1, IEBCOPY returns this information if an ABEND occurs in the FAMS subcomponent. For details, see the IEBCOPY return code information in Appendix A of z/OS DFSMSdfp Utilities.

Starting in z/OS V2R1, the IEBCOPY utility supports user exits supplied by the program that invokes IEBCOPY. (User exits are not supported when IEBCOPY is invoked directly using JCL). IEBCOPY supports the following user exits:

Control statement user exit – if provided by the invoking program, IEBCOPY calls this exit each time IEBCOPY needs to read a control statement. On each call to the exit, the exit can supply one or more control statements, and optionally, lines of text to be printed to SYSPRINT. IEBCOPY calls the control statement exit for each of the following functions:
- Initialize control statements exit
- Return control statement
- End control statements exit.
Note:
1. An input record returned to IEBCOPY may be a SYSIN statement record or a SYSPRINT record report.
2. If the control statement user exit is provided, IEBCOPY does not use SYSIN or a DD substituted for it.
Member selection user exit – if a member selection user exit is supplied in the caller's parameter list, IEBCOPY will call the member-selection user exit to substitute all member selection decision logic pertaining to SELECT and EXCLUDE control statements. IEBCOPY will pass each member name to the exit in alphanumeric order. The user exit can choose to include or exclude that name from the current operation.

For complete details on these user exits and their parameter lists, see Appendix A in z/OS DFSMSdfp Utilities.

Also in z/OS V2R1, IEBCOPY introduces a new COPYGROUP statement that provides the same function as the COPYGRP statement but also performs that same function for a PDS to PDS copy. (With COPYGRP, when the input and output data sets are both PDSes, the operation is treated as a simple COPY operation, not a group copy.)

Use the COPYGROUP statement to begin a group copy, unload, or load. A group consists of a member and all of its aliases. COPYGROUP treats the group as a single entity.

You can use COPYGROUP to copy a data set in the following situations:

PDS to PDS
PDS to PDSE
PDSE to PDS
PDSE to PDSE.

You can use COPYGROUP for unloading groups in the following situations:

PDS to PS
PDSE to PS

You can use COPYGROUP for loading groups in the following situations:

PS to PDSE
PS to PDS

When using the COPYGROUP statement:

All aliases in a group will be copied with the member or neither the aliases nor the member in a group will be copied.
There can be only one INDD per copy operation.
You can use the SELECT statement to selectively copy members. Either the member name or an alias can be specified to copy the member and all of its aliases.
Do not indicate replace (R) on the SELECT statement.
The EXCLUDE statement is not supported unless a SELECT MEMBER statement uses pattern filter matching and the EXCLUDE statement does also.

For complete details on using the new COPYGROUP statement, see the IEBCOPY chapter in z/OS DFSMSdfp Utilities.