Use the Copy utility function to copy
data from any supported resource to any other supported resource.
This page details the mapping of fields to batch parameters and
miscellaneous notes. For the full description of each parameter, refer
to the IBM
File Manager® Users Guide and Reference.
Basic Settings
Parameter mappings:
- Source System The system the resource is copied from,
this cannot be changed and will be the system the wizard was opened from in
the Systems Information View.
- Source Resource - DSNIN. You may specify a single
(optionally wildcarded) member here.
- Source Volume - VOLSERIN. Optional; volume serial number for a non-cataloged data set.
- Destination System The system the resource will be copied to;
all hosts from the Systems Information View are listed and the selection will be validated
upon pressing the Finish button. If the destination is different from the source system a remote copy
operation will be performed between the systems. Both systems must support Remote Services
and have the same SSL configuration in order to be valid.
- Destination Resource - DSNOUT. If this is a data set,
it will be automatically "allocated like" from the source resource if
the source resource is a catalogued data set of a type supported by the
Allocate utility function. If you wish to copy to a PDS, specify the
member here as well (e.g. USER.PDS(MEM1) ). If Source
Resource is a Message Queue and Destination Resource is a
non-existent data set, a data set with record format set to variable (V)
and record length set to 32756 (with other attributes left to SMS to define)
will be allocated. If this is a CICS TS resource, it will be automatically created. If it is
any other type of resource, it will not be automatically created.
- Destination Volume - VOLSEROUT. Optional; volume serial number for a new or non-cataloged destination data set.
Back to top
Copy Member Selection
This page will be skipped if the Source Resource
cannot have any members.
Parameter mappings:
- Member list - CPYMBR (if member renaming by list is
used or multiple members are specified) or MEMBER (if a single generic
mask was used)
- Name: from & to - If both from and to are
specified, MEMSTART and MEMEND will be used respectively. If from is
specified and to is left empty, the from value will be used as the
value to the MEMBER parameter. Specify * in the from or to field to
select all previous or all next entries (respectively).
- Created: from & to - CRESTART and/or CREEND
- Changed: from & to - CHGSTART and/or CHGEND
- User ID: from & to - If both from and to are
specified, UIDSTART and UIDEND will be used respectively. If from is
specified and to is left empty, the from value will be used as the
value to the USERID parameter. Specify * in the from or to field to
select all previous or all next entries (respectively).
- By list - CPYMBR
- By mask - MEMOUT
Back to top
Template Selection
Parameter mappings:
- Source Template - TCIN
- Source Field offsets - OFFSETIN
- Destination Template - TCOUT
- Destination Field offsets - OFFSETOUT
- Use this template's field mapping - Opposite of
CORRESP (when selected, CORRESP=NO, when unselected, CORRESP=YES)
Back to top
Additional Options
Parameter mappings:
- Skip records - POSITION
- VSAM Key - KEY
- Records to copy - NLRECS
- Overwrite existing records - DISP
- Ignore record length mismatches - IGNLEN
- Packing policy - PACK
- Member Copying Replace existing members - REPLACE
- Member Copying ISPF statistics - STATS=OFF, STATS=ON,
and STATS=FORCE (respectively)
Back to top
Advanced Options
Parameter mappings:
- Source adjust input - INRDW
- Source Binary record length - BINRECIN
- Source IO Exit - USEIOXIN (when checked) and
(optionally when IO exit specified in field) IOXIN
- Destination adjust input - OUTRDW
- Destination Binary record length - BINRECOUT
- Destination IO Exit - USEIOXOUT (when checked) and
(optionally when IO exit specified in field) IOXOUT
- Record Sampling Skip - SMPLSKIP
- Record Sampling Include - SMPLINCL
- Output in XML format - FORMAT=XML (only enabled when a source template is specified)
Back to top
Export Substitution Options
This page will only be shown when Output in XML format is checked.
Parameter mappings:
- Non-printable character handling
- Dot - NPRTCHAR='.'
- As is - NPRTCHAR=ASIS
- Hex - NPRTCHAR=HEX
- Nested Hex - NPRTCHAR=NESTHEX
- Skip - NPRTCHAR=SKIP
- Replacement - NPRTCHAR='replacing-character-1', where 'replacing-character-1' is the text entered in the text box.
- Special character handling
- Underscore - SPECCHAR='_'
- Escape - SPECCHAR=ESCAPE
- Hex - SPECCHAR=HEX
- Nested Hex - SPECCHAR=NESTHEX
- CDATA - SPECCHAR=CDATA
- Replacement - SPECCHAR='replacing-character-2', where 'replacing-character-2' is the text entered in the text box.
- Invalid data handling
- Asterisk - INVDATA='*'
- Hex - INVDATA=HEX
- Skip - INVDATA=SKIP
- Replacement - INVDATA='replacing-character-3', where 'replacing-character-3' is the text entered in the text box.
Back to top
Export Miscellaneous Options
This page will only be shown when Output in XML format is checked.
Parameter mappings:
- Indent amount - INDENT
- Include fillers (unnamed data elements) - FILLERS=YES
- Include data elements redefining other data elements - REDEFINES=YES
- Convert output to Unicode - UNICODE=YES
- Cut output record linesplits independently of external formatting - LINESPLIT=YES
Back to top