z/OS V1R6.0 DFSMS Access Method Services for Catalogs

IMPORTdata set. If the define of an exported path is unsuccessful because a catalogentry with the same name already exists, the path on the portable data set isignored.Abbreviation: IEMPTYLOCK|UNLOCKcontrols the setting of the catalog lock attribute, and therefore checks access toa catalog. LOCK or UNLOCK can be specified only when entryname identifiesa catalog. If the LOCK|UNLOCK parameter is not specified, the catalog beingimported will be unlocked. Before you lock a catalog, review the informationon locking catalogs in z/OS DFSMS: Managing Catalogs. Locking a catalogmakes it inaccessible to all users without read authority to RACF FACILITYclass profile IGG.CATLOCK (including users sharing the catalog on othersystems).LOCKspecifies that the catalog being imported is to be locked. Nonexistingcatalogs are defined as locked. Existing unlocked catalogs are locked.Locking the catalog restricts catalog access to authorized personnel.Specification of this parameter requires read authority to the profile name,IGG.CATLOCK, with class type FACILITY. Catalogs are usually lockedonly during catalog recovery operations.UNLOCKspecifies that the catalog being imported is to be unlocked. Nonexistingcatalogs are defined as unlocked. Existing locked catalogs are unlocked. IfLOCK|UNLOCK is not specified, the catalog is unlocked.OBJECTS((entryname[FILE(ddname)][MANAGEMENTCLASS(class)][NEWNAME(newname)][STORAGECLASS(class)][VOLUMES(volser[ volser...])])[(entryname...)...])specifies the new or changed attributes for the cluster, alternate index, anyassociated paths, or user catalog to be imported. Access method servicesmatches each entryname you specify against the name of each object on theportable data set. When a match is found, the information specified byOBJECTS overrides the information on the portable data set.If you specify NEWNAME when importing a catalog, an error message isissued and processing ends.entrynamespecifies the name of the data component, index component, cluster,alternate index, path, or user catalog for which attributes are beingspecified. The entryname must appear on the portable data set; otherwise,the parameter list is ignored.Abbreviation: OBJFILE(ddname)specifies the name of a DD statement that identifies the volumes allocatedto the data and index components of a key-sequenced cluster, an alternateindex, or user catalog. This parameter is used when the data and indexcomponents reside on different device types. FILE can be coded twicewithin the OBJECTS parameter: once in the parameter set for the indexChapter 25. IMPORT 263