When the C or CO line command is entered against a directory, the Copy From z/OS® UNIX Directory panel is displayed.

                       Copy From z/OS UNIX Directory
 Command ===>                                                             

 From z/OS UNIX directory:
   Name . . . : /u/mburns/jcldir

 To partitioned data set:
   Name . . . .                                               

 Options
      Replace like-named members
      Selection list...
   /  Include lowercase names
   /  Strip suffix                       (Suffix to strip)
      Binary copy
      Convert

 Conversion Table                                                          


  F1=Help        F2=Split       F3=Exit        F4=Expand      F7=Backward
  F8=Forward     F9=Swap       F10=Actions    F12=Cancel

This panel allows you to copy the data from regular files in a directory to members in a partitioned data set.

For a file to be selected for copying, it must have a file name that conforms to the naming conventions for a partitioned data set member. This panel also provides options that allow you to further control the files selected for copying.

The panel displays the path name of the directory being copied. These mandatory input fields are displayed on this panel:

Name

The name of an existing partitioned data set where the regular files in the directory will be copied. The files are copied into members in the partitioned data set.

These optional input fields are available on this panel:

Replace like-named members

When this option is selected, if the file into which the data from a selected member is to be copied already exists in the directory, the existing file will be overwritten with the data from the selected member. If this option is not selected, the member will not be copied.

Selection list

If this option is selected, the z/OS UNIX Directory Copy Selection List panel is displayed. This panel displays a list of the regular files that are eligible to be copied to the partitioned data set. The list contains these fields:

S

An input field where you can enter S to indicate the associated regular file is to be copied to the partitioned data set.

Filename

The name of a regular file that can be copied to the partitioned data set. The name conforms to the rules for a member name and fits the selection criteria specified on the Copy From z/OS UNIX Directory panel.

Member

The name to be used for the member into which the data from the associated regular file will be copied. Each member name is generated from the name of the source file. You can change a generated member name to something other than the name assigned by ISPF. For example, if ISPF generates the same member name for two files, you can change one of the member names to make them both unique.

Message

This field displays a message indicating the result of copying the regular file to the member. The possible values displayed are:

*COPIED

The data from the regular file was successfully copied to a new member in the partitioned data set.

*REPL

The data from the regular file was copied to an existing member in the partitioned data set. The data in the member was overwritten. This can only occur when the Replace like-named members option is selected on the Copy From z/OS UNIX Directory panel.

*NO-REPL

The data from the regular file was not copied to the partitioned data set member because the member already existed and the Replace like-named members option was not selected on the Copy From z/OS UNIX Directory panel.

*FAILED RC=xx

The OGET command invoked to copy the data from the file to the member failed with return code xx. The data was not copied.

When you press Enter on this panel, the selected files will be copied to the partitioned data set. The Message field indicates the result of the copy operation for each file.

Include lowercase names

When this option is selected the file names for the regular files will be converted to uppercase before being checked for a valid member name. If this option is not selected, regular files whose file name contains lowercase characters will not be considered for copying to the partitioned data set.

Strip suffix

When this option is selected suffixes will be stripped from the file name at the first period (.) before being checked for a valid member name. The accompanying input field allows you to specify a particular suffix to be stripped (regular files with other suffixes will not be considered for copying). If this option is not selected, any regular files whose file name includes suffixes will not be copied to the partitioned data set.

Selecting this option can result in ISPF attempting to copy different files into the same member. For example, if the Strip suffix option is selected and the directory being copied contains these files:

• pgm1.exe
• pgm1.o
• pgm1.C

the data for each of these files is written to member PGM1. If the Replace like-named members option is also selected, member PGM1 will contain the data from file pgm1.C. If the Replace like-named members option is not selected, member PGM1 will contain the data from file pgm1.exe.

Binary copy

When this option is selected it indicates the file being copied contains binary data. This causes the copy to take place without any consideration for newline characters or the special characteristics of DBCS data. If this option is not selected the file is assumed to contain TEXT data.

Convert

This option specifies whether data conversion is required during the copy operation. Typically, conversion is only required when the data contains square brackets. If no value is entered in the Conversion Table field, the data being copied is converted using the default conversion table (BPXFX000) in the standard library concatenation. By default, this would cause a conversion between code pages IBM-037 and IBM-1047. Otherwise the value in the Conversion Table field identifies a conversion table to be used for the copy operation.

Conversion Table

These types of values can be specified in this field:

• data_set_name(member_name)

  The partitioned data set and member containing the character conversion table.

• data_set_name

  The partitioned data set that has the member BPXFX000 containing the character conversion table.

• (member_name)

  The member containing the character conversion table. It is assumed to be in a data set in the standard library concatenation. (The default data set is SYS1.LINKLIB.)

  Note: This field is ignored if the Convert option is not selected or if copying to another z/OS UNIX file.

For further information on the character conversion table refer to the description of the OGET command in the z/OS UNIX System Services Command Reference.