From MidasWiki
Jump to navigation Jump to search


elog utility

This utility is for an External Electronic Logbook (ELOG) and therefore is included in the Elog package rather than the MIDAS package. Therefore it is not actually a MIDAS utility, but is documented here for completeness.

To send an entry to a Built-in Electronic Logbook (ELOG), use the MIDAS melog utility instead.


The purpose of the elog utility is to submit an entry to an External Electronic Logbook (ELOG). elog is used to submit the full Elog entry to the specified Elog port.


    -h hostname              Name of host where elogd is running
    -p port                  Port where elogd is running
    [-d subdir]              Subdirectory if different from default
    -l logbook/experiment    Name of logbook or experiment
    -s                       Use SSL for communication
    [-v]                     For verbose output
    [-u username password]   Username and password to access elog
    [-f <attachment>]        (up to 50 attachments)
    -a <attribute>=<value>   (up to 50 attributes)
    [-r <id>]                Reply to existing message
    [-q]                     Quote original text on reply
    [-e <id>]                Edit existing message
    [-x]                     Suppress email notification
    [-n 0|1|2]               Encoding: 0:ELcode,1:plain,2:HTML
    -m <textfile>] | <text>
Arguments with blanks must be enclosed in quotes
The elog message can either be submitted on the command line, piped in like
"cat text | elog -h ... -l ... -a ..." or in a file with the -m flag.
Multiple attributes and attachments can be supplied


elog -h <hostname> -p <port> -l <myexpt>  -u "<username> <pwd>" -a author=myname "my message"


the elog utility is part of the ELOG distribution and resides in the same directory as the elogd daemon.

By default the attributes are "Author", "Type", "System" and "Subject". The "Author" attribute has to be present in the elog command in order to successfully submit the message. If multiple attributes are required append before "text" field the full specification of the attribute. In case of multiple attachments, only one "-f" is required followed by up to 10 file names.


    >elog -h myhost -p 8082 -l myexpt -a author=pierre "Just a elog message"
    >elog -h myhost -p 8082 -l myexpt -a author=pierre -f file2attach.txt \
                    "Just this message with an attachment"
    >elog -h myhost -p 8082 -l myexpt -a author=pierre -m file_containing_the_message.txt
    >elog -h myhost -p 8082 -l myexpt -a Author=pierre -a Type=routine -a system=general \
                    -a Subject="my test" "A full Elog message"