Number Range and Group Read and Maintain
Services
Function group SNR1
The function modules in this group perform all number range, number range interval and group read and maintenance database accesses.
●
NUMBER_RANGE_ENQUEUE
With this function module, you lock the number range object which is to be
maintained, and its groups and intervals, for access by other users. Lock
errors are returned as exceptions.
●
NUMBER_RANGE_DEQUEUE
With this function module, you unlock the number range object which has been
maintained.
●
NUMBER_RANGE_ELEMENT_LIST (object types 2, 3 and 5 to 8)
This function module gets the elements which are assigned to a particular
number range interval for a number range object. The elements found are
transferred to a table. Errors are returned as exceptions.
●
NUMBER_RANGE_ELEMENT_TEXT_LIST (object types 2, 3 and 5 to 8)
With this function module you can find element texts in the specified language
for a given number range object. The texts are returned in a table. Execution
errors are returned as exceptions.
●
NUMBER_RANGE_GROUP_LIST (object types 2, 3 and 5 to 8)
This function module gets information about groups and the associated group
and element texts for a specified number range object. The information is
placed in a table. The table can be used to change the element assignment or
the group text. The change request should be transferred to function module
NUMBER_RANGE_GROUP_UPDATE.
Errors are returned as exceptions.
●
NUMBER_RANGE_GROUP_UPDATE (object types 2, 3 and 5 to 8)
With this function module, already assigned elements can be assigned to other
intervals, or the assignment can be withdrawn. Group texts can also be
maintained. All change requests are checked. Request errors are returned in an
error table.
The changes
are transferred to an internal table and are copied into the local memory of
the function group.
Before calling this function module, you have to lock the number range object
in question with NUMBER_RANGE_ENQUEUE, and unlock it again with
NUMBER_RANGE_DEQUEUE after writing the changes to the database.
To copy the contents of local memory to the database, call function module
NUMBER_RANGE_UPDATE_CLOSE.
●
NUMBER_RANGE_INTERVAL_LIST
This function module gets the existing intervals to a given number range
object, and puts them in a table. The table can be transferred to the function
module NUMBER_RANGE_INTERVAL_UPDATE to change intervals.
●
NUMBER_RANGE_INTERVAL_UPDATE
With this function module you maintain intervals for a given number range
object.
The changes are passed in an internal table, and are copied into local memory.
Before you call this function module, you must lock the number range object in
question with NUMBER_RANGE_ENQUEUE, and unlock it again with
NUMBER_RANGE_DEQUEUE, after the changes have been written to the database.
To copy the contents from the local memory to the database, call function
module NUMBER_RANGE_UPDATE_CLOSE.
●
NUMBER_RANGE_OBJECT_GET_INFO
This function module gets information for a given number range object. This
information is placed in a table structure, which must be declared like the
table structure INROI.
●
NUMBER_RANGE_SUBOBJECT_LIST (object types 4-8)
This function module gets the existing sub-objects of a given number range
object, and puts them in the table passed.
●
NUMBER_RANGE_SUBOBJ_GET_INFO (object types 4-8)
This function module gets information about the existing sub-objects of a
given number range object. This information is put in a table structure, which
must be declared like the table structure INROI.
●
NUMBER_RANGE_UPDATE_CLOSE
With this function module you write changes which have been made to local
memory to the database, with NUMBER_RANGE_GROUP_UPDATE and
NUMBER_RANGE_INTERVAL_UPDATE. After calling this function module, you should
unlock the changed number range object.
●
NUMBER_RANGE_UPDATE_INIT
With this function module, you can initialize local memory if you want to
discard the changes which have not yet been copied to the database.