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.

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

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

  • Reject self-signed certificates.

    Default value: true

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

• --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" Copy

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

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

• 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" Copy

• 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" Copy

• 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" Copy