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.


dfhs3_XMXDadd_replace_trandef.html | Timestamp icon Last updated: Monday, 5 June 2017