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

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

 From z/OS UNIX file:
   Name . . . : /u/mburns/cargs1.c

 To z/OS UNIX file, data set, or member:
   Name . . . .                                                      +
   Permissions  700  (Octal)

 Options
   /  Confirm copy to existing target
      Update permissions for existing target file
      Binary copy
      Convert

 Conversion Table                                                          



  F1=Help     F2=Split    F3=Exit     F4=Expand   F5=Rfind    F7=Up
  F8=Down     F9=Swap    F10=Left    F11=Right   F12=Cancel

This panel allows you to copy the data in a regular file to another z/OS UNIX file, a sequential data set, or a member of a partitioned data set.

The panel displays the path name of the file being copied.

These mandatory input fields are displayed on this panel:

Name

The destination where the data from the file will be copied. Any of these can be specified:

• The path name of a z/OS UNIX file.
• The name of a sequential data set.
• The names of an existing partitioned data set and member.

Permissions

When copying to a z/OS UNIX file, defines the permissions for that file. 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:

Confirm copy to existing target

When this option is selected and the target z/OS UNIX file, data set, or member exists, the Confirm Copy panel displays a warning that the data in the target will be overwritten if the copy proceeds.

In this situation, proceeding with the copy will cause the data in the target to be overwritten. Since this is an irrevocable process which may cause loss of valuable data, ISPF requires you to confirm you really want the copy to proceed. If you have made a mistake, the copy operation can be canceled using the CANCEL or EXIT commands.

Update permissions for existing target file

If this option is selected and the target of the copy is an existing z/OS UNIX file, the value specified in the Permissions field will be used to update the permissions for this file.

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.

Note: This option is ignored when copying to another z/OS UNIX file.

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.

Note: This option is ignored when copying to another z/OS UNIX file.

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.