zowe › zos-files › create › zos-file-system🖨️

Create a z/OS file system.

Usage

zowe zos-files create zos-file-system <fileSystemName> [options]

Positional Arguments

• fileSystemName (string)

  • The name of the file system to create.

Options

• --cyls-pri | --cp (number)

  • The number of primary cylinders to allocate for the ZFS.

    Default value: 10

• --cyls-sec | --cs (number)

  • The number of secondary cylinders to allocate for the ZFS.

    Default value: 2

• --data-class | --dc (string)

  • The SMS data class to use for the allocation

• --group | -g (string)

  • The z/OS group ID or GID for the group of the ZFS root directory.

• --management-class | --mc (string)

  • The SMS management class to use for the allocation

• --owner | -o (string)

  • The z/OS user ID or UID for the owner of the ZFS root directory.

• --perms | -p (number)

  • The permissions code for the ZFS root directory.

    Default value: 755

• --storage-class | --sc (string)

  • The SMS storage class to use for the allocation

• --timeout | -t (number)

  • The number of seconds to wait for the underlying "zfsadm format" command to complete. If this command times out, the ZFS may have been created but not formatted correctly.

    Default value: 20

• --volumes | -v (array)

  • The storage volumes on which to allocate the z/OS file system. Specify a single volume by its volume serial (VOLSER). To specify more than one volume, separate each VOLSER with a space. You must specify the volumes option when your cluster is not SMS-managed.

• --response-timeout | --rto (number)

  • The maximum amount of time in seconds the z/OSMF Files TSO servlet should run before returning a response. Any request exceeding this amount of time will be terminated and return an error. Allowed values: 5 - 600

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.

• --protocol (string)

  • The protocol used (HTTP or HTTPS)

    Default value: https
    Allowed values: http, https

• --cert-file (local file path)

  • The file path to a certificate file to use for authentication

• --cert-key-file (local file path)

  • The file path to a certificate key file to use for authentication

• --completion-timeout | --cto (number)

  • The amount in time, in seconds, a REST operation should wait to complete before timing out

• --establish-connection-timeout | --ecto (number)

  • The amount of time, in seconds, a REST operation should wait while connecting to the server before timing out

Profile Options

• --zosmf-profile | --zosmf-p (string)

  • The name of a (zosmf) profile to load for this command execution.

• --base-profile | --base-p (string)

  • The name of a (base) profile to load for this command execution.

Base Connection Options

• --token-type | --tt (string)

  • The type of token to get and use for the API. Omit this option to use the default token type, which is provided by 'zowe auth login'.

• --token-value | --tv (string)

  • The value of the token to pass to the API.

Examples

• Create a ZFS named "HLQ.MYNEW.ZFS" using default values of 755 permissions, 10 primary and 2 secondary cylinders allocated, and a timeout of 20 seconds:

  • zowe zos-files create zos-file-system HLQ.MYNEW.ZFS Copy

• Create a ZFS with 100 primary and 10 secondary cylinders allocated:

  • zowe zos-files create zos-file-system HLQ.MYNEW.ZFS --cyls-pri 100 --cyls-sec 10 Copy

• Create a ZFS specifying the volumes that should be used:

  • zowe zos-files create zos-file-system HLQ.MYNEW.ZFS --volumes ZFS001 ZFS002 Copy