A.13.8 CONFIGUREPLAYBACK

Configures the parameters associated with the playback of events for a stage of an Oracle Stream Analytics application.

Syntax

java wlevs.Admin 
    [ Connection Arguments ]
    [ User Credentials Arguments ]
    [ Common Arguments ] 
    CONFIGUREPLAYBACK -application application -stage stage
      [-datasetName datasetname] 
      [-storeProvider storeprovidername] 
      [-eventTypes eventtypes] 
      [-scheduleStartTime sstart] 
      [-scheduleEndTime send | -scheduleDuration sduration]
      [-filterStartTime fstart] [-filterEndTime fend | -filterDuration fduration]
      [-speed speed] 
      [-repeat true | false]

Table A-27 CONFIGUREPLAYBACK Arguments

Argument Definition 
-application application

Specifies the name of the Oracle Stream Analytics application whose event record and playback you want to manage.

To get the exact name of your application, you can:

  • Use wlevs.Admin to query for the name (see Query for Application and Processor Names).

  • Use the Oracle Stream Analytics Visualizer: Start the Oracle Stream Analytics Visualizer (see Using Visualizer for Oracle Stream Analytics). In the left pane, navigate to and expand the Applications node of the Oracle Stream Analytics instance to which the application is deployed. Each node under the Applications node is named with the exact application name.

  • Look at the MANIFEST.MF file of the application; the application name is specified by the Bundle-SymbolicName header.

 
-stage stage

Specifies the name of the particular stage, attached to the Oracle Stream Analytics application specified with the -application argument, whose event record and playback you want to manage.

 
-datasetName datasetname

Specifies the name of the dataset in which events are recorded.

 
-storeProvider storeprovidername

Specifies a valid data-source name defined in the Oracle Stream Analytics server config.xml file.

To select the default BDB provider, leave this argument empty or specify an argument value of default-provider.

For more information, see Schema Reference for Oracle Stream Analytics.

 
-eventTypes eventtypes

Specifies the comma-separated list of valid event type names for playing back. Event types must be defined in the event type repository.

 
-scheduleStartTime sstart

Specifies the time when play back should start.

Express the start time as an XMLSchema dateTime value of the form:

mm-dd-yyyy:hh:mm:ss

For example, to specify that recording should start on October 20,

2013, at 11:22:07 am, use the following value:

10-20-2013:11:22:07

For complete details of the XMLSchema dateTime format, see http://www.w3.org/TR/xmlschema-2/#dateTime-lexical-representation.

 
-scheduleEndTime send

Specifies the actual time when the play back should end.

Express the end time as an XMLSchema dateTime value of the form:

mm-dd-yyyy:hh:mm:ss

For example, to specify that play back should end on January 20, 2013, at 6:00pm, use the following value:

10-20-2013:18:00:00

For complete details of the XMLSchema dateTime format, see http://www.w3.org/TR/xmlschema-2/#dateTime-lexical-representation.

Specify null if you want the recording to run forever.

You can specify either -scheduleEndTime or -scheduleDuration, but not both.

 
-scheduleDuration sduration

Specifies the duration of time after which event playback for this stage ends. Specify null if you want the event playback to run forever.

The format is HH:mm:ss, such as 01:00:00.

You can specify either -scheduleEndTime or -scheduleDuration, but not both.

 
-filterStartTime fstart

Specifies that only events with record-time greater than or equal to this value will be selected for playback.

Express the start time as an XMLSchema dateTime value of the form:

yyyy-mm-ddThh:mm:ss

For example, to play back only events with record-time greater than or equal to January 20, 2010, at 5:00am, use the following value:

2010-01-20T05:00:00

For complete details of the XMLSchema dateTime format, see http://www.w3.org/TR/xmlschema-2/#dateTime-lexical-representation.

Specify null if you want to select all events for playback.

 
-filterEndTime fend

Specifies only events with record-time less than or equal to this value will be selected for playback.

Express the end time as an XMLSchema dateTime value of the form:

yyyy-mm-ddThh:mm:ss

For example, to play back only events with record-time less than or equal to January 20, 2010, at 6:00pm, use the following value:

2010-01-20T18:00:00

For complete details of the XMLSchema dateTime format, see http://www.w3.org/TR/xmlschema-2/#dateTime-lexical-representation.

You can specify either -filterEndTime or -filterDuration, but not both.

 
-filterDuration fduration

Specifies the filter applied to events in the event store. Only events that were recorded during the filter time will be selected for play back. Specify null if you want to select all events for playback.

The format is HH:mm:ss, such as 01:00:00.

You can specify either -filterEndTime or -filterDuration, but not both.

 
-speed speed

Specifies the playback speed as a positive float.

The default value is 1, which corresponds to normal speed. A value of 2 means that events will be played back 2 times faster than the original record speed. Similarly, a value of 0.5 means that events will be played back 2 times slower than the original record speed.

 
-repeat repeat

Specifies whether to playback events again after the playback of the specified time interval is over.

Valid values are true or false. Default value is false. A value of true means that the repeat of playback continues an infinite number of times until it is deliberately stopped (see STOPPLAYBACK). A value of false means that events will be played back only once.

Example

The examples in this section show how to configure the playback of events of the helloworldAdapter of the helloworld application deployed to the specified Oracle Stream Analytics instance.

The following example specifies a start and end time for playback and that the speed of playback should be twice the normal speed and that once the playback of events for the time interval is over, the playback should start again:

java wlevs.Admin 
     -url service:jmx:msarmi://localhost:9002/jndi/jmxconnector 
     -username wlevs -password wlevs 
     CONFIGUREPLAYBACK -application helloworld -stage helloworldAdapter 
     -scheduleStartTime 10-20-2013:11:22:07 -scheduleEndTime 10-20-2013:18:00:00
      -speed 2 -repeat true

The following example specifies a start and a duration for playback, that the speed of playback is 2 times slower than normal, and that the playback of events should occur only once:

java wlevs.Admin 
     -url service:jmx:msarmi://localhost:9002/jndi/jmxconnector 
     -username wlevs -password wlevs 
     CONFIGUREPLAYBACK -application helloworld -stage helloworldAdapter 
     -scheduleStartTime 10:20:2013:11:22:07 -scheduleEndTime 10-20-2013:18:00:00
     -speed 0.5 -repeat false

The following example specifies a start and a duration of null, which means playback will run forever at normal speed:

java wlevs.Admin 
     -url service:jmx:msarmi://localhost:9002/jndi/jmxconnector 
     -username wlevs -password wlevs 
     CONFIGUREPLAYBACK -application helloworld -stage helloworldAdapter 
     -scheduleStartTime 10:20:2013:11:22:07 -scheduleDuration null