XMXD gate, ADD_REPLACE_TRANDEF function
The ADD_REPLACE_TRANDEF function of the XMXD gate is used to install a transaction definition.
Input Parameters
- PROFILE_NAME
- The profile that is to be found.
- TRAN_PRIORITY
- Transaction priority.
- TRANSACTION_ID
- The transaction identifier to attach.
- ALIAS
- Optional Parameter
- Alternative name for transaction definition.
- BREXIT
- Optional Parameter
- The name of the default bridge exit to be associated with this transaction.
- CATALOGUED_EXTERNALS
- Optional Parameter
- Block of data specified as an alternative to these parameters when a transaction definition is being installed from the catalog.
- CMDSEC
- Optional Parameter
- Whether command security checking is active.
- Values for the parameter are as follows:
- NO
- YES
- CONFDATA
- Optional Parameter
- The value of the CONFDATA attribute specified in the TRANSACTION definition.
- Values for the parameter are as follows:
- NO
- YES
- DTIMEOUT
- Optional Parameter
- The deadlock timeout value for the transaction.
- DUMP
- Optional Parameter
- Whether transaction dumps are to be taken.
- Values for the parameter are as follows:
- NO
- YES
- DYNAMIC
- Optional Parameter
- Whether the transaction is defined to be dynamic.
- Values for the parameter are as follows:
- NO
- YES
- INDOUBT
- Optional Parameter
- The action to take if work performed by the transaction becomes indoubt.
- Values for the parameter are as follows:
- BACKOUT
- COMMIT
- INDOUBT_WAIT
- Optional Parameter
- Indicates whether an indoubt unit of work (UOW) is to wait, pending recovery from a failure that occurs after the UOW has entered the indoubt state.
- Values for the parameter are as follows:
- NO
- YES
- INDOUBT_WAIT_TIME
- Optional Parameter
- Indicates how long the transaction is to wait before taking an arbitrary decision about an indoubt unit of work.
- INITIAL_PROGRAM
- Optional Parameter
- Initial program of transaction.
- ISOLATE
- Optional Parameter
- Whether the transaction runs in its own subspace.
- Values for the parameter are as follows:
- NO
- YES
- LOCAL_QUEUING
- Optional Parameter
- Whether the transaction is eligible to queue locally when it is started on the remote system.
- Values for the parameter are as follows:
- NO
- YES
- OTSTIMEOUT
- Optional Parameter
- The value of the OTSTIMEOUT attribute in the transaction definition.
- PARTITIONSET
- Optional Parameter
- The partitionset defined for the transaction.
- PARTITIONSET_NAME
- Optional Parameter
- The name of the user defined partitionset used by the transaction.
- REMOTE_NAME
- Optional Parameter
- The name of a remote transaction on the remote system.
- REMOTE_SYSTEM
- Optional Parameter
- The system that a remote transaction is to be routed to.
- RESSEC
- Optional Parameter
- Whether resource security checking is active.
- Values for the parameter are as follows:
- NO
- YES
- RESTART
- Optional Parameter
- Whether the transaction is restartable.
- Values for the parameter are as follows:
- NO
- YES
- ROUTABLE_STATUS
- Optional Parameter
- Specifies whether, if the transaction is the subject of an eligible EXEC CICS START command, it will be routed using the enhanced routing method.
- Values for the parameter are as follows:
- NOTROUTABLE
- ROUTABLE
- RUNAWAY_LIMIT
- Optional Parameter
- The runaway limit associated with the transaction.
- SHUTDOWN
- Optional Parameter
- Whether the transaction can be run during shutdown.
- Values for the parameter are as follows:
- DISABLED
- ENABLED
- SPURGE
- Optional Parameter
- Whether the transaction is system-purgeable.
- Values for the parameter are as follows:
- NO
- YES
- STATUS
- Optional Parameter
- The status of the transaction.
- Values for the parameter are as follows:
- DISABLED
- ENABLED
- STORAGE_CLEAR
- Optional Parameter
- Whether task-lifetime storage is to be cleared before it is released by using a freemain request.
- Values for the parameter are as follows:
- NO
- YES
- STORAGE_FREEZE
- Optional Parameter
- Whether storage freeze is on for the transaction.
- Values for the parameter are as follows:
- NO
- YES
- SYSTEM_DEFINITION
- Optional Parameter
- A binary value that indicates whether the transaction is defined by the system.
- Values for the parameter are as follows:
- NO
- YES
- SYSTEM_RUNAWAY
- Optional Parameter
- Whether the transaction uses the default system runaway limit.
- TASKDATAKEY
- Optional Parameter
- The storage key that task-lifetime storage is allocated in.
- Values for the parameter are as follows:
- CICS
- USER
- TASKDATALOC
- Optional Parameter
- The location of task-lifetime storage.
- Values for the parameter are as follows:
- ANY
- BELOW
- TASKREQ
- Optional Parameter
- Alternative name for transaction definition so that it can be invoked by PF/PA key, light pen, etc.
- TCLASS
- Optional Parameter
- Whether the transaction belongs to a tclass.
- TCLASS_NAME
- Optional Parameter
- The name of the tclass.
- TPNAME
- Optional Parameter
- Alternative means of specifying the transaction identifier to attach.
- TPURGE
- Optional Parameter
- Whether the transaction can be purged after a terminal error.
- Values for the parameter are as follows:
- NO
- YES
- TRACE
- Optional Parameter
- The level of tracing associated with the transaction.
- Values for the parameter are as follows:
- SPECIAL
- STANDARD
- SUPPRESSED
- TRAN_ROUTING_PROFILE
- Optional Parameter
- Profile to be used to route a remote transaction to a remote system.
- TWASIZE
- Optional Parameter
- Size of Transaction Work Area.
- XTRANID
- Optional Parameter
- Alternative name for transaction definition originally specified in hexadecimal notation.
Output Parameters
- REASON
- The following values are returned when RESPONSE is DISASTER:
- LOGIC_ERROR
- The following values are returned when RESPONSE is EXCEPTION:
- ALIAS_INVALID
- RECOVERY_NOT_COMPLETE
- RUNAWAY_LIMIT_INVALID
- TASKREQ_INVALID
- TPNAME_INVALID
- TRANSACTION_ID_INVALID
- TWASIZE_INVALID
- XTRANID_INVALID
- The following values are returned when RESPONSE is INVALID:
- INITIAL_PROGRAM_EXPECTED
- PARTITIONSET_NAME_EXPECTED
- REMOTE_NAME_EXPECTED
- REMOTE_SYSTEM_EXPECTED
- RUNAWAY_LIMIT_EXPECTED
- TCLASS_NAME_EXPECTED
- TRAN_ROUTING_PROF_EXPECTED
- The values for the parameter are as follows:
- ALIAS_EXISTS_AS_PRIMARY
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- TRANDEF_TOKEN
- Optional Parameter
- The token representing the returned transaction definition.