zowe › zos-files › create › data-set-vsam
Create a VSAM cluster
Usage
zowe zos-files create data-set-vsam <dataSetName> [options]
Positional Arguments
dataSetName
(string)- The name of the dataset in which to create a VSAM cluster
Options
--data-class
|--dc
(string)- The SMS data class to use for the allocation
--data-set-organization
|--dso
(string)The data set organization.
Default value: INDEXED
Allowed values: INDEXED, IXD, LINEAR, LIN, NONINDEXED, NIXD, NUMBERED, NUMD, ZFS
--management-class
|--mc
(string)- The SMS management class to use for the allocation
--retain-for
|--rf
(number)- The number of days that the VSAM cluster will be retained on the system. You can delete the cluster at any time when neither retain-for nor retain-to is specified.
--retain-to
|--rt
(string)- The earliest date that a command without the PURGE parameter can delete an entry. Specify the expiration date in the form yyyyddd, where yyyy is a four-digit year (maximum value: 2155) and ddd is the three-digit day of the year from 001 through 365 (for non-leap years) or 366 (for leap years). You can delete the cluster at any time when neither retain-for nor retain-to is used. You cannot specify both the 'retain-to' and 'retain-for' options.
--secondary-space
|--ss
(number)- The number of items for the secondary space allocation (for example, 840). The type of item allocated is the same as the type used for the '--size' option. If you do not specify a secondary allocation, a value of ~10% of the primary allocation is used.
--show-attributes
|--pa
(boolean)- Show the full allocation attributes
--size
|--sz
(string)The primary size to allocate for the VSAM cluster. Specify size as the number of items to allocate (nItems). You specify the type of item by keyword.
Default value: 840KB
--storage-class
|--sc
(string)- The SMS storage class to use for the allocation
--volumes
|-v
(string)- The storage volumes on which to allocate a VSAM cluster. Specify a single volume by its volume serial (VOLSER). To specify more than one volume, enclose the option in double-quotes and separate each VOLSER with a space. You must specify the volumes option when your cluster is not SMS-managed.
Zosmf Connection Options
--host
|-H
(string)- The z/OSMF server host name.
--port
|-P
(number)The z/OSMF server port.
Default value: 443
--user
|-u
(string)- Mainframe (z/OSMF) user name, which can be the same as your TSO login.
--password
|--pass
|--pw
(string)- Mainframe (z/OSMF) password, which can be the same as your TSO password.
--reject-unauthorized
|--ru
(boolean)Reject self-signed certificates.
Default value: true
--base-path
|--bp
(string)- The base path for your API mediation layer instance. Specify this option to prepend the base path to all z/OSMF resources when making REST requests. Do not specify this option if you are not using an API mediation layer.
Profile Options
--zosmf-profile
|--zosmf-p
(string)- The name of a (zosmf) profile to load for this command execution.
Examples
Create a VSAM data set named "SOME.DATA.SET.NAME" using default values of INDEXED, 840 KB primary storage and 84 KB secondary storage:
zowe zos-files create data-set-vsam SOME.DATA.SET.NAME
Create a 5 MB LINEAR VSAM data set named "SOME.DATA.SET.NAME" with 1 MB of secondary space. Show the properties of the data set when it is created:
zowe zos-files create data-set-vsam SOME.DATA.SET.NAME --data-set-organization LINEAR --size 5MB --secondary-space 1MB --show-attributes
Create a VSAM data set named "SOME.DATA.SET.NAME", which is retained for 100 days:
zowe zos-files create data-set-vsam SOME.DATA.SET.NAME --retain-for 100