PRGN_DOWNLOAD_AGR SAP Function module

PRGN_DOWNLOAD_AGR is a standard SAP function module available within R/3 SAP systems depending on your version and release level. Below is the pattern details for this FM showing its interface including any import and export parameters, exceptions etc as well as any documentation contributions (Comments) specific to the object.

See here to view full function module documentation and code listing, simply by entering the name PRGN_DOWNLOAD_AGR into the relevant SAP transaction such as SE37 or SE80.

Associated Function Group: PRGN_UP_AND_DOWNLOAD
Released Date: Not Released
Processing type: Normal fucntion module

Pattern for FM PRGN_DOWNLOAD_AGR - PRGN DOWNLOAD AGR

CALL FUNCTION 'PRGN_DOWNLOAD_AGR' "
  EXPORTING
*   filename_for_agr =          " file_table-filename
*   filetype_for_agr = 'ASC'    " rlgrap-filetype
    activity_group =            " agr_define-agr_name
*   with_user_assignment = SPACE  " smensapnew-customized
*   with_authorization_data = 'X'  " smensapnew-customized  Customized ('C') or standard menu ('S') flag
*   file_encoding =             " abap_encod
  EXCEPTIONS
    ACTIVITY_GROUP_DOES_NOT_EXIST = 1  "
    FILE_WRITE_ERROR = 2        "
    FILE_OPEN_ERROR = 3         "
    FILE_GENERAL_ERROR = 4      "
    NOT_AUTHORIZED = 5          "
    .  "  PRGN_DOWNLOAD_AGR

ABAP code example for Function Module PRGN_DOWNLOAD_AGR

The ABAP code below is a full code listing to execute function module PRGN_DOWNLOAD_AGR including all data declarations. The code uses 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 original method of declaring data variables up front. 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).

DATA(ld_filename_for_agr) = some text here


DATA(ld_filetype_for_agr) = some text here
 

SELECT single AGR_NAME 
  FROM AGR_DEFINE 
  INTO @DATA(ld_activity_group).

 

SELECT single CUSTOMIZED 
  FROM SMENSAPNEW 
  INTO @DATA(ld_with_user_assignment).

 

SELECT single CUSTOMIZED 
  FROM SMENSAPNEW 
  INTO @DATA(ld_with_authorization_data).


DATA(ld_file_encoding) = 'Check type of data required'.
.

CALL FUNCTION 'PRGN_DOWNLOAD_AGR'
  EXPORTING
*   filename_for_agr =           ld_filename_for_agr
*   filetype_for_agr =           ld_filetype_for_agr
    activity_group =             ld_activity_group
*   with_user_assignment =       ld_with_user_assignment
*   with_authorization_data =    ld_with_authorization_data
*   file_encoding =              ld_file_encoding
  EXCEPTIONS
    ACTIVITY_GROUP_DOES_NOT_EXIST =    1
    FILE_WRITE_ERROR =           2
    FILE_OPEN_ERROR =            3
    FILE_GENERAL_ERROR =         4
    NOT_AUTHORIZED =             5
    .  "  PRGN_DOWNLOAD_AGR

IF SY-SUBRC EQ 0.
  "All OK
ELSEIF SY-SUBRC EQ 1. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 2. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 3. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 4. "Exception
  "Add code for exception here
ELSEIF SY-SUBRC EQ 5. "Exception
  "Add code for exception here
ENDIF.

ABAP code to compare 7.40 inline data declaration with original syntax

The below ABAP code uses the older none in-line data declarations. This allows you to see the coding differences/benefits of the later inline syntax. It may also be useful if you are using an older version of SAP as some of the newer syntax above, such as the @DATA is not available until 4.70 EHP 8.

DATA:

ld_filename_for_agr
 
 TYPE FILE_TABLE-FILENAME ,
ld_filetype_for_agr
 
 TYPE RLGRAP-FILETYPE ,
ld_activity_group
 
 TYPE AGR_DEFINE-AGR_NAME ,
ld_with_user_assignment
 
 TYPE SMENSAPNEW-CUSTOMIZED ,
ld_with_authorization_data
 
 TYPE SMENSAPNEW-CUSTOMIZED ,
ld_file_encoding
 
 TYPE ABAP_ENCOD .



ld_filename_for_agr = some text here

ld_filetype_for_agr = some text here

SELECT single AGR_NAME 
  FROM AGR_DEFINE 
  INTO ld_activity_group.


SELECT single CUSTOMIZED 
  FROM SMENSAPNEW 
  INTO ld_with_user_assignment.


SELECT single CUSTOMIZED 
  FROM SMENSAPNEW 
  INTO ld_with_authorization_data.

ld_file_encoding = 'Check type of data required'.