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-DEVIDOptional: No
Call by Reference: No ( called with pass by value option)
I_ACTION - Request action (SIGN, CHCK)
Data type: SY-UCOMMOptional: 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_2GLPLEGKEYOptional: No
Call by Reference: No ( called with pass by value option)
I_COPYNR - Print copy number
Data type: J_2GLPGLOPAR-COPYNROptional: 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-SUBRCOptional: 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-SUBRCOptional: No
Call by Reference: No ( called with pass by value option)
E_STATN - New sign status
Data type: J_2GLPLEGSIG-STAT1Optional: No
Call by Reference: No ( called with pass by value option)
E_MSG - Error message description
Data type: J_2GLPTXT-LINEOptional: No
Call by Reference: No ( called with pass by value option)
E_DSIG - Digital Sign (DS)
Data type: J_2GLPLEGSIG-DSIG1Optional: No
Call by Reference: No ( called with pass by value option)
E_NXTZ - Number of next 'Z'
Data type: J_2GLPLEGSIG-NXTZ1Optional: 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: ITCOOOptional: No
Call by Reference: No ( called with pass by value option)
T_ADD - Additional text with issuer data
Data type: J_2GLPTXTOptional: 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