RAD routine: getnumb.fc

A RAD routine used to establish the numbering sequence in sequential numbering. You can create simple identification numbers for database records, or complex numbers composed of prefixes and suffixes.

Routine

getnumb.fc

Parameters

The following parameters are valid for the getnumb.fc routine:

Name Data type Required Description
record record Yes The data record where the number will be placed. The value of this parameter must be $file.
name character Yes The sequential number Class (category) of the record that the Format Control record is attached. This value appears in the Class field of the Sequential Numbering File.
prompt character Yes Names the field in the data record where the sequential number appears.
text character No Defines the data type of the sequential number (number or string).
number1 number No

Defines the length of the sequential number. The subroutine prefixes as many zeroes to the number as necessary to match the required number of digits. Pass the val() RAD function to the number1 parameter. For example, a four-digit number has a value of val("4", 1).

Where:

The number 4 is the length of the number and the number 1 is the data type (a number representation).

string1 character No Defines the prefix. This is the identifying character string that appears before the number.
numbers,1 array
(numbers)
No Determines the reset point for the sequential number. When the value passed to the application is reached, the sequential number resets to the starting value.
numbers,2

array

(numbers)

No Establishes a new starting value for the sequential number when the reset point is reached.
numbers,3

array

(numbers)

No Sets the increment or decrement value. For example, if you want to increment by 2, displaying odd or even numbers only.
numbers,4

array

(numbers)

No Allows the user to increment or decrement the sequential number independent of the number file. Use this parameter to attach a specified number to your records without updating the number file.