Starting ARCMAIN from Linux and Windows XP/Server 2003 - TARA/ABU

Starting ARCMAIN from Linux and Windows XP/Server 2003

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 125 and “LOGON” on page 128.

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:

ARCDFLT

ARCENV or ARCENVX (These are the same environment variables, except that ARCENVX has override priority.)

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.