Examples in this section are applicable to Linux and Windows XP/Server 2003. The first example is a command-line invocation of Teradata ARC from Windows XP/Server 2003:
ARCMAIN SESSIONS=8 CATALOG OUTLOG=ARCALL.OUT <ARCALL.IN
The above command line calls the ARCMAIN executable, uses eight sessions, and enables the catalog feature.
ARCALL.IN is an input file that contains ARCMAIN commands. The ''<'' redirects the input file to ARCMAIN.
By default, data is written to (or read from) a disk file in the current directory. With a tape product, use IOMODULE and IOPARM command-line parameters. To determine the proper values for the IOMODULE and IOPARM command-line parameters, see “IOMODULE” on page 131 and “LOGON” on page 134.
Two of the Backup Application Software products, Quest® NetVault and Symantec Veritas NetBackup, provide additional archive and restore functionality to Teradata ARC, including a graphical user interface (GUI) to perform archive and restore operations. See the Quest NetVault Backup Plugin User's Guide for Teradata or the Teradata Extension for NetBackup Administrator Guide for information on how to install, configure, and use the Teradata access module for these products.
Using a Configuration File or Environment Variables
Frequently used command-line options can be saved in an environment variable or configuration file. For example, if T:\DEFAULTS\CONFIG.ARC contains the following runtime parameters (the parameters are defined in this file):
CATALOG
FILEDEF=(ARCHIVE,ARCHIVE_%UEN%)
SESSIONS=8
and one or both of the following environment variables:
are set temporarily at the command prompt:
SET ARCDFLT=T:\DEFAULT\CONFIG.ARC
SET ARCENV=WDIR=C:\TEMP\ARC\
or set permanently, using Start > Settings > Control Panel > System > Environment, then ARCMAIN can be called:
ARCMAIN RLOG=JOB980813 <INPUT.ARC
In the above command, runtime parameters RLOG=JOB980813 are not defined in a configuration file or in an environment variable because they are job-specific. The call to ARCMAIN is equivalent to the following command-line invocation of Teradata ARC:
ARCMAIN CATALOG
FILEDEF=(ARCHIVE,ARCHIVE_%UEN%) SESSIONS=8 WDIR=C:\TEMP\ARC RLOG=JOB980813
<INPUT.ARC
When called, ARCMAIN automatically uses the context of any set environment variable. The example assumes that ARCENV is set to WDIR=C:\TEMP\ARC\.
Using Environment Variables
Most runtime parameters can be set as defaults in the ARCENV environment variable, the file pointed to by the ARCDFLT environment variable, or in some combination of the two.
These environment variables are known to ARCMAIN, which loads the contents of ARCENV internally, or the Default file when building its runtime parameters. If a parameter is specified multiple times in difference places, the override priority is:
1 Parameters set in ARCENVX
2 Actual runtime parameters on the command line
3 Parameters set in ARCENV
4 Parameters set in the default file pointed to by ARCDFLT
For example, for everyone to use a specific runtime parameter, such as CATALOG, create a network default file that contains the parameter, then point ARCDFLT to it.
Local defaults or frequently used parameters such as IOMODULE can be set in ARCENV, which overrides parameters set in the network default file. Parameters on the command line override parameters set in ARCENV; parameters set in ARCENVX override actual runtime parameters on the command line.
ARC Executable File Changes for Linux
The following information is for the Linux platform only.
On Linux platforms, the ‘arcmain’ executable file is available in a 32-bit version and in a 64-bit version. During installation, both versions of the ‘arcmain’ executable file will be installed simultaneously on your Linux system.
Prior to ARC 15.10, both versions of the executable file had the same name (‘arcmain’). To prevent having a name conflict, each executable file was installed in a different directory location. The 32-bit version was the default version. If you just entered ‘arcmain’ at your Linux command prompt, the 32-bit version of arcmain would execute as the default.
Several different ways were provided to allow you to invoke ‘arcmain’ to access the desired executable file:
arcmain -- 32-bit ‘arcmain’
/usr/bin/arcmain -- 32-bit ‘arcmain’ softlink
/usr/bin64/arcmain -- 64-bit ‘arcmain’ softlink
/opt/teradata/client/15.10/bin/arcmain -- 32-bit ‘arcmain’ (full path)
/opt/teradata/client/15.10/bin64/arcmain -- 64-bit ‘arcmain’ (full path)
Starting with ARC 15.10, the following changes have been implemented:
/usr/bin/arcmain -> /opt/teradata/client/15.10/bin/arcmain32
/usr/bin64/arcmain -> /opt/teradata/client/15.10/bin/arcmain
In Summary, you will now be able to execute ‘arcmain’ by entering one of the following on your Linux system:
arcmain32 -- 32-bit ‘arcmain’
arcmain -- 64-bit ‘arcmain’
/usr/bin/arcmain -- 32-bit ‘arcmain’ softlink
/usr/bin64/arcmain -- 64-bit ‘arcmain’ softlink
/opt/teradata/client/15.10/bin/arcmain32 -- 32-bit ‘arcmain’ (full path)
/opt/teradata/client/15.10/bin/arcmain -- 64-bit ‘arcmain’ (full path)