Author: rkanter
Date: Mon Apr 22 18:14:19 2013
New Revision: 1470647

URL: http://svn.apache.org/r1470647
Log:
OOZIE-1215 add note of using escape for oozie jobs filters in doc (egashira via 
rkanter)

Modified:
    oozie/trunk/docs/src/site/twiki/DG_CommandLineTool.twiki
    oozie/trunk/release-log.txt

Modified: oozie/trunk/docs/src/site/twiki/DG_CommandLineTool.twiki
URL: 
http://svn.apache.org/viewvc/oozie/trunk/docs/src/site/twiki/DG_CommandLineTool.twiki?rev=1470647&r1=1470646&r2=1470647&view=diff
==============================================================================
--- oozie/trunk/docs/src/site/twiki/DG_CommandLineTool.twiki (original)
+++ oozie/trunk/docs/src/site/twiki/DG_CommandLineTool.twiki Mon Apr 22 
18:14:19 2013
@@ -61,7 +61,7 @@ usage:
       oozie jobs <OPTIONS> : jobs status
                  -auth <arg>          select authentication type 
[SIMPLE|KERBEROS]
                  -doas <arg>          doAs user, impersonates as the specified 
user.
-                 -filter <arg>        
user=<U>;name=<N>;group=<G>;status=<S>;...
+                 -filter <arg>        
user=<U>\;name=<N>\;group=<G>\;status=<S>\;...
                  -jobtype <arg>       job type ('Supported in Oozie-2.0 or 
later versions ONLY - coordinator' or 'wf' (default))
                  -len <arg>           number of jobs (default '100')
                  -localtime           use local time (same as passing your 
time zone to -timezone). Overrides -timezone option
@@ -396,8 +396,11 @@ The =localtime= option displays times in
 The =verbose= option gives more detailed information for all the actions, if 
checking for workflow job or coordinator job.
 
 The =filter= option can be used to filter coordinator actions based on their 
status.
-The filter option syntax is: <code>[status=VALUE][;status=VALUE]*</code>.
-Multiple values must be specified as different name value pairs. When multiple 
filters are specified, all Coordinator actions that satisfy any one of the 
filters will be retrieved. (The query will do an OR among all the filter values 
for the status)
+The filter option syntax is: <code>[status=VALUE][\;status=VALUE]*</code>.
+(Note escape <code>\</code> needed before semicolon to specify multiple names 
for filter in shell)
+Multiple values must be specified as different name value pairs. When multiple 
filters are specified,
+all Coordinator actions that satisfy any one of the filters will be retrieved.
+(The query will do an OR among all the filter values for the status)
 Currently, the filter option can be used only with an =info= option on 
Coordinator job.
 
 An example below shows how the =verbose= option can be used to gather action 
statistics information for a job:

Modified: oozie/trunk/release-log.txt
URL: 
http://svn.apache.org/viewvc/oozie/trunk/release-log.txt?rev=1470647&r1=1470646&r2=1470647&view=diff
==============================================================================
--- oozie/trunk/release-log.txt (original)
+++ oozie/trunk/release-log.txt Mon Apr 22 18:14:19 2013
@@ -29,6 +29,7 @@ OOZIE-1239 Bump up trunk to 4.1.0-SNAPSH
 
 -- Oozie 4.0.0 (unreleased)
 
+OOZIE-1215 add note of using escape for oozie jobs filters in doc (egashira 
via rkanter)
 OOZIE-1331 URIHandlerService not allowing relative path for URI's (virag)
 OOZIE-1332 Flakey test 
TestActionCheckXCommand.testActionCheckTransientDuringMRAction (rkanter)
 OOZIE-1150 DB upgrade scripts for hcat changes (ryota via virag)


Reply via email to