## zowe › cics › define › transaction

Define a new transaction to CICS.

#### Usage

zowe cics define transaction <transactionName> <programName> <csdGroup> [options]

#### Positional Arguments

- `transactionName` (string)

  - The name of the new transaction to define. The maximum length of the transaction name is four characters.

- `programName` (string)

  - The name of the program that the transaction uses. The maximum length of the program name is eight characters.

- `csdGroup` (string)

  - The CICS system definition (CSD) Group for the new transaction that you want to define. The maximum length of the group name is eight characters.

#### Options

- `--region-name` (string)

  - The CICS region name to which to define the new transaction

- `--cics-plex` (string)

  - The name of the CICSPlex to which to define the new transaction

#### Cics Connection Options

- `--host` | `-H` (string)

  - The CICS server host name.

- `--port` | `-P` (number)

  - The CICS server port.

    Default value: 443

- `--user` | `-u` (string)

  - Mainframe (CICS) user name, which can be the same as your TSO login.

- `--password` | `--pw` (string)

  - Mainframe (CICS) password, which can be the same as your TSO password.

- `--reject-unauthorized` | `--ru` (boolean)

  - Reject self-signed certificates.

    Default value: true

- `--protocol` | `-o` (string)

  - Specifies CMCI protocol (http or https).

    Default value: https
    Allowed values: http, https

#### Profile Options

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

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

- `--cert-file` (local file path)

  - The file path to a certificate file to use for authentication.

    Note: The CLI does not support certificate files that require a password. For more information, search Troubleshooting PEM Certificates in Zowe Docs.

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

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

#### Examples

- Define a transaction named TRN1 for the program named PGM123 to the region named MYREGION in the CSD group MYGRP:

  - `zowe cics define transaction TRN1 PGM123 MYGRP --region-name MYREGION`