SAP J_2GRDS Function Module for Request Digital Sign









J_2GRDS is a standard j 2grds SAP function module available within SAP R/3 or S/4 Hana systems, depending on your version and release level. It is used for Request Digital Sign 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 j 2grds FM, simply by entering the name J_2GRDS into the relevant SAP transaction such as SE37 or SE38.

Function Group: J2GLPE1
Program Name: SAPLJ2GLPE1
Main Program: SAPLJ2GLPE1
Appliation area:
Release date: N/A
Mode(Normal, Remote etc): Normal Function Module
Update:



Function J_2GRDS 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 'J_2GRDS'"Request Digital Sign
EXPORTING
I_DEVID = "Sign Device (DSD)
I_ACTION = "Request action (SIGN, CHCK)
I_LEGKEY = "Legal doc. key (apply f. J_2GFORM_LEGKEY 1st)
I_COPYNR = "Print copy number
* I_NOPRECHECKS = ' ' "Don't perform pre-RFC checks (faster)

IMPORTING
E_RC = "Function's return code
E_DSDRC = "DSD's return code (takes value only if E_RC=0)
E_STATN = "New sign status
E_MSG = "Error message description
E_DSIG = "Digital Sign (DS)
E_NXTZ = "Number of next 'Z'

TABLES
T_OTF = "Text to sign in internal SAPscript format (OTF)
* T_ADD = "Additional text with issuer data
.



IMPORTING Parameters details for J_2GRDS

I_DEVID - Sign Device (DSD)

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

I_ACTION - Request action (SIGN, CHCK)

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

I_LEGKEY - Legal doc. key (apply f. J_2GFORM_LEGKEY 1st)

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

I_COPYNR - Print copy number

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

I_NOPRECHECKS - Don't perform pre-RFC checks (faster)

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

EXPORTING Parameters details for J_2GRDS

E_RC - Function's return code

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

E_DSDRC - DSD's return code (takes value only if E_RC=0)

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

E_STATN - New sign status

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

E_MSG - Error message description

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

E_DSIG - Digital Sign (DS)

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

E_NXTZ - Number of next 'Z'

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

TABLES Parameters details for J_2GRDS

T_OTF - Text to sign in internal SAPscript format (OTF)

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

T_ADD - Additional text with issuer data

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

Copy and paste ABAP code example for J_2GRDS 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_e_rc  TYPE SY-SUBRC, "   
lt_t_otf  TYPE STANDARD TABLE OF ITCOO, "   
lv_i_devid  TYPE J_2GLPDSD-DEVID, "   
lt_t_add  TYPE STANDARD TABLE OF J_2GLPTXT, "   
lv_e_dsdrc  TYPE SY-SUBRC, "   
lv_i_action  TYPE SY-UCOMM, "   
lv_e_statn  TYPE J_2GLPLEGSIG-STAT1, "   
lv_i_legkey  TYPE J_2GLPLEGKEY, "   
lv_e_msg  TYPE J_2GLPTXT-LINE, "   
lv_i_copynr  TYPE J_2GLPGLOPAR-COPYNR, "   
lv_e_dsig  TYPE J_2GLPLEGSIG-DSIG1, "   
lv_i_noprechecks  TYPE J_2GLPLEGSIG, "   ' '
lv_e_nxtz  TYPE J_2GLPLEGSIG-NXTZ1. "   

  CALL FUNCTION 'J_2GRDS'  "Request Digital Sign
    EXPORTING
         I_DEVID = lv_i_devid
         I_ACTION = lv_i_action
         I_LEGKEY = lv_i_legkey
         I_COPYNR = lv_i_copynr
         I_NOPRECHECKS = lv_i_noprechecks
    IMPORTING
         E_RC = lv_e_rc
         E_DSDRC = lv_e_dsdrc
         E_STATN = lv_e_statn
         E_MSG = lv_e_msg
         E_DSIG = lv_e_dsig
         E_NXTZ = lv_e_nxtz
    TABLES
         T_OTF = lt_t_otf
         T_ADD = lt_t_add
. " J_2GRDS




ABAP code using 7.40 inline data declarations to call FM J_2GRDS

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 SUBRC FROM SY INTO @DATA(ld_e_rc).
 
 
"SELECT single DEVID FROM J_2GLPDSD INTO @DATA(ld_i_devid).
 
 
"SELECT single SUBRC FROM SY INTO @DATA(ld_e_dsdrc).
 
"SELECT single UCOMM FROM SY INTO @DATA(ld_i_action).
 
"SELECT single STAT1 FROM J_2GLPLEGSIG INTO @DATA(ld_e_statn).
 
 
"SELECT single LINE FROM J_2GLPTXT INTO @DATA(ld_e_msg).
 
"SELECT single COPYNR FROM J_2GLPGLOPAR INTO @DATA(ld_i_copynr).
 
"SELECT single DSIG1 FROM J_2GLPLEGSIG INTO @DATA(ld_e_dsig).
 
DATA(ld_i_noprechecks) = ' '.
 
"SELECT single NXTZ1 FROM J_2GLPLEGSIG INTO @DATA(ld_e_nxtz).
 


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!