Data Section
Contents
DescriptionTextReturn
Code
The offending field
is returned in the
data section:
One of the fields specified had an
invalid value.
INVALID_VALUE
1012
data (param
<field label>)
End Transaction
The End Transaction message completes a read or write transaction. The behavior depends on whether
the active transaction was a read or write transaction. The end_txn command defines the End
Transaction message.
End Transaction Request
For a read transaction, the End Transaction request message informs the PDBA that it is done making
queries. There are no database commitment.
For a write transaction that had successful updates, the End Transaction request message causes the
database changes to be committed and sent to the RTDB. The new database level is returned in the
data section of the response. The updates are not committed to the PDB until the end_txn command
is received.
If none of the updates was successful, a NO_UPDATES code is returned, and the dblevel does not
change. If any one of the commands was successful, a SUCCESS code is returned, and the dblevel is
incremented. Note that the dblevel is incremented to the same value following a transaction with
successful updates regardless of whether all updates were successful or only one.
The dblevel indicates the database level of the destination after the database action has occurred. It is
incremented after every write transaction. The level is incremented by one after each successful write
transaction, regardless of how many commands are sent in the transaction or whether the commands
are creates or deletes. This value is used by the Service Module cards to check consistency with
the RTDB.
Request syntax :
end_txn([iid XXXXX])
End Transaction Response
The End Transaction response message signals that the database update is done. This response does
not imply anything about whether or not the updates have made it to the RTDB yet. If the response
contains the SUCCESS return code, then the update was successfully committed in the PDB. If any
failure response is returned, the database commit failed. The end_txn request causes the transaction
to end regardless of whether any updates were actually made to the PDB.
The return codes listed in Table 6: End Transaction Response Return Codes indicate the result of the End
Transaction request. See PDBI Message Error Codes for the recommended actions to help resolve the
error related return codes.
59
910-6022-001 Revision A, March 2011
PDBI Request/Response MessagesProvisioning Database Interface Manual
To Next Page
Loading...
