arc4gl is a CXC archive interface that allows the user to connect to the archive server and access archived data. It will only run in the CXCDS environment but forms the basis of all archive ingest, browse, and retrieve operations and might be instructive for that reason.
The environment needed to run arc4gl is contained in the ASCDS user environment.
To run arc4gl type:
arc4gl -U(username)
or:
arc4gl -U(username) [-S(servername)] [-i(inputfile)] [-v]
The -U option specifies the archive account name to be used for
access; these are personal accounts.
The -S option is optional. By default a connection will be opened to the server set by the ASCDS_ARCHIVE_SERVER environment variable, which should be set to the operational archive, arcocc.
The -i option allows the user to send commands saved in a file.
The -v option causes the names of the files that are being retrieved to be printed.
arc4gl reads user input, constructs commands, and sends these to the server. Input is entered in a template-like format using keywords and values. A new line marks the end of a keyword/value pair. Commands are constructed from such keyword/value pairs and sent when instructed.
In addition to keywords, the following controls are available:
| go | to send a set of keywords |
| reset | to clear an unwanted command |
| exit | to exit the program |
keyword1 = value1
keyword2 = value2
......
keywordn = valuen
go
A set of quick rules for required and optional keyword combinations,
as well as a complete table of keyword values is
presented in the so-called arc4gl quick guide.