.. _console-howtos:

Console Howtos
=====================

Small and handy console commands for daily use.


Send an item via tools send or call
-----------------------------------

As an example, the following code block can be used to trigger a scenario
listing in the :ref:`scenario_coordination` by sending an initated `TaskState <http://docs.cor-lab.de//rst-manual/trunk/html/generated/stable/package-rst-communicationpatterns.html#rst.communicationpatterns.TaskState>`_
to the scope ``/citec/csra/home/hallway/entrance/state/request/list``


.. code-block:: bash

    export SCOPE=/citec/csra/home/hallway/entrance/state/request/list
    $prefix/bin/tools0.12 send \
        -I$prefix/share/rst0.12/proto/stable/ \
        -l$prefix/share/rst0.12/proto/stable/rst/communicationpatterns/TaskState.proto \
        'pb:.rst.communicationpatterns.TaskState:{origin: "SUBMITTER" '\
        'state: "INITIATED" serial: 0 wire_schema: "utf-8-string" payload: "list"}' $SCOPE

The following snippet can be used to alter the :ref:`moving_head` position with azimuth ``a`` and elevation ``e``.

.. code-block:: bash

    export a=10
    export e=0
    export METHOD=/home/living/movinghead/setPanTilt
    tools0.12 call \
        -I$prefix/share/rst0.12/proto/sandbox/ \
        -l$prefix/share/rst0.12/proto/sandbox/rst/geometry/SphericalDirectionFloat.proto \
        "$METHOD('pb:.rst.geometry.SphericalDirectionFloat:{ azimuth: '$a' elevation: '$e' }')"

Parallel machine access
-----------------------

Use cssh (cluster ssh) to connect to all the desired hosts and call the command there.

.. code-block:: bash

    cssh adl apw atl bcn bfe bkk bos bvb dme dsc dxb gig hls hsl iom lol lxr mia mpc ssh
    [in the cssh box] YOUR_COMMAND