Rollback-Transaction
Description
This webject is used to rollback a transaction.
Syntax
<ie:webject name="Rollback-Transaction" type="ACT">
<ie:param name="CONNECTION_ATTEMPTS" data="attempts"/>
<ie:param name="CONNECTION_ATTEMPT_INTERVAL" data="interval"/>
<ie:param name="DBUSER" data="dbuser_name"/>
<ie:param name="INSTANCE" data="instance"/>
<ie:param name="PASSWD" data="dbpassword"/>
<ie:param name="SESSION_ID" data="$(<value>[]session_id[])"/>
</ie:webject>
<ie:param name="CONNECTION_ATTEMPTS" data="attempts"/>
<ie:param name="CONNECTION_ATTEMPT_INTERVAL" data="interval"/>
<ie:param name="DBUSER" data="dbuser_name"/>
<ie:param name="INSTANCE" data="instance"/>
<ie:param name="PASSWD" data="dbpassword"/>
<ie:param name="SESSION_ID" data="$(<value>[]session_id[])"/>
</ie:webject>
Parameters
|
Required
|
Select
|
Optional
|
|---|---|---|
|
INSTANCE
|
CONNECTION_ATTEMPTS
|
|
|
SESSION_ID
|
CONNECTION_ATTEMPT_INTERVAL
|
|
|
DBUSER
|
||
|
PASSWD
|
CONNECTION_ATTEMPTS
Defines the maximum number of times to attempt establishing a connection to an adapter before returning an error. The default value is 1. This parameter is optional.
If multiple INSTANCE parameter values are specified, the value of CONNECTION_ATTEMPTS defines the maximum number of times to iterate through the list of adapter instances.
CONNECTION_ATTEMPT_INTERVAL
Defines the amount of time, in seconds, to delay between connection attempts. The default value is 60 seconds. This parameter is optional.
If multiple INSTANCE parameter values are specified, the value of CONNECTION_ATTEMPT_INTERVAL defines the number of seconds to wait between the attempts to iterate through the entire list of adapter instances.
DBUSER
Specifies the username to use when authenticating to the SAP system. If this parameter is specified in this webject, the webject value takes precedence over any value specified in the credentials mapping settings or in the adapter LDAP entry. If this parameter is not specified here, it must be specified in the credentials mapping settings or in the adapter LDAP entry. For more information about credentials mapping, see the section Credentials Mapping. This parameter is optional.
INSTANCE
Specifies the name of the adapter that executes the webject. Adapter names are defined when the adapter is configured for use in your Info*Engine environment. This parameter is required.
PASSWD
Specifies the password to use when authenticating to the SAP system. If this parameter is specified in this webject, the webject value takes precedence over any value specified in the credentials mapping settings or in the adapter LDAP entry. If this parameter is not specified here, it must be specified in the credentials mapping settings or in the adapter LDAP entry. For more information about credentials mapping, see the section Credentials Mapping. This parameter is optional.
SESSION_ID
Specifies the identifier of the session in which the webject is executed. This parameter is required.
The user may specify a value for this webject parameter as shown below:
<ie:param name="SESSION_ID" data="$(<value>[]session_id[])"/>
The above syntax makes use of dynamic parameter value substitution, where <value> is the value provided by the user for the webject parameter GROUP_OUT in the Start-Transaction webject that was used to start the given transaction.
 |
If the GROUP_OUT parameter is not specified in the Start-Transaction webject, then the user needs to explicitly provide the value for SESSION_ID parameter.
|
Example
For examples that demonstrate the use of the Rollback-Transaction webject, please refer to the Transaction Management Example.