From: Jiří Sitera <sitera@civ.zcu.cz>
Date: Wed, 29 Apr 2009 11:13:53 +0000 (+0000)
Subject: Notifications:-O, -r, notifications in HTML. Section and TODO for RSS.
X-Git-Tag: glite-lb-client_R_4_0_2_2~33
X-Git-Url: http://scientific.zcu.cz/git/?a=commitdiff_plain;h=cc957994edb6c95170056ae579cdf8bbb06e20a3;p=jra1mw.git

Notifications:-O, -r, notifications in HTML. Section and TODO for RSS.
---

diff --git a/org.glite.lb.doc/src/LBUG-Tools.tex b/org.glite.lb.doc/src/LBUG-Tools.tex
index 7b788c0..06f0a9f 100644
--- a/org.glite.lb.doc/src/LBUG-Tools.tex
+++ b/org.glite.lb.doc/src/LBUG-Tools.tex
@@ -67,6 +67,14 @@ To list all user's jobs, it is possible to query only the \LB server address, e.
 \begin{verbatim}
   firefox https://pelargir.ics.muni.cz:9000
 \end{verbatim}
+To list all user's notification registration curently valid on a given \LB server, use a URL constructed as in folowing example:
+\begin{verbatim}
+  firefox https://pelargir.ics.muni.cz:9000/NOTIF
+\end{verbatim}
+A notification ID also have a form of URL. If you direct your browser to a particular notification ID, the \LB server will provide the notification details for it.
+\begin{verbatim}
+  firefox https://pelargir.ics.muni.cz:9000/NOTIF:1234567890
+\end{verbatim}
 In all cases it is necessary to have the user certificate installed in the browser.
 
 
@@ -84,6 +92,8 @@ or
     https://pelargir.ics.muni.cz:9000/1234567890/?text
 \end{verbatim}
 
+\subsection{Job state changes as a RSS feed}
+\TODO{Fila}
 
 \subsection{Other useful tools}
 
diff --git a/org.glite.lb.doc/src/notify.tex b/org.glite.lb.doc/src/notify.tex
index e154325..3dc1b27 100644
--- a/org.glite.lb.doc/src/notify.tex
+++ b/org.glite.lb.doc/src/notify.tex
@@ -55,8 +55,7 @@ For action \verb'refresh', command usage is:
 
 For action \verb'receive', command usage is:
 \begin{verbatim}
-  glite-lb-notify receive [ { -s socket_fd | -a fake_addr } ] [-i timeout]
-            [-t requested_validity ] [-f field1,field2,...] [notifid]
+  glite-lb-notify receive  [ { -s socket_fd | -a fake_addr } ] [-t requested_validity ] [-i timeout] [-r ] [-f field1,field2,...] [notifid]
 \end{verbatim}
 
 For action \verb'drop', command usage is:
@@ -80,6 +79,7 @@ where
 \texttt{  -f field1,field2,...} & list of status fields to print (only owner by default)   \\
 \texttt{  -c} & notify only on job state change \\
 \texttt{  -S, --state state1,state2,...} & match on events resulting in listed states   \\
+\texttt{  -r} & refresh automatically the notification registration while receiving data\\
 \end{tabularx}
 
 For additional information see also manual page glite-lb-notify(1).
@@ -137,10 +137,9 @@ Destroy notification:
 Instead of waiting for one job, user may want to accept notification about 
 state changes of all his jobs.
 
-Register notification for user (DN obtained by \verb'grid-proxy-info -subject'):
+Register notification for actual user:
 \begin{verbatim}
-  GLITE_WMS_NOTIF_SERVER=skurut68-2.cesnet.cz:9100 glite-lb-notify new \
-   -o "/DC=cz/DC=cesnet-ca/O=Masaryk University/CN=Miroslav Ruda"
+  GLITE_WMS_NOTIF_SERVER=skurut68-2.cesnet.cz:9100 glite-lb-notify new -O
 \end{verbatim}
 
 returns:
@@ -202,7 +201,7 @@ examples directory) creates socket, which is then reused for all
 
 \begin{verbatim}
 GLITE_WMS_NOTIF_SERVER=skurut68-2.cesnet.cz:9100 NOTIFY_CMD=glite-lb-notify \
- ./notify.pl -o "/DC=cz/DC=cesnet-ca/O=Masaryk University/CN=Miroslav Ruda"
+ ./notify.pl -O
 \end{verbatim}
 
 returns: