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.


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