## zowe › zos-tso › start › address-space

Start a TSO address space, from which you will receive a token (a.k.a 'servlet-key') for further address space interaction (e.g. termination).

#### Usage

zowe zos-tso start address-space [options]

#### TSO ADDRESS SPACE OPTIONS

- `--account` | `-a` (string)

  - Your z/OS TSO/E accounting information.

- `--character-set` | `--cs` (string)

  - Character set for address space to convert messages and responses from UTF-8 to EBCDIC.

    Default value: 697

- `--code-page` | `--cp` (string)

  - Codepage value for TSO/E address space to convert messages and responses from UTF-8 to EBCDIC.

    Default value: 1047

- `--columns` | `--cols` (number)

  - The number of columns on a screen.

    Default value: 80

- `--logon-procedure` | `-l` (string)

  - The logon procedure to use when creating TSO procedures on your behalf.

    Default value: IZUFPROC

- `--region-size` | `--rs` (number)

  - Region size for the TSO/E address space.

    Default value: 4096

- `--rows` (number)

  - The number of rows on a screen.

    Default value: 24

#### Options

- `--servlet-key-only` | `--sko` (boolean)

  - Specify this option to print only the servlet key

#### 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.

- `--tso-profile` | `--tso-p` (string)

  - The name of a (tso) 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

- Start TSO/E address space:

  - `zowe zos-tso start address-space`

- Start TSO/E address space, and receive response in JSON format:

  - `zowe zos-tso start address-space --response-format-json`

- Start TSO/E address space, and print only the servlet key:

  - `zowe zos-tso start address-space --servlet-key-only`