Copying without a template
When you are copying data sets and do not use a template, all data in an input data set record is copied to the output data set.
You can limit the number of records selected by using the Start key, Skip count, and Copy count fields on the Copy Utility (option 3.3) panel. For example, you can specify the number of records to be copied.
If you are not using a template for your copy, use the Copy Utility panel (see Copy Utility: “From” panel) as follows:
- From the Primary Option Menu panel, select option 3.3 to display the Copy Utility panel.
- Perform either of these actions
- Specify the data set that contains the data you want to copy, using a combination of the Data set name, Member, and Volume serial entry fields as appropriate.
- To select a range of members based on selection criteria, specify
the data set name or name pattern for a PDS(E) data set, optionally
the member name or pattern, and select the Advanced member selection option.
Note: If you enter details in the Member field and select the Advanced member selection option, File Manager populates the Member name field on the subsequent Advanced Member Selection panel with the same value.
- Set your record-level selection, using the following entry fields
on the Copy
Utility panel:
- Start key
- If required, specify a Start key for the data (VSAM only). Copying starts at the first record with a key or slot number greater than or equal to the specified value. If the key contains lowercase characters, blanks, or commas, enclose it in quotation marks. Keys may also be in hexadecimal format (e.g. X'0102').
- Skip count
- If required, specify a Skip Count for the data. Copying starts after skipping the number of records specified in the field.
- Include
- If required, specify the number of physical records that to be included in a repeating sample from a data set. Both Include and Repeat Skip fields must have non-zero values for sampling to take effect.
- Repeat skip
- If required, specify the number of physical records to be skipped in a repeating sample from a data set. Both Include and Repeat Skip fields must have non-zero values for sampling to take effect.
- Copy count
- Specify the number of records to be copied. Enter ALL to copy all records.
Note: The Start key and Skip count fields are mutually exclusive. - Select 2. None in the Copybook/template usage field.
Note: When this field is set to None, data in the Copybook or Template Data set name and Member fields is ignored.
- Select the processing options that you want:
- Batch execution
- Select this option when you want to generate the JCL needed to run the function in batch. The generated JCL is displayed in an Edit session.
- Use proc
- Select this option when you want to run a REXX procedure or DFSORT
statements in conjunction with your copy action, and then specify
the procedure name in the adjacent field.
To create a temporary procedure for one-time use enter an asterisk (*). File Manager displays an Edit panel that you can use to create a new procedure.
To use an existing procedure, specify the name of the member containing the procedure you want to use. The member must belong to the PDS allocated to ddname FMNEXEC. You can enter the name of the member or a member name pattern (other than *). If you specify a pattern, the Member Selection panel for the PDS is displayed when you press Enter. You can then select the required member by entering an
S
in the Sel field. - Ignore length mismatch
- Select this option when you want to include records in the copy process that are shorter than the matching template structure length.
- Use I/O exit
- Select this option when you want to run a user I/O exit that processes
the “From” (input) data set in conjunction with the copy
action. If selected, specify the exit name in the adjacent field.
Note: This option is only available when File Manager is installed with the option USEIOX=ENABLE, and the Exit enabled field in the Set System Processing Options panel is set to YES. If a default is specified with either of those options, it is displayed in the field to the right of Use I/O exit.
Do not select this option if you plan to use the ISPF Packing option on the next panel.
- Skip member selection list
- Select this option when you have either used a generic name in the Member field or specified Advanced member selection, and want to copy all members that match the name or range of names, without further refining the member list. This option is ignored if errors are found whilst copying.
- Directory integrity
- Forces an override of the default PDS(E) member processing method
which allows for faster PDS directory access.
This option has significant performance impact. When selected, the members are processed in a way which allows concurrent directory updates as File Manager accesses the members using current directory information.
When not selected, the member processing is performed faster, but may be affected by PDS(E) directory updates, possibly causing I/O errors if the data set is updated concurrently.
- Report PDS record counts
- Select this option when you want the count of records for copied PDS(E) members to be displayed (online) or printed (batch).
- Press Enter. The Copy To panel is displayed.
- Type the “To” data set details. Use a combination
of the Data set name, Member, and Volume serial entry
fields (the volume serial is only required for data sets which are
not accessible via the system catalog) to specify the data set (and
PDS(E) member if appropriate) to which you want to copy the data.
If the output data set does not exist, File Manager displays the Allocation panels to help you create a new data set.
- Select the processing options for the Copy To panel:
- DISP
- Determines the disposition of the “To” (output) data
set. Specify OLD or MOD.
- 1. OLD
- Select this option when you want the copied records to be placed into the “To” data set, starting from the beginning of the data set and overwriting any existing records.
- 2. MOD
- Select this option when you want the copied records to be appended
to the end of an existing output data set. Note: You cannot append records to a PDS or PDSE member or to a packed sequential data set. You also cannot append packed records to a non-packed sequential data set. You must use the OLD option to replace these records.
Note: SMS might modify the allocation of new data sets on your system. For details, contact your SMS Administrator. - Replace members
- Select this option when you want to replace like-named members in an output partitioned data set.
- Use I/O exit
- Select this option when you want to run a user I/O exit that processes
the “To” (output) data set in conjunction with the copy
action. If selected, specify the exit name in the adjacent field.
If you specify an I/O exit, you cannot use the ISPF Packing option.
- ISPF Packing
- Provided that the output data set is a sequential, PDS or PDSE
file, an I/O exit routine is not used and the DISP is set to OLD,
select one of these options to control the copy behavior when processing
data that is in ISPF PACK format.
- 1. Asis
- Select this option when you want File Manager to write the output in the same format (packed or unpacked) as the input records. If the input data is packed, it is unpacked for the processing operation, and then written out in ISPF PACK format.
- 2. Pack
- Select this option when you want File Manager to write the output in ISPF PACK format, regardless of the format of the input records. If the input data is packed, it is unpacked for the processing operation, and then written out in the ISPF PACK format.
- 3. Unpack
- Select this option when you want File Manager to write the output in unpacked format, regardless of the format of the input records. If the input data is packed, it is unpacked for the processing operation, and then written out without the ISPF PACK format.
- 4. None
- Select this option when you do not want File Manager to check
for packed records or unpack records for processing. If the input
data is packed, any processing actions operate on the records in their
packed format.
This is the only option allowed when an I/O exit has been specified, when the Disposition is set to MOD or when the Copy To data set is not a sequential file or PDS(E) member.
- 5. Skip
- Select this option when you want to halt the copying or processing actions, if the input data is packed.
- Press Enter.
If you selected the Advanced member selection option, File Manager displays the Advanced Member Selection panel:
- Specify the selection criteria to select the members you want to copy and press Enter.
- If you have left the Member name field on the Advanced
Member Selection panel blank or have entered an asterisk (*) or a
mask, (and you did not select the Skip member name list on
the Copy From panel), File Manager displays the Member selection panel.
In this case, select the members you want to copy (either by typing
an
S
in the Cmd field, or with the SELECT primary command) and press Enter.
File Manager copies the selected data in the “From” data set to the “To” data set.
Care must be taken when attempting to combine the Use proc, Use I/O exit and ISPF Packing options. You cannot use an I/O exit and the ISPF Packing option at the same time. You can provide a procedure and use an I/O exit or the ISPF Packing option but you cannot include *Fastproc DFSORT statements in your procedure.
Related topics