## zowe › ims › update › transaction

Update an IMS transaction.

#### Usage

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

#### Positional Arguments

- `name...` (string)

  - The name of the transaction(s) to update. The maximum length of a transaction name is eight characters.

#### Options

- `--aoi-cmd` | `--aocmd` (string)

  - Specifies the AOI option that you want to change (N, CMD, TRAN, Y).

    Allowed values: N, CMD, TRAN, Y

- `--class` | `-c` (array)

  - Selects the transactions associated with the specified class or classes to be updated.

- `--commit-mode` | `--cmtmode` (string)

  - Specifies when database updates and non-express output messages are committed (SNGL, MULT).

    Allowed values: SINGLE, MODE

- `--conversation` | `--conv` (string)

  - Specifies the conversation option (N or Y).

    Allowed values: N, Y

- `--current-priority` | `--cpri` (number)

  - Specifies a new value for the current priority of a transaction.

- `--directed-routing` | `--dirroute` (string)

  - Specifies the MSC directed routing option (N or Y).

    Allowed values: N, Y

- `--edit-routine` | `--editrtn` (string)

  - Specifies the 1- to 8-character name of your transaction input edit routine that edits messages before the program receives the message.

- `--edit-uppercase` | `--edituc` (string)

  - Specifies the edit to uppercase option (N or Y).

    Allowed values: N, Y

- `--emh-buffer-size` | `--emhbsz` (number)

  - Specifies the EMH buffer size required to run the Fast Path transaction.

- `--expiration-time` | `--exprtime` (number)

  - Specifies the elapsed time in seconds that IMS can use to cancel the input transaction.

- `--fast-path` | `--fp` (string)

  - Specifies the Fast Path option (E, N, P).

    Allowed values: E, N, P

- `--inquiry` | `--inq` (string)

  - Specifies the inquiry option (N or Y).

    Allowed values: N, Y

- `--limit-count` | `--lct` (number)

  - Specifies the limit count.

- `--limit-priority` | `--lpri` (number)

  - Specifies the limit priority.

- `--lock` | `-l` (string)

  - Specifies that the LOCK status is to be set on or off. Cannot be specified with any other SET attribute(ON or OFF).

    Allowed values: ON, OFF

- `--log-write-ahead` | `--dclwa` (string)

  - Specifies the log write-ahead option (N or Y).

    Allowed values: N, Y

- `--maximum-regions` | `--maxrgn` (number)

  - Specifies a new value for the maximum number of regions that can be simultaneously scheduled for a given transaction.

- `--message-type` | `--msgtype` (string)

  - Specifies the message type (single segment or multiple segment) (MULTSEG or SNGLSEG).

    Allowed values: MULTSEG, SNGLSEG

- `--msname` | `--mn` (string)

  - Specifies the one- to eight-character name of the logical link path in a multiple IMS system configuration (MSC).

- `--normal-scheduling-priority` | `--npri` (number)

  - Specifies the normal scheduling priority.

- `--option` | `-o` (string)

  - Specifies functions to be performed along with the command (AFFIN or ALLRSP).

    Allowed values: ALLRSP

- `--parallel-processing-limit` | `--parlim` (number)

  - Specifies the parallel processing limit count.

- `--program` | `--pgm` (string)

  - Specifies the name of the application program associated with the transaction.

- `--processing-limit-count` | `--plct` (number)

  - Specifies the processing limit count.

- `--processing-limit-count-time` | `--plcttime` (number)

  - Specifies the processing limit count time.

- `--recover` | `-r` (string)

  - Specifies the recovery option (N or Y).

    Allowed values: N, Y

- `--remote` | `--re` (string)

  - Specifies the remote option (N or Y).

    Allowed values: N, Y

- `--response-mode` | `--resp` (string)

  - Specifies the response mode option (N or Y).

    Allowed values: N, Y

- `--route` | `--rte` (array)

  - Specifies the region(s) to route the command.

- `--segment-number` | `--segno` (number)

  - Specifies the segment number.

- `--segment-size` | `--segsz` (number)

  - Specifies the segment size.

- `--serial` | `--sr` (string)

  - Specifies the serial option (N or Y).

    Allowed values: N, Y

- `--set-class` | `--sc` (number)

  - Specifies the transaction class, which is an attribute used to select a transaction for scheduling.

- `--system-identification-local` | `--sidl` (number)

  - Specifies the system identification (SYSID) of the local system in a multiple-IMS system (MSC) configuration.

- `--system-identification-remote` | `--sidr` (number)

  - Specifies the system identification (SYSID) of the remote system in a multiple-IMS system (MSC) configuration.

- `--scratchpad-area-size` | `--spasz` (number)

  - Specifies the scratchpad area (SPA) size, in bytes, for a conversational transaction. The value can be a number from 16 and 32767.

- `--scratchpad-area-truncation` | `--spatrunc` (string)

  - Specifies the scratchpad area (SPA) truncation option of a conversational transaction (S or R).

    Allowed values: S, R

- `--transaction-level-stat` | `--transtat` (string)

  - Specifies whether transaction level statistics should be logged for message driven programs (N or Y).

    Allowed values: N, Y

- `--wait-for-input` | `--wfi` (string)

  - Specifies the wait-for input option (N or Y).

    Allowed values: N, Y

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

- Update a transaction named TRN1 to process exclusively as Fast Path:

  - `zowe ims update transaction "TRN1" --fp "E"`

- Unlock to allow scheduling all transactions beginning with TRN* and associated with class CLASSA:

  - `zowe ims update transaction "TRN*" --class "CLASSA" --lock "OFF"`

- Set response mode on for transaction named TRN2 and associated with classes CLASS1 and CLASS2:

  - `zowe ims update transaction "TRN2" --class "CLASS1 CLASS2" --resp "Y"`

- Update a transaction named TRN3 to process exclusively as Fast Path routing to control regions IMS1 and IMS2:

  - `zowe ims update transaction "TRN3" -fp "E" --route "IMS1 IMS2"`

- Associate PGM1 with transaction named TRN4 specifying optional connection parameters:

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