Merge pull request #1167 from oracle-devrel/uschwinn-patch-22

Uschwinn patch 22

Author: JesusGitHubOracle

data-platform/core-converged-db/real-application-testing/db-replay/files/capturefilterusage.sql

@@ -0,0 +1,39 @@
+-- how to add capture filters
+
+-- example 1 for inclusion
+ 
+-- Add filters
+-- The usage mode is determined by the DEFAULT_ACTION input of START_CAPTURE procedure.
+
+exec DBMS_WORKLOAD_CAPTURE.ADD_FILTER (fname => 'USER_TRACK', fattribute => 'USER', fvalue => 'TRACKUSER');
+
+-- check status in dba_workload_filters
+-- check filters_used in dba_workload_captures
+
+-- start capture (see capturestart.sql) and use EXCLUDE in DEFAULT_ACTION
+  
+execute dbms_workload_capture.start_capture (name=>'&Name', dir=>'&Dir', default_action=>'EXCLUDE');
+
+-- EXCLUDE: No user request to the database is captured, except for the part of the workload defined by the filter.
+
+-- check status in dba_workload_filters
+-- check filters_used in dba_workload_captures
+
+
+-- example 2 for exclusion
+
+-- Add filters
+-- The usage mode is determined by the DEFAULT_ACTION input of START_CAPTURE procedure.
+
+exec dbms_workload_capture.add_filter('ORACLE_MANAGEMENT_SERVICE', 'Program', 'OMS');
+exec dbms_workload_capture.add_filter('ORACLE_MANAGEMENT_AGENT', 'Program', 'emagent%');
+exec dbms_workload_capture.add_filter('U_DBSNMP', 'USER', 'DBSNMP');
+
+
+-- check status in dba_workload_filters
+-- check filters_used in dba_workload_captures
+
+
+execute dbms_workload_capture.start_capture (name=>'&Name', dir=>'&Dir', default_action=>'INCLUDE');
+
+-- INCLUDE: All user requests to the database are captured, except for the part of the workload defined by the filters. 

data-platform/core-converged-db/real-application-testing/db-replay/files/replayfilterusage.sql

@@ -0,0 +1,35 @@
+-- How to use replay filters
+
+-- First step: Adding new filters (see replayfilter.sql).
+
+-- Adding filters
+exec DBMS_WORKLOAD_REPLAY.add_filter('ORACLE_MANAGEMENT_SERVICE', 'PROGRAM', 'OMS'); 
+exec DBMS_WORKLOAD_REPLAY.add_filter('DBSNMP_USER', 'USER', 'DBSNMP');  
+exec DBMS_WORKLOAD_REPLAY.add_filter('ORACLE_MANAGEMENT_AGENT', 'PROGRAM', 'emagent%'); 
+exec DBMS_WORKLOAD_REPLAY.add_filter('RMAN_MODULE', 'MODULE', 'rman%');  
+
+-- check dba_workload_filters, filter status is now "NEW".
+
+
+-- Second step: Creating a Replay Filter Set (see replayfilterset.sql). 
+exec DBMS_WORKLOAD_REPLAY.CREATE_FILTER_SET (replay_dir => '&DIR', filter_set => 'MyReplayFilter', default_action => 'INCLUDE');
+
+-- INCLUDE: CREATE_FILTER_SET creates a replay filter set named MyReplayFilter, which will replay all captured calls except for the part of the workload defined by the replay filters.
+-- See capturefilterusage.sql for EXCLUDE example.
+
+-- Initialize replay (see replayinitialize.sql)
+
+execute DBMS_WORKLOAD_REPLAY.initialize_replay(replay_name=>'&NAME', replay_dir=>'&DIR', plsql_mode=>'extended');
+
+-- check dba_workload_filters: status is now "IN SET
+
+-- Third step: Using a Replay Filter Set (see replayusefilterset.sql).
+exec DBMS_WORKLOAD_REPLAY.USE_FILTER_SET (filter_set => 'MyReplayFilter');
+
+-- check dba_workload_filters: status is now "IN USE"
+
+-- now proceed with replayprepare.sql, wrc starts and replaystart.sql
+
+
+
+