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.

Function modules marked with "*" can only be used for the object types 2 and 3 and 5-8 (see illustration in number range object types).

  • 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 *
    This function module gets the elements which are assigned to a particular number range interval for a number range object. The elements found are passed in a table. Errors are returned as exceptions.
  • NUMBER_RANGE_ELEMENT_TEXT_LIST *
    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 *
    This function module gets information about groups and the associated group and element texts for a specified number range object. The information is put in a table. The table can be used to change the element assignment or the group text. The change request is to be passed to the function module NUMBER_RANGE_GROUP_UPDATE.
    Errors are returned as exceptions.
  • NUMBER_RANGE_GROUP_UPDATE *
    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 passed in an internal table and are copied into the local memory of the function group.
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 writing the changes to the database.
To copy the contents of local memory to the database, call the 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 passed 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 of local memory to the database, call the 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 put in a table structure, which must be declared like the table structure INROI.
  • NUMBER_RANGE_SUBOBJECT_LIST (only 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
    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.