For information on converting to InterSystems IRIS,
see the InterSystems IRIS Adoption Guide
and the InterSystems IRIS In-Place Conversion Guide,
both available on the WRC Distributions page (login required).
Sample script that initiates a connection to an archive server
Set SessionOref = ##class(%Archive.Session).%New()
Set SessionOref.Host = 220.127.116.11 // IP address of the archive server
Set SessionOref.AuthFile = AuthFilePath // path of the .pea file (for Centera)
Set Status = SessionOref.Connect()
Once connected, here is a sample script that stores a content (cf. %Archive.Content):
// create a content object as source, whose handle is ContentOref (see %Archive.Content)
Set Status = SessionOref.Store(ContentOref, .ContentUID)
After Store() returns successfully, you need to save the ContentUID value somewhere (say, in a Cache database) for future retrieval purpose.
Here is a sample script to retrieve the file from the archive server, using the ContentUID and open connection above:
// create a content object as target, whose handle is ContentOref (see %Archive.Content)
Set Status = SessionOref.Retrieve(ContentOref, ContentUID)
Only EMC Centera server is supported as an archive server
The source of storing and the target of retrieval must be files
Only one open connection per Cache process. Attempt to open additional connections (whether to the same server as the existing connection or not) would get an error.
Retrieving selected files from a content containing multiple files ("blobs") is not supported.