When the CI line command is entered against a directory, the Copy Into z/OS® UNIX Directory panel is displayed.

                       Copy Into z/OS UNIX Directory
 Command ===>                                                             
                                                                More:     +
 Into z/OS UNIX directory:
   Name . . . : /u/mburns/abcdir1

 From partitioned data set:
   Name . . . . EXEC                                          

 Permissions    777
 Suffix . . . .                     

 Options
      Replace like-named files
      Update permissions for replaced files
   /  Selection list...
   /  Convert to lowercase
      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 members of a partitioned data set into regular files in a directory.

The panel displays the path name of the directory into which the members of the partitioned data set will be copied. These mandatory input fields are displayed on this panel:

Name

The name of an existing partitioned data set containing the members that will be copied as regular files into the selected directory.

Permissions

Defines the permissions for new regular files created when copying a partitioned data set member in the directory. When the option "Update permissions for replaced files" is selected, it also defines new permissions applied to a file replaced during the copy operation. Enter as three octal (range 0-7) digits. The first digit defines the access permission for the file owner. The second digit defines the access permission for any member of the file's group. The third digit defines the access permission for anyone else. See Table 1.

These optional input fields are available on this panel:

Suffix

This field allows you to specify a value that will be added to the end of the member name to form the file name of the regular file that is created or updated during the copy operation. The member name and suffix are separated by a period (.). Any leading periods specified in the suffix are ignored.

Replace like-named files

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 contents of the existing file will be overwritten with the data from the selected member. If this option is not selected, the copy of that member will not be performed.

Update permissions for replaced files

When this option is selected it causes existing files that are replaced by the copy operation to also have their permissions changed to the value specified in the Permissions field.

Selection List

If this option is selected, the Copy Into z/OS UNIX Directory - Selection List panel is displayed. This panel displays a list of the members in the partitioned data set that can be selected for copying into the directory. The list contains these fields:

S

An input field where you can enter S to indicate the associated member is to be copied into the directory.

Member

The name of the partitioned data set member that can be copied into the directory.

Filename

The name to be used for the regular file into which the data from the associated member will be copied. This is an input field, allowing you to change the file name to something other than the name assigned by ISPF. The field is scrollable and is 1023 bytes long. Use the EXPAND function key (F4) to display the entire field in a pop-up window.

Message

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

*COPIED

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

*REPL

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

*NO-REPL

The data from the member was not copied to the file in the directory because the file already existed and the Replace like-named files option was not selected on the Copy Into z/OS UNIX Directory panel.

*FAILED RC=xx

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

When you press Enter on this panel, the selected members will be copied to the directory. The Message field indicates the result of the copy operation for each member.

Convert to lowercase

When this option is selected it causes the member name to be converted to lowercase before it is used to generated the file name for the target regular file.

Binary copy

When this option is selected it indicates the members 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 members are 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.

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