Chapter 23. EXPORT
The EXPORT command either exports a cluster or an alternate index or creates a backup copy of a catalog. An empty candidate volume cannot be exported. Access method services acknowledges and preserves the SMS classes during EXPORT.
Access method services does not use RLS. If an RLS keyword is specified on the
DD statement of a file to be opened by AMS, the keyword will be ignored and the file will be opened and accessed in non-RLS mode.
The syntax of the EXPORT command is:
Command
EXPORT
Parameters
entryname
{OUTFILE(
ddname)|OUTDATASET(entryname)}
[CIMODE|RECORDMODE]
[ERASE|NOERASE]
[INFILE(
ddname)]
[INHIBITSOURCE|NOINHIBITSOURCE]
[INHIBITTARGET|NOINHIBITTARGET]
[PURGE|NOPURGE]
[TEMPORARY|PERMANENT]
[RLSSOURCE(NO|YES|QUIESCE)]
EXPORT can be abbreviated: EXP
Restrictions:
You can export a KSDS with extended addressability to a system that does not support extended addressability if the data set is smaller than 4GB. If it is larger, the EXPORT and IMPORT commands appear to complete successfully, but when the data set tries to extend beyond 4GB, a message is issued. You can use
REPRO—specifically FROMKEY and TOKEY, or COUNT parameters—to reduce the data set to less than 4GB before using IMPORT. For the correct procedure to use when copying or moving data sets with pending recovery, see “Using VSAM
Record-Level Sharing” in z/OS DFSMS Using Data Sets.
EXPORT Parameters
Required Parameters
entryname
Names the cluster, alternate index, or user catalog to be exported. This parameter must be the first parameter following EXPORT. If entryname specifies an SMS-managed data set, the OUTDATASET must either be an SMS-managed data set, or a non-SMS-managed data set cataloged in the catalog determined
by the catalog search order (see “Order of Catalog Use” on page 9).
OUTFILE(ddname)|OUTDATASET(entryname)
Specifies the name of the DD statement or the data set that is to receive the data being exported.
Portable data sets loaded by EXPORT must be sequential data sets. VSAM is not a valid data set organization for portable data sets.
© Copyright IBM Corp. 1973, 2017
267
EXPORT
OUTFILE(ddname)
Specifies the name of the DD statement of the target data set.
Only the block size for the DCB parameter should be specified in the DD statement. The default for block size for EXPORT is 2048. Block size can be given in the DD statement to override this default and improve performance.
Exception:
For a nonlabeled tape, the LRECL should be specified if any of the input records are greater in size than the block size. Maximum record size is determined by the value specified with the maximum subparameter of the RECORDSIZE parameter of the DEFINE CLUSTER or DEFINE
ALTERNATEINDEX command when the data set was defined.
Abbreviation:
OFILE
OUTDATASET(entryname)
Specifies the name of the target data set. If OUTDATASET is specified, an attempt is made to dynamically allocate the target data set. The
characteristics of the target data set are described in “JCL DD Statement for a Target Data Set” on page 4.
If OUTDATASET specifies an SMS-managed data set, the exported data set must either be an SMS-managed data set, or a non-SMS-managed data set cataloged in the catalog determined by the catalog search order. For
information about this search order see “Order of Catalog Use” on page 9.
Abbreviation:
ODS
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.
268
z/OS DFSMS Access Method Services Commands
EXPORT
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: v The object's entry is in the master catalog.
Chapter 23. EXPORT
269
EXPORT
v 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
270
z/OS DFSMS Access Method Services Commands
EXPORT
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
Chapter 23. EXPORT
271
