Copy selected members using PDS processing options


The Copy utility can copy members of a partitioned data set based on member selection options, record selection, or both. File-AID member selection is provided by the PDS Processing Options which uses member name masks, member name ranges, and directory information such as last modified userid, and creation and modification dates to select members.

PDS Processing Options

When the FROM Dataset name field contains a partitioned dataset (PDS or PDSE) name with a member name mask or the member name is not specified, File-AID displays the PDS Processing Options screen.

When you enter a partitioned data set name and specify an * (asterisk) for member name, File-AID bypasses the PDS Processing Options screen and uses the default values as specified on the Processing Parameters screen, option 0.4, Processing Parameters Screen.

The PDS Processing Options screen is used to override the processing options defaults and specify additional member selection options. The processing options determine whether to copy the entire member, copy empty members, replace like-named members, process in JCL format, and rename members based on a mask. The additional member selection options include a member name mask and the ability to specify selection ranges for member name, last modified userid, creation date, and modification date, and the option to display a member selection list.

File-AID tailors the options that are displayed on the PDS Processing Options screen based on what you specified on the Copy Utility screen. The following table shows which options to expect.

If record selection criteria was specified on the Copy Utility screen, the selection criteria is applied after the members are selected from the Enhanced Member Selection screen.

Copy Utility PDS Processing Options

PDS Processing Option Fields

Copy Utility Screen Information

Copy entire member

Copy empty member

Process in JCL format

Replace like-named
members

Rename copied
members mask

Maximum generations
to copy

Member name mask

Member name range

Last modified userid

Creation date

Modification date

Display Member
Selection

Copying from PDS to PDS
No member name specified
No selection criteria usage


X


X

X


X

X

X

X

X

X

Copying from Version 2 PDSE to new Version 2 PDSE
No member name specified
No selection criteria usage


X


X1

X

X

X

X

X

X

X

X

Copying from PDS to PDS
No member name specified
Using selection criteria

X

X

X

X

X


X

X

X

X

X

X

Copying from PDS to PDS
Member name specified
No selection criteria usage


X


X









Copying from PDS to PDS
Member name is specified
Using selection criteria

X

X

X

X









Copying from PDS to Non-PDS
No selection criteria specified







X

X

X

X

X

X

Copying from PDS to Non-PDS
Selection criteria is specified

X


X




X

X

X

X

X

X

Copying from Loadlib to Loadlib
No member name specified
Selection Criteria not allowed




X



X

X




X

Copying from Loadlib to Loadlib
Member name specified
Selection Criteria not allowed




X









Copying Loadlib to PDSE Loadlib
No member name specified
Selection Criteria not allowed




X



X

X




X

Copying Loadlib to Loadlib PDSE w/alias
No member name specified
Selection Criteria not allowed
Display member selection list=NO




X



X





X2

  • 1 : When copying V2 PDSE member generations, Replace like-named member must be Y (yes).
  • : The Display member selection list prompt must be set to NO for alias to be copied.

The following figure is an inclusive example of all possible PDS processing options that can be displayed for a copy function.

PDS Processing Options Screen

File-AID ---------------- PDS Processing Options -----------------------------
 COMMAND ===>

 FROM Dataset: USERID9.FASAMP.XREF
     Copy entire member            ===> Y        (Y = Yes;
                                                  N = No, selected records only)
     Copy empty members            ===> N        (Y = Yes; N = No)
     Process in JCL format         ===> N        (Y = Yes; N = No)  

 TO Dataset:   USERID9.FASAMP.LAYOUTS
     Replace like-named members    ===> Y        (Y = Yes; N = No)  

     Rename copied members mask    ===>
     Maximum generations to copy   ===>
      (blank=No generations, 0=ALL, n=Number to include)
 Specify Member Selection Options (Blank for All Members)
     Member name mask              ===>
     Member name range             ===>          to ===>
     Last modified userid          ===>          to ===>
     Creation date                 ===>          to ===>            (YY/MM/DD)
     Modification date             ===>          to ===>            (YY/MM/DD)  

     Display member selection list ===> Y        (Y = Yes; N = No)

Maximum generations to copy

Specify a number between 1 and the MAXGENS number for this Version 2 PDSE. Or specify 0 to copy all generations. Leave blank to only copy the current member (0 generation). For example, specify 2 to copy the current member (0), (-1) and (-2) generation members.

By specifying a number between 1 and the MAXGENS number (see Maximum Generations) for the PDSE in this field you can limit the number of generation members to be copied. When 0 (zero) is specified all generations are copied.

Important

  1. This option is only available for a Version 2 PDSE in the Copy utility (3.3).
  2. The MAXGENS value may be higher than the current system MAXGENS_LIMIT if it was allocated when the system limit was higher (or imported from another system).
  3. When copying V2 PDSE member generations, Replace like-named member must be Y (yes).

The remaining fields on the PDS Processing Options Screen are described in Field Descriptions.

Member Selection List

The following figure allows you to select or exclude the displayed members from further processing. Enter a Y in the Display member selection list field on the PDS Processing Options screen to display this screen.

See Member List Field Descriptions for a description of each field on this screen. See Member List Primary Commands for a list of valid primary commands.

Member S/X List Screen

File-AID Member S/X - USERID9.FASAMP.JCL ------------------  ROW 1 TO 17 OF 17
 COMMAND ===>                                                  SCROLL ===> CSR
S/X  NAME             VV.MM  CREATED     CHANGED      SIZE  INIT   MOD   ID
    BATVTOC           01.00 95/02/03 95/02/03 15:44     23    23     0 USERID9
    COPY              01.00 95/02/03 95/02/03 15:44     22    22     0 USERID9
    CVT6XMAP          01.00 95/02/03 95/02/03 15:44     37    37     0 USERID9
    CVT70SEL          01.00 95/02/03 95/02/03 15:44     22    22     0 USERID9
    CVT70XRF          01.00 95/02/03 95/02/03 15:44     21    21     0 USERID9
    DROP              01.00 95/02/03 95/02/03 15:44     20    20     0 USERID9
    DUMP              01.00 95/02/03 95/02/03 15:44     18    18     0 USERID9
    JCLCNVRT          01.00 95/02/03 95/02/03 15:44     23    23     0 USERID9
    LIST              01.00 95/02/03 95/02/03 15:44     17    17     0 USERID9
    PRINT             01.00 95/02/03 95/02/03 15:44     18    18     0 USERID9
    SAMPLE01          01.00 95/02/03 95/02/03 15:44     14    14     0 USERID9
    SAMPLE02          01.00 95/02/03 95/02/03 15:44     17    17     0 USERID9
    SKELETON          01.00 95/02/03 95/02/03 15:44     23    23     0 USERID9
    SPACE             01.00 95/02/03 95/02/03 15:44     20    20     0 USERID9
    TALLY             01.00 95/02/03 95/02/03 15:44     21    21     0 USERID1
    UPDATE            01.00 95/02/03 95/02/03 15:44     27    27     0 USERID1
    USER              01.00 95/02/03 95/02/03 15:44     31    31     0 USERID1
 ******************************* BOTTOM OF DATA ******************************


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*