About Chandra Archive Proposer Instruments & Calibration Newsletters Data Analysis HelpDesk Calibration Database NASA Archives & Centers Chandra Science Links

Skip the navigation links
Last modified: December 2006

URL: http://cxc.harvard.edu/ciao3.4/xpaopen.html
Hardcopy (PDF): A4 | Letter
AHELP for CIAO 3.4 xpaopen Context: xpa

Synopsis

Create a persistent connection for XPA calls.

Syntax

XPA_Type XPAOpen()
XPA_Type XPAOpen( String_Type mode )

Description

Explicitly create a persistent XPA_Type handle for use in subsequent XPA calls (analogous to the way a file pointer is used for I/O). This is most useful for high-volume traffic, to avoid the cost of setting up and tearing down the communications channel during each message exchange. The mode parameter is currently ignored by XPA, and so may be omitted with no consequence.

Example

chips> xp = XPAOpen()
chips> ns = XPAGet( xp, "xpans", "" )
chips> fname = XPAGet( xp, "prism", "filename" )
chips> XPAClose( xp )

Here we create a persistent connection using XPAOpen() and then use it in two calls: the first to find the list of all XPA access points (from "xpans") and the second to find the filename currently being displayed by prism. We then use XPAClose() to close the connection.

Hardcopy (PDF): A4 | Letter
Last modified: December 2006



The Chandra X-Ray Center (CXC) is operated for NASA by the Smithsonian Astrophysical Observatory.
60 Garden Street, Cambridge, MA 02138 USA.    Email: cxcweb@head.cfa.harvard.edu
Smithsonian Institution, Copyright © 1998-2004. All rights reserved.