Amount Node

The amount node requires several fields be set appropriately before it attempts a lookup in the amount table.

If ibmIntAmountPrefix or ibmNprAmount have not been set or ibmNprValidAmount is false, the lookup is not attempted. Normally, the ibmNprAmount field would come from the client application, and ibmIntAmountPrefix would come from an upstream payment validation rule node table lookup. The ibmNprValidAmount field is set to false when a prior node lookup for a record ID was invalid or comes in that way from the client.

When the amount table record is successfully located and the ibmNprRecordId value has changed, a lookup in the record ID validation table is performed and the fields are validated according to the record ID validation node (see Record ID Validation).

Table Record Layout

The amount node table record layout is shown in Table 1.
Table 1. Amount Node Table Record Layout
Field Type Field Name Data Type Length Notes
Key ibmIntAmountPrefix byte 2  
Start Key ibmIntAmountLow char 10  
End Key ibmIntAmountHigh char 10  
Payload ibmNprRecordType byte 2  
ibmNprControlDoc char 1  
ibmNprRecordId byte 2 Used as one of the keys in the record ID validation table
ibmNprCredit char 1  
ibmIntEndorseId byte 2 Endorse table key
ibmIntAmountPrefix byte 2 Amount table key
ibmIntPcPrefix byte 2 Process Control table key
ibmIntAccountPrefix byte 2 Account table key
ibmIntField4Prefix byte 2 Field 4 table key
ibmIntEpcPrefix byte 2 Extended process code table key
ibmIntAuxPrefix byte 2 AuxOnUs table key

Fields that can Change

The amount node fields that can change are:
Table 2. Amount Node Fields that can Change
Field Name Data Type Length
ibmNprRecordId byte 2
ibmNprValidationError byte 1
ibmNprValidAmount byte 1
ibmNprValidPc byte 1
ibmNprValidAccount byte 1
ibmNprValidField4 byte 1
ibmNprValidRT byte 1
ibmNprValidExtProcCode byte 1
ibmNprValidAuxOnUs byte 1

Results

The amount node results are:
Table 3. Amount Node Results
If Condition Results Notes
ibmIntAmountPrefix Not set SUCCESS Without doing the lookup
ibmNprValidAmount false FAILURE Without doing the lookup
ibmNprAmount Not set SUCCESS Without doing the lookup
Lookup Fails FAILURE  
Lookup Succeeds SUCCESS  
Validation Succeeds/Fails SUCCESS  

Initialize

Not applicable

Process

The amount node does the following in sequence:
  1. Checks that the ibmIntAmountPrefix field has been set. If it is not present, sets the node’s response to success and goes to step 10.
  2. Checks the value of the ibmNprValidAmount field. If it is false, sets the node’s response to failure and goes to step 10.
  3. Checks that the ibmNprAmount field has a value in it. If it is not present, sets the node’s response to success and goes to step 10.
  4. Saves a copy of the ibmNprRecordId value.
  5. If the user exit is present, calls its preProcess routine.
  6. Performs the lookup in the amount table.
  7. If the record file is not found, sets the node’s response to failure and goes to step 10.
  8. If the record file is found, reads the payload fields into DecisionRequest and sets the node’s response to success.
  9. Checks if the ibmNprRecordId record was modified from the table lookup. If it was, it continues with the validate the payment field operation (see Validating the Payment Fields Operation ).
  10. If the user exit is present, calls its buildClientResponse routine.
  11. Returns to the workflow controller.