zfsadm define

Purpose

Defines a VSAM linear data set that can be formatted as a zFS aggregate.

Format

zfsadm define -aggregate name  [-dataclass SMS_data_class] 
                               [-managementclass SMS_management_class]
                               [-storageclass SMS_storage_class] [-catalog catalog]
                               [-system sysname] [-model model [catalog]] 
                               [-volumes volume [volume ...]]
                               [-cylinders primary [secondary]] [-kilobytes primary [secondary]]
                               [-megabytes primary [secondary]] [-records primary [secondary]]
                               [-tracks primary [secondary]] [-level] [-help]

Options

-aggregate name: Specifies the aggregate name of the aggregate to be defined. This will be the name of the VSAM linear data set that is defined. The aggregate name is not case-sensitive. It is translated to uppercase.
-catalog catalog: Specifies the name of the catalog in which the VSAM linear data set is to be defined.
-cylinders primary [secondary]: Specifies the primary and optionally, the secondary allocation size for the VSAM linear data set in cylinders. The VSAM linear data set must have a secondary allocation size specified, if you want to use dynamic grow. See Dynamically growing a compatibility mode aggregate for more information.
-dataclass SMS_data_class: Specifies the name of the data class to be used when the VSAM linear data set is defined.
-help: Prints the online help for this command. All other valid options specified with this option are ignored.
-kilobytes primary [secondary]: Specifies the primary and optionally, the secondary allocation size for the VSAM linear data set in kilobytes. The VSAM linear data set must have a secondary allocation size specified, if you want to use dynamic grow. See Dynamically growing a compatibility mode aggregate for additional information.
-level: Prints the level of the zfsadm command. This is useful when you are diagnosing a problem. Except for -help, all other valid options specified with -level are ignored.
-managementclass SMS_management_class: Specifies the name of the management class to be used when the VSAM linear data set is defined.
-megabytes primary [secondary]: Specifies the primary and optionally, the secondary allocation size for the VSAM linear data set in megabytes. The VSAM linear data set must have a secondary allocation size specified, if you want to use dynamic grow. See Dynamically growing a compatibility mode aggregate for additional information.
-model model [catalog]: Specifies the name of the model and optionally, the model entry’s catalog to be used when the VSAM linear data set is defined.
-records primary [secondary]: Specifies the primary and optionally, the secondary allocation size for the VSAM linear data set in records. When records is specified, the record size is assumed to be 4089 bytes. The VSAM linear data set must have a secondary allocation size specified, if you want to use dynamic grow. See Dynamically growing a compatibility mode aggregate for additional information.
-storageclass SMS_storage_class: Specifies the name of the storage class to be used when the VSAM linear data set is defined.
-system sysname: Specifies the name of the system that the define request will be sent to.
-tracks primary [secondary]: Specifies the primary and optionally, the secondary allocation size for the VSAM linear data set in tracks. The VSAM linear data set must have a secondary allocation size specified, if you want to use dynamic grow. See Dynamically growing a compatibility mode aggregate for additional information.
-volumes volume: Specifies the volume on which the VSAM linear data set can have space.

Usage

The zfsadm define command defines a VSAM linear data set. The VSAM linear data set is available to be formatted as a zFS aggregate. The command creates a DEFINE CLUSTER command string for a VSAM linear data set with SHAREOPTIONS(3) and passes it to the IDCAMS utility. If a failure occurs, the zfsadm define command can display additional messages from IDCAMS indicating the reason for the failure.

Privilege required

The issuer of the zfsadm define command requires sufficient authority to create the VSAM linear data set.

Examples

The following command defines a VSAM linear data set.

zfsadm define -aggregate omvs.prv.aggr001.lds0001 -volumes prv000 prv001 -cylinders 10 5

Related information

Commands:

zfsadm format