SAP NUMBER_GET_NEXT Function Module for NUmber range: Assigns next free number









NUMBER_GET_NEXT is a standard number get next SAP function module available within SAP R/3 or S/4 Hana systems, depending on your version and release level. It is used for NUmber range: Assigns next free number processing and below is the pattern details for this FM, showing its interface including any import and export parameters, exceptions etc. there is also a full "cut and paste" ABAP pattern code example, along with implementation ABAP coding, documentation and contribution comments specific to this or related objects.


See here to view full function module documentation and code listing for number get next FM, simply by entering the name NUMBER_GET_NEXT into the relevant SAP transaction such as SE37 or SE38.

Function Group: SNR3
Program Name: SAPLSNR3
Main Program: SAPLSNR3
Appliation area: *
Release date: 05-Oct-1995
Mode(Normal, Remote etc): Normal Function Module
Update:



Function NUMBER_GET_NEXT pattern details

In-order to call this FM within your sap programs, simply using the below ABAP pattern details to trigger the function call...or see the full ABAP code listing at the end of this article. You can simply cut and paste this code into your ABAP progrom as it is, including variable declarations.
CALL FUNCTION 'NUMBER_GET_NEXT'"NUmber range: Assigns next free number
  EXPORTING
   NR_RANGE_NR =  "Number range number
   OBJECT =  "Name of number range object
*  QUANTITY = '1' "Number of numbers
*  SUBOBJECT = ' ' "Value of subobject
*  TOYEAR = '0000' "Value of To-fiscal year
*  IGNORE_BUFFER = ' ' "Ignore object buffering

 IMPORTING
   NUMBER =  "free number
   QUANTITY =  "Number of numbers
   RETURNCODE =  "Return code

EXCEPTIONS
   INTERVAL_NOT_FOUND = 1    NUMBER_RANGE_NOT_INTERN = 2    OBJECT_NOT_FOUND = 3    QUANTITY_IS_0 = 4    QUANTITY_IS_NOT_1 = 5    INTERVAL_OVERFLOW = 6    BUFFER_OVERFLOW = 7
.



IMPORTING Parameters details for NUMBER_GET_NEXT

NR_RANGE_NR - Number range number

Data type: INRI-NRRANGENR
Optional: No
Call by Reference: No ( called with pass by value option)

OBJECT - Name of number range object

Data type: INRI-OBJECT
Optional: No
Call by Reference: No ( called with pass by value option)

QUANTITY - Number of numbers

Data type: INRI-QUANTITY
Default: '1'
Optional: Yes
Call by Reference: No ( called with pass by value option)

SUBOBJECT - Value of subobject

Data type:
Default: SPACE
Optional: Yes
Call by Reference: No ( called with pass by value option)

TOYEAR - Value of To-fiscal year

Data type: INRI-TOYEAR
Default: '0000'
Optional: Yes
Call by Reference: No ( called with pass by value option)

IGNORE_BUFFER - Ignore object buffering

Data type:
Default: SPACE
Optional: Yes
Call by Reference: No ( called with pass by value option)

EXPORTING Parameters details for NUMBER_GET_NEXT

NUMBER - free number

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

QUANTITY - Number of numbers

Data type: INRI-QUANTITY
Optional: No
Call by Reference: No ( called with pass by value option)

RETURNCODE - Return code

Data type: INRI-RETURNCODE
Optional: No
Call by Reference: No ( called with pass by value option)

EXCEPTIONS details

INTERVAL_NOT_FOUND - Interval not found

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

NUMBER_RANGE_NOT_INTERN - Number range is not internal

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

OBJECT_NOT_FOUND - Object not defined in TNRO

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

QUANTITY_IS_0 - Number of numbers requested must be > 0

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

QUANTITY_IS_NOT_1 - Number of numbers requested must be 1

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

INTERVAL_OVERFLOW - Interval used up. Change not possible.

Data type:
Optional: No
Call by Reference: No ( called with pass by value option)

BUFFER_OVERFLOW - Buffer is full

Data type:
Optional: No
Call by Reference: Yes

Copy and paste ABAP code example for NUMBER_GET_NEXT Function Module

The ABAP code below is a full code listing to execute function module POPUP_TO_CONFIRM including all data declarations. The code uses the original data declarations rather than the latest in-line data DECLARATION SYNTAX but I have included an ABAP code snippet at the end to show how declarations would look using the newer method of declaring data variables on the fly. This will allow you to compare and fully understand the new inline method. Please note some of the newer syntax such as the @DATA is not available until a later 4.70 service pack (SP8), which i why i have stuck to the origianl for this example.

DATA:
lv_number  TYPE STRING, "   
lv_nr_range_nr  TYPE INRI-NRRANGENR, "   
lv_interval_not_found  TYPE INRI, "   
lv_object  TYPE INRI-OBJECT, "   
lv_quantity  TYPE INRI-QUANTITY, "   
lv_number_range_not_intern  TYPE INRI, "   
lv_quantity  TYPE INRI-QUANTITY, "   '1'
lv_returncode  TYPE INRI-RETURNCODE, "   
lv_object_not_found  TYPE INRI, "   
lv_subobject  TYPE INRI, "   SPACE
lv_quantity_is_0  TYPE INRI, "   
lv_toyear  TYPE INRI-TOYEAR, "   '0000'
lv_quantity_is_not_1  TYPE INRI, "   
lv_ignore_buffer  TYPE INRI, "   SPACE
lv_interval_overflow  TYPE INRI, "   
lv_buffer_overflow  TYPE INRI. "   

  CALL FUNCTION 'NUMBER_GET_NEXT'  "NUmber range: Assigns next free number
    EXPORTING
         NR_RANGE_NR = lv_nr_range_nr
         OBJECT = lv_object
         QUANTITY = lv_quantity
         SUBOBJECT = lv_subobject
         TOYEAR = lv_toyear
         IGNORE_BUFFER = lv_ignore_buffer
    IMPORTING
         NUMBER = lv_number
         QUANTITY = lv_quantity
         RETURNCODE = lv_returncode
    EXCEPTIONS
        INTERVAL_NOT_FOUND = 1
        NUMBER_RANGE_NOT_INTERN = 2
        OBJECT_NOT_FOUND = 3
        QUANTITY_IS_0 = 4
        QUANTITY_IS_NOT_1 = 5
        INTERVAL_OVERFLOW = 6
        BUFFER_OVERFLOW = 7
. " NUMBER_GET_NEXT




ABAP code using 7.40 inline data declarations to call FM NUMBER_GET_NEXT

The below ABAP code uses the newer in-line data declarations. This allows you to see the coding differences/benefits of the later inline syntax. Please note some of the newer syntax below, such as the @DATA is not available until 4.70 EHP 8.

 
"SELECT single NRRANGENR FROM INRI INTO @DATA(ld_nr_range_nr).
 
 
"SELECT single OBJECT FROM INRI INTO @DATA(ld_object).
 
"SELECT single QUANTITY FROM INRI INTO @DATA(ld_quantity).
 
 
"SELECT single QUANTITY FROM INRI INTO @DATA(ld_quantity).
DATA(ld_quantity) = '1'.
 
"SELECT single RETURNCODE FROM INRI INTO @DATA(ld_returncode).
 
 
DATA(ld_subobject) = ' '.
 
 
"SELECT single TOYEAR FROM INRI INTO @DATA(ld_toyear).
DATA(ld_toyear) = '0000'.
 
 
DATA(ld_ignore_buffer) = ' '.
 
 
 


Search for further information about these or an SAP related objects



Comments on this SAP object

What made you want to lookup this SAP object? Please tell us what you were looking for and anything you would like to be included on this page!