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.
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"