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"