XPA Programs

Summary

Use the xpa programs to send/receive data to/from XPA servers from the command line or from scripts.

<data> | xpaset  [-h] [-i nsinet] [-n] [-s] [-u users] [-v] <template> [paramlist]

xpaget  [-h] [-i nsinet] [-s] [-u users] <template> [paramlist]
	
xpainfo [-h] [-i nsinet] [-s] [-u users] <template> [paramlist]

yes|no = xpaaccess [-h] [-i nsinet] [-n] [-u users] <template> [type]

xpaset - send data to XPA server(s)


<data> | xpaset  [-h] [-i nsinet] [-n] [-p] [-s] [-u users] [-v] <template|host:port> [paramlist]

switches:

switch

explanation

-h

print this message

-i

access xpa point on different machine (override XPA_NSINET environment variable)

-n

don't wait for the status message after server completes

-p

don't read (or send) buf data from stdin

-s

enter server mode

-u [users]

xpa points can be from specified users (override XPA_NSUSERS)

Data will be sent to access points matching the template or host:port. A set of qualifying parameters can be appended.

The -s switch puts xpaset into server mode, in which commands and data can be sent to access points without having to run xpaset multiple times. (Its not clear if this buys you much!) The syntax for sending commands in server mode is:

  csh>xpaset -s
  xpaset SAOtng colormap I8
  ^D
  xpaset SAOtng regions
  circle 200 300 40
  circle 300 400 50
  ^D
etc.
After the required "xpaset" command is specified, optional ASCII data can be appended (as in the region example). A single data/command set is delimited by ^D. Note that typing ^D when a command is expected terminates the program.

Examples:

  csh> xpaset SAOtng file < foo.fits
  csh> echo "stop" | xpaset bynars:28571

xpaget - retrieve data from XPA server(s)


xpaget [-h] [-i nsinet] [-s] [-u users] <template|host:port> [paramlist]

switches:

switch

explanation

-h

print this message

-i

access xpa point on different machine (override XPA_NSINET environment variable)

-s

enter server mode

-u [users]

xpa points can be from specified users (override XPA_NSUSERS)

Data will be retrieved from access points matching the template or host:port. A set of qualifying parameters can be appended.

Examples:

  csh> xpaget SAOtng images
  csh> xpaget bynars.harvard.edu:28571

xpainfo - send short message to XPA server(s)


xpainfo [-h] [-i nsinet] [-s] [-u users] <template|host:port> [paramlist]

switches:

switch

explanation

-h

print this message

-i

access xpa point on different machine (override XPA_NSINET environment variable)

-s

enter server mode

-u [users]

xpa points can be from specified users (override XPA_NSUSERS)

Info will be sent to access points matching the template or host:port. A set of qualifying parameters can be appended.

Examples:

  csh> xpainfo IMAGE SAOtng image

xpaaccess - see if template matches registered XPA access points


xpaaccess [-h] [-i nsinet] [-n] [-u users] <template> [type]

switches:

switch

explanation

-h

print this message

-i

access xpa point on different machine (override XPA_NSINET environment variable)

-s

enter server mode

-u [users]

xpa points can be from specified users (override XPA_NSUSERS)

xpaaccess returns "yes" if there are existing XPA access points that match the template (and optional access type: g,i,s), and returns "no" otherwise. If -n is specified, the number of matches is returned.

[Another way to do this is to use xpaget on the xpans:

  csh> xpaget xpans "SAOtng*" "sg" "*"
  SAOTNG SAOtng gs 838e2f68:5696 eric
  SAOTNG SAOtng1 gs 838e2f68:6212 eric

will return information from the name server about XPA access points that match the template "SAOtng*", are available for get or set calls, and are owned by any user.]


Index to the XPA Help Pages

Last updated: May 18, 1999