Previous topic |
Next topic |
Contents |
Contact z/OS |
Library |
PDF
zfsadm attach z/OS Distributed File Service zFS Administration SC23-6887-00 |
|
PurposeAttaches an aggregate to zFS without
mounting the file system.
Note: zfsadm aggrinfo displays
an attached compatibility mode aggregate as MULT because it is not
mounted.
Format
Options
UsageThe zfsadm attach command attaches zFS aggregates on this system. If the attach fails because log recovery is unsuccessful, you can run the ioefsutl salvage batch utility with the -verifyonly option on the aggregate to determine if there is an inconsistency. If so, use ioefsutl salvage to recover the aggregate and reissue the zfsadm attach command. The zfsadm lsaggr command can be used to display a current list of all aggregates that are attached on this sysplex with the zFS owning system indicated, or this system when -system is used. If the DASD volume containing the zFS aggregate being attached is read-only, you might receive message IOEZ00336I. This indicates that the zFS aggregate indicator cannot be set in the catalog (actually, in the VVDS on the volume). The zFS aggregate is successfully attached. DFSMSdss backup (DUMP) will not automatically quiesce and unquiesce the zFS aggregate because it cannot determine that the VSAM linear data set is a zFS aggregate. If the zFS aggregate can be attached with the DASD volume in read/write, the zFS aggregate indicator will be set. You can determine if the zFS aggregate indicator is set by using IDCAMS LISTCAT ALL against the zFS aggregate and looking for the zFS indicator in the output. Compatibility mode aggregates do not need to be separately attached because they are attached during MOUNT processing. However, if you want to issue a zfsadm command against a compatibility mode aggregate without mounting the aggregate, you can use the zfsadm attach command. You might attach an aggregate to delete a .bak file system that is contained in it. Privilege requiredThe issuer must have READ authority to the data set that contains the IOEFSPRM file and is required to be logged in as root or to have READ authority to the SUPERUSER.FILESYS.PFSCTL resource in the z/OS® UNIXPRIV class. If you are not using IOEFSPRM but instead, you are using parmlib (IOEPRMxx), the issuer is required to be logged in as root or to have READ authority to the SUPERUSER.FILESYS.PFSCTL resource in the z/OS UNIXPRIV class. ExamplesThe following command attaches an aggregate.
Figure 1 shows the same example
as a job that invokes zfsadm attach.
Figure 1. Job to
attach an aggregate
If you want to specify the R/O option, you must specify a leading slash. Otherwise, Language Environment® will treat the characters before the slash as Language Environment parameters. That is, you must use PARM=('/attach OMVS.PRV.AGGR001.LDS0001 -R/O'). Related informationCommands:
File
|
Copyright IBM Corporation 1990, 2014
|