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

Teradata Archive/Recovery Utility Reference

Product
TARA/ABU
Release Number
15.10
Language
English (United States)
Last Update
2018-10-07
dita:id
B035-2412
lifecycle
previous
Product Category
Teradata Tools and Utilities

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:

  • 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.

    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:

  • There will no longer be separate 32-bit and 64-bit ‘bin’ directories in /opt/teradata/client/15.10. There will only be a single ‘bin’ directory and both versions of ‘arcmain’ will reside in it.
  • In order to uniquely identify each version of ‘arcmain’ in the ‘bin’ directory, the name of the 32-bit ‘arcmain’ executable file will be changed to ‘arcmain32’. The name of the 64-bit ‘arcmain’ executable file will remain ‘arcmain’.
  • Due to this name change, the 64-bit version of ‘arcmain’ will now become the default version on the Linux platform. If you just enter ‘arcmain’ at your Linux prompt, the 64-bit version of arcmain will now execute as the default. If the 32-bit version of ‘arcmain’ is desired, the user will have to explicitly specify the ‘arcmain32’ executable name.
  • Both ‘arcmain’ softlinks (/usr/bin/arcmain and /usr/bin64/arcmain) will still be set up but they will now have the following links:
  • /usr/bin/arcmain		->	/opt/teradata/client/15.10/bin/arcmain32
    /usr/bin64/arcmain -> /opt/teradata/client/15.10/bin/arcmain
  • The full path to /opt/teradata/client/15.10/bin will be set up in your system’s path during Installation.
  • 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)