## zowe › ims › query › transaction

Query an IMS transaction.

#### Usage

zowe ims query transaction [name...] [options]

#### Positional Arguments

- `name...` (string)

  - Specifies the name of transaction(s) to query. You can use an * character as a wildcard to select multiple transactions.

#### Options

- `--attributes` | `--att` (array)

  - Specifies the transaction output fields to return.

    Allowed values: ALL, BMPTYPE, DEFN, DEFNTYPE, DOPT, FP, GLOBAL, IMSID, GPSB, LANG, LOCAL, MODEL, RESIDENT, SCHDTYPE, STATUS, TIMESTAMP, TRANSTAT, EXPORTNEEDED, DB, RTC, TRAN, WORK

- `--status` | `--st` (array)

  - Selects transactions that possess at least one of the specified transaction statuses.

    Allowed values: AFFIN, BAL, CONV, CPIC, DYN, IOPREV, LCK, NOTINIT, QERR, QSTP, SUSPEND, STOQ, STOSCHD, TRACE, USTO

- `--route` | `--rt` (array)

  - Specifies the routes to return.

- `--class` | `--cl` (array)

  - Selects transactions by the classes you specify.

- `--queue-count-operator` | `--qco` (array)

  - The compare operator used to select transactions based on queue count. Valid values: LT, LE, GT, GE, EQ or NE.

- `--queue-count-value` | `--qcv` (number)

  - The numeric value used with 'queue_count_operator' to select transactions based on queue count.

- `--conversation-attributes` | `--ca` (string)

  - Selects transactions by the conversational attributes you specify.

- `--fast-path-options` | `--fpo` (string)

  - Selects transactions by the Fast Path options you specify.

- `--remote-option-specified` | `--ros` (string)

  - Selects transactions by the remote option you specify.

- `--response-mode-option-specified` | `--rmos` (string)

  - Selects transactions by the response mode option you specify.

#### IMS Connection Options

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

  - The IMS Operations API server host name.

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

  - The IMS Operations API server port.

- `--ims-connect-host` | `--ich` (string)

  - The hostname of your instance of IMS Connect. This is typically the hostname of the mainframe LPAR where IMS Connect is running.

- `--ims-connect-port` | `--icp` (number)

  - The port of your instance of IMS Connect. This port can be found in your IMS Connect configuration file on the mainframe.

- `--plex` | `-x` (string)

  - The name of the IMS plex.

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

  - The web server user name where the IMS Operations API resides.

- `--password` | `--pass` (string)

  - The web server user password where the IMS Operations API resides.

- `--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)

  - Specifies protocol (http or https).

    Default value: https
    Allowed values: http, https

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

  - Reject self-signed certificates.

    Default value: true

#### Profile Options

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

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

#### Response Format Options

- `--response-format-filter` | `--rff` (array)

  - Filter (include) fields in the response. Accepts an array of field/property names to include in the output response. You can filter JSON objects properties OR table columns/fields. In addition, you can use this option in conjunction with '--response-format-type' to reduce the output of a command to a single field/property or a list of a single field/property.

- `--response-format-type` | `--rft` (string)

  - The command response output format type. Must be one of the following:

    table: Formats output data as a table. Use this option when the output data is an array of homogeneous JSON objects. Each property of the object will become a column in the table.

    list: Formats output data as a list of strings. Can be used on any data type (JSON objects/arrays) are stringified and a new line is added after each entry in an array.

    object: Formats output data as a list of prettified objects (or single object). Can be used in place of "table" to change from tabular output to a list of prettified objects.

    string: Formats output data as a string. JSON objects/arrays are stringified.

    Allowed values: table, list, object, string

- `--response-format-header` | `--rfh` (boolean)

  - If "--response-format-type table" is specified, include the column headers in the output.

#### Examples

- Query transaction information for transaction named TRN12:

  - `zowe ims query transaction "TRN12"`

- Query transaction information for transactions named TRAN1 and TRAN2:

  - `zowe ims query transaction "TRAN1 TRAN2"`

- Query transaction information for transactions starting with TRAN using the wild card character '*':

  - `zowe ims query transaction "TRAN*"`

- Query transaction information for all transactions (default is all):

  - `zowe ims query transaction`

- Query transaction information for all transactions specifying optional parameters:

  - `zowe ims query transaction --attributes "AFFIN TIMESTAMP" --status "NOTINIT" --route "IMS1 IMS2"`

- Query transaction information for all transactions specifying optional connection parameters:

  - `zowe ims query transaction --user "username" --pass "pass1234" --host "localhost" --port 8080 --ich "zos1" --icp 9999 --plex "PLEX1"`