In the future there will be a Web UI interface for querying the status of the translator jobs and submitting new translation requests. Until future becomes a reality (and maybe after that) we provide a set of command-line tools for this tasks.
Account Setup
The tools are now part of the standard off-line releases (but not analysis releases) starting with release 0.2.9. To make the tools from release available one has to set the environment. This is done by executing a single command from the shell:
(ba)sh: . /reg/g/psdm/etc/psdm_env.sh (t)csh: source /reg/g/psdm/etc/psdm_env.csh
or adding one of these commands to the user login script (.bashrc or .login).
If user environment is already setup for analysis releases following the Analysis Workbook procedure then one can switch to using regular off-line release with command:
sit_setup default
Checking status of translator system
One can check the sate of the various parts of the translation system using the command:
ic-ws-status -s
Which should produce output like:
ID Host Status Time PID ------------------------------------------------------------------------------- 155 psdev.slac.stanford.edu Stopped 2010-06-28 10:37:29 6855 160 psanamvr101.slac.stanford.edu Stopped 2010-07-14 18:03:02 5271 163 psanamvr102.slac.stanford.edu Running 2010-07-15 12:15:04 27900
Normally the hosts psanamvr101 and psanamvr102 should be in a running state. If all hosts are stopped then the translation will not happen.
Checking status of translation
To see the list of runs and their translation status one have to pass two parameters to ic-ws-status
command – instrument name and experiment name. Here is example of the command and its output:
ic-ws-status AMO amo14410 Run Status ReqID Req Time Files ---------------------------------------------------------------------------- 1 Translation_Error 8543 2010-06-07 08:04:23 /reg/d/psdm/AMO/amo14410/xtc/e23-r0001-s01-c00.xtc /reg/d/psdm/AMO/amo14410/xtc/e23-r0001-s00-c00.xtc 2 Complete 8545 2010-06-07 09:27:02 /reg/d/psdm/AMO/amo14410/xtc/e23-r0002-s00-c00.xtc /reg/d/psdm/AMO/amo14410/xtc/e23-r0002-s01-c00.xtc 3 Complete 8546 2010-06-07 09:27:02 /reg/d/psdm/AMO/amo14410/xtc/e23-r0003-s01-c00.xtc
The output shows the run number, status of the translation process, request ID, request time and list of XTC files. Probably the most important here is the status column which can display one of the following values:
Initial_Entry
– New request, waiting for translation, file list will be empty.Waiting_Translation
– New request, waiting for translation, file list will be non-empty.Being_Translated
– Translator process is running.Translation_Error
– Translation process failed, usually means input data is bad or repeated attempt to translate run which has been translated already.Complete
– Successfully translated.