Optional Parameters
- CIMODE|RECORDMODE
- Specifies whether control interval processing (CIMODE) or logical
record processing (RECORDMODE) is to be used to export the records
of the data set cluster. RECORDMODE is the default for ESDS, KSDS,
and RRDS clusters. CIMODE
is the default for LDS clusters.
- CIMODE
- Specifies that the cluster
data records written to the portable data set are processed as one
VSAM control interval. You can use CIMODE processing to export data
sets more quickly. Each control interval is processed as one logical
record.
If control interval processing is used, the target data set's catalog entry will not have correct statistics. These statistics are correctly updated the first time the data set is opened for output.
When you use control interval processing to export an ESDS cluster that contains an alternate index, logical record processing is used, and a warning message is issued.
IMPORT will determine the type of processing (control interval or logical record) used by EXPORT to process the cluster data records, and use the same processing type for loading. Thus, a data set that was exported in control intervals is loaded in control intervals. Similarly, a data set exported in logical records is loaded by IMPORT as VSAM logical records.
The CIMODE portable data set created by the EXPORT command is not compatible with a CIMODE portable data set created on a VSE system. Therefore, any attempt to import an object exported on a VSE system with control interval processing support is not detected by IMPORT and gives unpredictable results.
During CIMODE processing, data set statistics, such as the number of logical records and the number of inserted records, are not maintained. Data set statistics are not maintained because VSAM cannot update logical record information when whole control intervals are processed. After recalling a data set, a LISTCAT might not show accurate freespace bytes, and a read against the VVR might show zero records although records do exist.
Abbreviation: CIM
- RECORDMODE
- Specifies
that cluster data records written to the portable data set are processed
as one VSAM logical record.
On a system without control interval processing support, RECORDMODE is the default.
For LDS clusters, the default is CIMODE.
Abbreviation: RECM
- ERASE|NOERASE
- Specify whether or not the components of the cluster or alternate
index to be exported are to be erased (that is, overwritten with binary
zeros). This parameter overrides whatever was specified when the object
was defined or last altered. This parameter can be specified only if the object is to be permanently exported (that is, deleted from the original system). It does not apply to catalogs that must be exported as TEMPORARY.
- ERASE
- Specifies
that the components are to be overwritten with binary zeros when the
cluster or alternate index is deleted. If ERASE is specified, the
volume that contains the data component must be mounted.
If the alternate index is protected by a RACF® generic or discrete profile, use RACF commands to specify an ERASE attribute as part of this profile so that the data component is automatically erased upon deletion.
Abbreviation: ERAS
- NOERASE
- specifies
that the components are not to be overwritten with binary zeros when
the cluster or alternate index is deleted.
NOERASE does not prevent the data component from being erased if it is protected by a RACF generic or discrete profile that specifies the ERASE attribute. You can use RACF commands to alter the ERASE attribute in a profile.
Abbreviation: NERAS
- INFILE(ddname)
- Specifies
the name of the DD statement that identifies the cluster, alternate
index, or catalog to be exported. If the cluster, alternate index,
or catalog has been defined with a maximum logical record length greater
than 32760 bytes, EXPORT processing ends with an error message, except
for EXPORT with control interval processing support. In addition to the DD statement for INFILE, one of the following conditions must be true:
- The object's entry is in the master catalog.
- The qualifiers in the object's name are the catalog's name or alias.
When INFILE and its DD statement are not specified for a to-be-exported object, an attempt is made to dynamically allocate the object with a disposition of OLD.
Abbreviation: IFILE
- INHIBITSOURCE|NOINHIBITSOURCE
- Specifies how the data records in the source data set (ALTERNATE
INDEX and CLUSTER) can be accessed after they have been imported to
another system. Use the ALTER command to alter this parameter.
- INHIBITSOURCE
- Specifies
that the original data records in the original system cannot be accessed
for any operation other than retrieval. Use it when the object is
to be temporarily exported. (A backup copy of the object is made,
and the object itself remains in the original system.)
If INHIBITSOURCE is specified when exporting a catalog, it is ignored and a warning message issued.
Abbreviation: INHS
- NOINHIBITSOURCE
- specifies
that the original data records in the original system can be accessed
for any kind of operation.
Abbreviation: NINHS
- INHIBITTARGET|NOINHIBITTARGET
- Specify whether or not the data records copied into the target
alternate index or cluster can be accessed for any operation other
than retrieval after they have been imported to another system. This
specification can be altered through the ALTER command.
- INHIBITTARGET
- specifies
that the target object cannot be accessed for any operation other
than retrieval after it has been imported into another system.
If INHIBITTARGET is specified when exporting a catalog, it is ignored and a warning message is issued.
Abbreviation: INHT
- NOINHIBITTARGET
- Specifies
that the target object can be accessed for any type of operation after
it has been imported into another system.
Abbreviation: NINHT
- PURGE|NOPURGE
- Specify whether or not the cluster or alternate index to be exported
is to be deleted from the original system regardless of the retention
period specified in a TO or FOR parameter when the object was defined.
This parameter can be specified only if the object is to be permanently exported, that is, deleted from the original system. Therefore, it does not apply to catalogs that must be exported as TEMPORARY.
- PURGE
- Specifies
that the object is to be deleted even if the retention period has
not expired.
Abbreviation: PRG
- NOPURGE
- Specifies
that the object is not to be deleted unless the retention period has
expired.
Abbreviation: NPRG
- TEMPORARY|PERMANENT
- Specify whether or not the cluster, alternate index, or catalog
to be exported is to be deleted from the original system.
- TEMPORARY
- Specifies
that the cluster, alternate index, or catalog is not to be deleted
from the original system. The object in the original system is marked
as temporary to indicate that another copy exists and that the original
copy can be replaced.
To replace the original copy, a portable copy created by an EXPORT command must be imported to the original system. The IMPORT command deletes the original copy, defines the new object, and copies the data from the portable copy into the newly defined object. Portable data sets being loaded by EXPORT must be sequential data sets. VSAM is not a valid data set organization for portable data sets.
Catalogs are exported as TEMPORARY.
Be sure to properly protect the file of the temporary object if you want to deny unauthorized access to that file.
Abbreviation: TEMP
- PERMANENT
- Specifies
that the cluster or alternate index is to be deleted from the original
system. Its storage space is freed. If its retention period has not
yet expired, you must also code PURGE.
Abbreviation: PERM
If PERMANENT is specified when exporting a catalog, the catalog will still be exported as TEMPORARY, and a message is issued.
- RLSSOURCE(NO|YES|QUIESCE)
- Specifies how the source dataset will be open.
- NO
- indicates the source data set will be opened using Non-Shared
Resources (NSR).
Abbreviation: N
Default: NO
- YES
- indicates that the source data set will be opened using Record
Level Sharing (RLS) and the data set will have consistent read integrity.
Abbreviation: Y
- QUIESCE
- indicates that the source data set is quiesced before AMS calls
VSAM for RLS OPEN. VSAM switches the data set out of RLS mode and
ultimately open it in nonRLS mode.
Abbreviation: Q
Abbreviation: RLSS