Updating transactions and transaction descriptors dynamically

Use the type-2 command UPDATE TRAN to dynamically update the definition of a transaction. Use the type-2 command UPDATE TRANDESC to update a transaction descriptor.

The TRAN and TRANDESC parameters of the UPDATE command are valid only in DB/DC and DCCTL systems.

If DRD is not enabled, you cannot use the UPDATE command to update definitional attributes. You can, however, use the UPDATE command when DRD is not enabled to control the locking, tracing, queuing, and scheduling of transactions.

In a local queues environment, you cannot update the definitional attributes of a transaction if there are queued messages for the transaction being updated. In a shared queues environment, the UPDATE TRAN command updates the definitional attributes of a transaction, even if there are messages queued for the transaction on the shared queue.

You must be careful when updating the definitional attributes of a transaction to set attributes consistently across all IMSs in a shared queues group. Updating a transaction does not remove queued messages that are associated with the transaction from the queue. Also, queued messages are not automatically updated to be consistent with the changes made to associated transactions. Inconsistencies between queued messages and updated transactions can cause problems. In a sysplex environment with multiple IMS systems, an update might succeed on some IMS systems and fail on others.

If a transaction is in use or has work in progress, the UPDATE TRAN command fails if you are modifying any of the following attributes of the transaction definition:

  • AOCMD
  • CMTMODE
  • CONV
  • DCLWA
  • DIRROUTE
  • EDITRTN
  • EDITUC
  • EMHBSZ
  • EXPRTIME
  • FP
  • INQ
  • MSGTYPE
  • MSNAME
  • PGM
  • PLCTTIME
  • RECOVER
  • REMOTE
  • RESP
  • SERIAL
  • SIDL
  • SIDR
  • SPASZ
  • SPATRUNC
  • TRANSTAT
  • WFI

If you use the UPDATE TRAN command to change any of the following attributes in the definition of a transaction that has a MODBLKS definition type, the definition type of the transaction changes to UPDATE, as displayed by the QUERY TRAN command:

  • AOCMD
  • CMTMODE
  • CONV
  • DCLWA
  • DIRROUTE
  • EDITRTN
  • EDITUC
  • EMHBSZ
  • FP
  • INQ
  • MSGTYPE
  • MSNAME
  • PGM
  • RECOVER
  • RESP
  • SERIAL
  • SIDL
  • SIDR
  • SPASZ
  • SPATRUNC
  • WFI