Download SELCOPYi Reference and User Guide

SELCOPY/i Command Reference
FSU
Copy/Remap Opts
Copy/Remap parameters are required for, and applicable only to, Copy and/or Remap processing.
Specification of OUTPUT defines the utility processing to be Unformatted File or Library Copy or Formatted File or Library
Copy. If an Output USING structure is also specified, then processing will be Formatted File or Library Remap.
If Copy/Remap parameters are not specified, File Search or Update processing is performed.
OUTPUT fileid | lib_dsn
Specifies fileid or lib_dsn, an output file or library to which all input records will be copied.
lib_dsn is a new or existing PDS/PDSE library without a member name specification. If specified, lib_dsn
indicates that Library Copy/Remap will occur so that input library members are copied to lib_dsn with their
member name unchanged. Non-library member input files are ignored.
fileid may be one of the following:
• An existing physical sequential (PS) data set.
• An existing VSAM data set.
• A new or existing member of an existing PDS/PDSE library.
• A new or existing HFS/ZFS file path.
If a CHANGE operation is specified and activated, then record data may be changed before it is written to the
output file.
The format of the output file should be compatible with input record data. e.g.
• If an output KSDS data set is specified, input records must be in key sequence, as defined by the output
file, and must not contain duplicate keys. If an input record does not satisfy these conditions, it will fail to
copy.
• Records will be truncated if the input record length exceeds the maximum allowed by the output file.
USING SDO|COBOL|PL1|ADATA out_struct
Specifies out_struct, the name of an SDE structure ( SDO), COBOL or PL1 copybook, COBOL or PL1 ADATA
file to be used to map output record data fields for use in Formatted File or Library Remap.
Formatted File Remap processing only occurs when an output file and input and output structures are supplied.
Therefore, an output structure is ignored if no input structure has been specified.
During the remap process, the following will occur:
1. Input records of record type not defined in the output structure are copied without field remap.
2. Output structure record types not defined in the input structure are redundant and so are ignored.
3. Record data in input fields are copied to output fields of the same name belonging to record types of the
same name.
4. The input field data will be reformatted to the data type of the output field and will be moved to the
output field's position within the record map.
5. Any input fields whose field names are not part of the output record structure, will not be included in the
output record.
6. Any output fields whose field names are not part of the input record structure are initialised to their
default values.
See the input structure USING field for description of output USING field sub-parameters and implementation of
a structure on record data.
APPEND
Applicable to File copy or remap only, specifies that output records are to be appended to existing data in the
output file.
If this option is not selected, then the existing records will be overwritten.
MEMBERDLM n
Applicable only when copying or remapping members from a PDS/PDSE library to a single output file e.g. an
HFS, VSAM or sequential dataset. This option causes a delimiter record to be written before the data belonging
to each member copied.
The value of n may be 0, 1 or 2 and indicates the format of the delimiter record to be inserted as described in the
table below.
Option
0
1
2
Delimiter Record Format
No delimiter record (Default).
"./ ADD NAME=<member>"
"*>>>>>> DSN=lib.name(member) <<<<<<*"
PAD | FILL | STRIP char
Applicable only to copy, indicates that:
2013-11-13 13:06:41
SELCOPY/i Reference and User Guide
454