USXM gate, INIT_TRANSACTION_USER function
The INIT_TRANSACTION_USER function of the USXM gate initializes the transaction for the user characteristics identified by the PRINCIPAL_USER_TOKEN value.
Input Parameters
- PRINCIPAL_USER_TOKEN
- is the optional principal user token representing the characteristics of the principal user of the transaction.
- EDF_USER_TOKEN
- Optional Parameter
- is the optional EDF user token representing the characteristics of the EDF user of the transaction.
- SESSION_USER_TOKEN
- Optional Parameter
- is the optional session user token representing the characteristics of the session user of the transaction.
- XMAT_CALL
- Optional Parameter
- indicates whether the function is called while a transaction is being attached.
- Values for the parameter are:
- NO
- YES
Output Parameters
- REASON
- The following values are returned when RESPONSE is DISASTER:
- ABEND
- GETMAIN_FAILED
- LOOP
- The following values are returned when RESPONSE is EXCEPTION:
- INVALID_USER_TOKEN
- The following values are returned when RESPONSE is INVALID:
- INVALID_FORMAT
- INVALID_FUNCTION
- PRIORITY
- is the priority value, in the range 0 through 255 (where 255 is the highest priority), for the user with the token identified by the PRINCIPAL_USER_TOKEN value.
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- USDOM_TRANSACTION_TOKEN
- is the user token to be used for reference to user characteristics only. It is treated as the principal user token until the next ADD_TRANSACTION_USER call for the transaction.