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.