Interface for Application Development for Maintenance of Intervals and Groups

Function Group SNR1

The function modules of this group perform all read and maintenance accesses to intervals and groups in the database.

• NUMBER_RANGE_ENQUEUE

  This function module locks the number range object to be maintained, with its groups and intervals, for access by other users. Lock errors are returned as exceptions.

• NUMBER_RANGE_DEQUEUE

  This function module unlocks the maintained number range object.

• NUMBER_RANGE_ELEMENT_LIST (object types 2, 3, and 5 to 8)

  This function module gets the elements assigned to a specified interval for a number range object. The elements are passed in a table. Errors are returned as exceptions.

• NUMBER_RANGE_ELEMENT_TEXT_LIST (object types 2, 3, and 5 to 8)

  This function module gets texts of elements in the specified language, for a specified number range object. The texts are passed in a table. 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 their group and element texts, for a specified number range object. The information is put in a table. The table can be used to change element assignments or group texts. The change request must be passed to the function module NUMBER_RANGE_GROUP_UPDATE.

  Errors are returned as exceptions.

• NUMBER_RANGE_GROUP_UPDATE (only for object types 2, 3, and 5 to 8)

  This function module changes the assignments of elements to intervals, or deassigns them. It also maintains group texts. All change requests are checked. Incorrect assignments are returned in an error table.

  The changes are passed in an internal table and put in the local function group memory.

  You must lock the number range object with NUMBER_RANGE_ENQUEUE before calling this function module, and unlock it again with NUMBER_RANGE_DEQUEUE once the changes have been written to the database. Call the function module NUMBER_RANGE_UPDATE_CLOSE to put the contents of the local memory in the database.

• NUMBER_RANGE_INTERVAL_LIST

  This function module puts the intervals for a specified number range object in a table. The table can be passed to the function module NUMBER_RANGE_INTERVAL_UPDATE for changes to intervals.

• NUMBER_RANGE_INTERVAL_UPDATE

  This function module maintains intervals for a number range object. The changes are passed in an internal table and put in the local memory. You must lock the number range object with NUMBER_RANGE_ENQUEUE before calling this function module, and unlock it again with NUMBER_RANGE_DEQUEUE once the changes have been written to the database. Call the function module NUMBER_RANGE_UPDATE_CLOSE to put the contents of the local memory in the database.

• NUMBER_RANGE_OBJECT_GET_INFO

  This function module gets information about a number range object. This information is put in a table with structure INROI.

• NUMBER_RANGE_SUBOBJECT_LIST (object types 4 to 8)

  This function module puts the subobjects for a specified number range object in the table passed.

• NUMBER_RANGE_SUBOBJ_GET_INFO (object types 4 to 8)

  This function module gets information about the subobjects of a specified number range object. This information is put in a table with structure INROI.

• NUMBER_RANGE_UPDATE_CLOSE

  This function module writes changes that NUMBER_RANGE_GROUP_UPDATE and NUMBER_RANGE_INTERVAL_UPDATE have put in the local memory to the database. After calling this function module, unlock the changed number range object.

• NUMBER_RANGE_UPDATE_INIT

  This function module initializes the local memory, if you want to discard changes not yet put in the database.