XMXD gate, INQUIRE_TRANDEF function

The INQUIRE_TRANDEF function of the XMXD gate is used to inquire upon a named transaction definition.

Input Parameters

APPLICATION_NAME
Optional Parameter
The 64-character buffer to receive the name of the application associated with the transaction.
INQ_TRANSACTION_ID
Transaction-id to inquire upon.
OPERATION_NAME
Optional Parameter
The 64-character buffer to receive the name of the operation associated with the transaction.
PLATFORM_NAME
Optional Parameter
The 64-character buffer to receive the name of the platform associated with the transaction.
TRANDEF_TOKEN
Transaction definition instance to unlock.
USE_DTRTRAN
Optional Parameter
If the named transaction-id or tpname cannot be found then indicates whether the DTRTRAN, if installed, should be used instead.
Values for the parameter are as follows:
  • NO
  • YES

Output Parameters

AVAILSTATUS
Optional Parameter
A 1-byte enumeration expressing the availability status of the application entry point.
Values for the parameter are:
  • AVAILABLE
  • UNAVAILABLE
  • NONE
REASON
The following values are returned when RESPONSE is DISASTER:
  • LOGIC_ERROR
The following values are returned when RESPONSE is EXCEPTION:
  • UNKNOWN_TRANSACTION_ID
The following values are returned when RESPONSE is INVALID:
  • INVALID_TOKEN
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
BREXIT
Optional Parameter
The name of the bridge exit defined by the BREXIT parameter of the transaction resource definition.
CMDSEC
Optional Parameter
Whether command security checking is active.
Values for the parameter are as follows:
  • NO
  • YES
CONFDATA
Optional Parameter
A binary value that indicates whether CICS should clear storage that is released from a task executing this transaction, to prevent other tasks accidentally viewing confidential data.
Values for the parameter are as follows:
  • NO
  • YES
DTIMEOUT
Optional Parameter
The deadlock timeout value for the transaction.
DTRTRAN
Optional Parameter
The name of the dynamic transaction routing transaction definition.
Values for the parameter are as follows:
  • NO
  • YES
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
ENTRYPOINT_BUNDLE_TOKEN
Optional Parameter
An 8-byte token that represents the bundle that defined the application entry point.
ENTRYPOINT_RES_TOKEN
Optional Parameter
An 8-byte token that represents the application entry point.
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
A binary value that indicates whether CICS wait to determine whether recoverable resources are to be backed out or committed if a failure occurs while the unit of work associated with the transaction is in an indoubt state.
Values for the parameter are as follows:
  • NO
  • YES
INDOUBT_WAIT_TIME
Optional Parameter
The length of time for which CICS should wait to for resolution if a failure occurs while the unit of work associated with the transaction is in an indoubt state.
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
MAJOR_VERSION
Optional Parameter
The fullword binary value that is the major version of the application associated with the transaction.
MICRO_VERSION
Optional Parameter
The fullword binary value that is the micro version of the application associated with the transaction.
MINOR_VERSION
Optional Parameter
The fullword binary value that is the minor version of the application associated with the transaction.
OTSTIMEOUT
Optional Parameter
The time for which an OTS transaction, created in an EJB environment executing under this CICS transaction, is allowed to execute before syncpoint.
PARTITIONSET
Optional Parameter
The partitionset defined for the transaction.
Values for the parameter are as follows:
  • KEEP
  • NAMED
  • NONE
  • OWN
PARTITIONSET_NAME
Optional Parameter
The name of the user defined partitionset used by the transaction.
PROFILE_NAME
Optional Parameter
Profile of transaction.
REMOTE
Optional Parameter
Whether the transaction is remote.
Values for the parameter are as follows:
  • NO
  • YES
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 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_ATTACH
Optional Parameter
Whether a system task will be attached using this transaction definition.
Values for the parameter are as follows:
  • NO
  • YES
SYSTEM_RUNAWAY
Optional Parameter
Whether the transaction uses the default system runaway limit.
Values for the parameter are as follows:
  • NO
  • YES
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
TCLASS
Optional Parameter
Whether the transaction belongs to a tclass.
TCLASS_NAME
Optional Parameter
The name of the tclass that the transaction belongs to.
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_PRIORITY
Optional Parameter
Transaction priority
TRAN_ROUTING_PROFILE
Optional Parameter
Profile to be used to route a remote transaction to a remote system.
TRANSACTION_ID
Optional Parameter
Transaction identifier
TWASIZE
Optional Parameter
Size of Transaction Work Area.


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