SAP Function Modules

comments icon Comments

DB4_GET_WAIT_STATISTICS SAP Function module - AS/400: Get Wait Statistics for all App.Servers and their DB jobs







DB4_GET_WAIT_STATISTICS 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 DB4_GET_WAIT_STATISTICS into the relevant SAP transaction such as SE37 or SE80.

Associated Function Group: STU4_ST04
Released Date: Not Released
Processing type: Remote-Enabled
remote enabled module settings


Pattern for FM DB4_GET_WAIT_STATISTICS - DB4 GET WAIT STATISTICS 





CALL FUNCTION 'DB4_GET_WAIT_STATISTICS' "AS/400: Get Wait Statistics for all App.Servers and their DB jobs
  IMPORTING
    date =                      " sy-datum      Date of wait statistic analysis
    time =                      " sy-uzeit      Time of wait statistic analysis
    wait_stats_summary =        " db4wtsts_s    Summary of wait statistic of all instances
    api_rc =                    " sy-subrc      Error code from API call
    sum_waits =                 " db4wtsts_s-wdb  Sum of waits (db + non-db + int.machine)
    sum_wait_times =            " db4wtsts_s-wdbt  Sum of wait times (db + non-db + int.machine)
* TABLES
*   waitsts_per_instance_tab =   " db4wtsts_i   Cumulated wait statistics per instance
*   waitsts_per_process_tab =   " db4wtsts_p    Wait statistics per process of all instances
  EXCEPTIONS
    TH_SERVER_LIST_ERROR = 1    "               Function module TH_SERVER_LIST failed
    API_ERROR = 2               "               Error occured in an C-Api
    .  "  DB4_GET_WAIT_STATISTICS

ABAP code example for Function Module DB4_GET_WAIT_STATISTICS





The ABAP code below is a full code listing to execute function module DB4_GET_WAIT_STATISTICS 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_date    TYPE SY-DATUM
,
ld_time    TYPE SY-UZEIT
,
ld_wait_stats_summary    TYPE DB4WTSTS_S
,
ld_api_rc    TYPE SY-SUBRC
,
ld_sum_waits    TYPE DB4WTSTS_S-WDB
,
ld_sum_wait_times    TYPE DB4WTSTS_S-WDBT
,
it_waitsts_per_instance_tab    TYPE STANDARD TABLE OF DB4WTSTS_I,"TABLES PARAM
wa_waitsts_per_instance_tab  LIKE LINE OF it_waitsts_per_instance_tab
,
it_waitsts_per_process_tab    TYPE STANDARD TABLE OF DB4WTSTS_P,"TABLES PARAM
wa_waitsts_per_process_tab  LIKE LINE OF it_waitsts_per_process_tab
.



 

"populate fields of struture and append to itab
append wa_waitsts_per_instance_tab to it_waitsts_per_instance_tab.
 

"populate fields of struture and append to itab
append wa_waitsts_per_process_tab to it_waitsts_per_process_tab.
.

CALL FUNCTION 'DB4_GET_WAIT_STATISTICS'
  IMPORTING
    date =                       ld_date
    time =                       ld_time
    wait_stats_summary =         ld_wait_stats_summary
    api_rc =                     ld_api_rc
    sum_waits =                  ld_sum_waits
    sum_wait_times =             ld_sum_wait_times
* TABLES
*   waitsts_per_instance_tab =    it_waitsts_per_instance_tab
*   waitsts_per_process_tab =    it_waitsts_per_process_tab
  EXCEPTIONS
    TH_SERVER_LIST_ERROR =       1
    API_ERROR =                  2
    .  "  DB4_GET_WAIT_STATISTICS

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
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_date  TYPE SY-DATUM ,
it_waitsts_per_instance_tab  TYPE STANDARD TABLE OF DB4WTSTS_I ,
wa_waitsts_per_instance_tab  LIKE LINE OF it_waitsts_per_instance_tab,
ld_time  TYPE SY-UZEIT ,
it_waitsts_per_process_tab  TYPE STANDARD TABLE OF DB4WTSTS_P ,
wa_waitsts_per_process_tab  LIKE LINE OF it_waitsts_per_process_tab,
ld_wait_stats_summary  TYPE DB4WTSTS_S ,
ld_api_rc  TYPE SY-SUBRC ,
ld_sum_waits  TYPE DB4WTSTS_S-WDB ,
ld_sum_wait_times  TYPE DB4WTSTS_S-WDBT .



 

"populate fields of struture and append to itab
append wa_waitsts_per_instance_tab to it_waitsts_per_instance_tab. 

"populate fields of struture and append to itab
append wa_waitsts_per_process_tab to it_waitsts_per_process_tab.

SAP Documentation for FM DB4_GET_WAIT_STATISTICS


The function module collects process wait statistics for all processes of all instances currently running: ...See here for full SAP fm documentation

Contribute (Add Comments)

Please help keep this info upto date and use the comments section below to add useful hints, tips and information specific to this SAP function. This will then be available for you and other users to easily find by simply searching on the object name DB4_GET_WAIT_STATISTICS or its description.


   
 

DB4_GET_WAIT_STATISTICS - AS/400: Get Wait Statistics for all App.Servers and their DB jobs
DB4_GET_RECORD_CONTENT - iSeries: Get Content of one Record of a Table
DB4_GET_PEAK_TABSIZE - iSeries: Get Largest Table
DB4_GET_JOBS_LOCKING_RECORD - iSeries: Get all Jobs which are Locking one Record
DB4_GET_JOBLOG - iSeries: Get Joblog of AS/400 Job
DB4_GET_HISTORY_STATISTICS - AS/400: Get the history-data for several values.