Numeric routine

The Numeric routine contains several functions which allow you to return whole or decimal numbers in order to use them as settings in one or more Job components.

You can access the numeric routine functions by double-clicking the Numeric node under the system routines folder in the Repository tree view. The Numeric routine contains several functions, notably sequence, random and convertImpliedDecimalFormat.

Functions of the Numeric routine
Function	Description	Syntax
sequence	Returns an incremental numeric ID.	Numeric.sequence("Parameter name", start value, increment value)
resetSequence	Creates a sequence if it doesn't exist and attributes a new start value.	Numeric.resetSequence (Sequence Identifier, start value)
removeSequence	Removes a sequence.	Numeric.removeSequence (Sequence Identifier)
random	Returns a random whole number between the maximum and minimum values.	Numeric.random(minimum start value, maximum end value)
convertImpliedDecimalFormat	Returns a decimal with the help of an implicit decimal model.	Numeric.convertImpliedDecimalFormat ("Target Format", value to be converted)

The three routines sequence, resetSequence, and removeSequence are closely related.

The sequence routine is used to create a sequence identifier, named s1 by default, in the Job. This sequence identifier is global in the Job.
The resetSequence routine can be used to initialize the value of the sequence identifier created by sequence routine.
The removeSequence routine is used to remove the sequence identifier from the global variable list in the Job.

Note: When using the tRunJob component, the sequence identifier is shared by the parent Job and all child Jobs across the whole JVM. You should use unique identifier if you do not want to use it globally.

Creating a Sequence

The sequence routine allows you to create automatically incremented IDs, using a tJava component:

System.out.println(Numeric.sequence("s1",1,1)); 
               System.out.println(Numeric.sequence("s1",1,1));

The routine generates and increments the ID automatically:

The result is 1 and then 2 in the Run view.

Converting an Implied Decimal

It is easy to use the convertImpliedDecimalFormat routine, along with a tJava component, for example:

System.out.println(Numeric.convertImpliedDecimalFormat("9V99","123"));

The routine automatically converts the value entered as a parameter according to the format of the implied decimal provided:

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!

Leave your feedback here