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

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 Copy

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

  • zowe zos-tso start address-space --rfj Copy

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

  • zowe zos-tso start address-space --sko Copy