NAME

tx - transmit a message to the telescope/instrument server.

SYNOPSIS

tx [node=] [port=] [ether=node,port ] [timeout=] [DEBUG] [abort] [timestamp] msg ...

DESCRIPTION

tx transmits all the arguments in the command line to the telescope/instrument server. The program then awaits the reply, and sends it to stdout. If a message beginning with the word `ERROR' is received it still passed to stdout, without setting the exit status.

The command tx help will list the available services.

Hitting Cntrl^C will cause the program to transmit the "abort" message via UDP (versus TCP). If there is a reply, it will be printed. There is a two second alarm sent which will terminate if nothing is received. The abort message will also be sent by the abort option, no reply will be printed.

If there is an environment variable TXEXTRA present, the value will be concatenated to the message.

OPTIONS
node= specifies then name (or ip address) of the machine to connect to. The default value is the present machine.

port= specifies the socket port to use. The default value is 0x1340. Where the 0x specifies the address is in hexadecimal.

ether=node,port specifies the node and port simultaneously

timestamp - puts an ISO8601 timesatmp in front of message (see examples).

DEBUG - sets the debugging level for the tx program.

timeout= sets an alarm time that will terminate in the specified number of seconds and cause the program to exit with a non-zero exit code.

EXAMPLES
tx point ra=12:34:34 dec=33:33:56 equinox=2000
sends a message to the server at port 0x1340 on the local machine and asks it to point the telescope.

tx node=mambo port=x01341 help
asks the server on node mambo responding to port 0x1341 what services are available.

tx ether=stella,x01341 temps
asks the server on node stella responding to port 0x1341 what the weather is like.

tx timestamp where
2007-02-01T02:12:32Z done where ra=03:29:25.65 dec=+31:30:13 equinox=2007.084 ha=0.095 secz=1.00 alt=89.5 az=190.1

SEE ALSO

BAIT protocol, tserver.
Program index