Background documentationCreating the Parameter File for the SAP MaxDB Adapter Program Locate this document in the navigation structure

 

If you want to use a third-party backup tool with a Backint for Oracle interface for a SAP MaxDB database system, you first have to configure the connection between SAP MaxDB and the Backint for Oracle program (Configuring the Backint for Oracle Connection). Creating the parameter file for the SAP MaxDB adapter program is one of the required steps for this configuration.

In the parameter file, you specify where the adapter program generates the required temporary files and the location of the interface program Backint for Oracle.

Note Note

Enter the name of this parameter file in the configuration file of Backint for SAP MaxDB under the keyword PARAMETERFILE when configuring Backint for SAP MaxDB.

End of the note.

On every line in the parameter file, specify a parameter of the SAP MaxDB adapter program. Specify the keyword for the parameter at the beginning of each line and then the relevant value(s). Lines that do not begin with keywords are ignored by the system.

Structure

<key_string> <value_string>

Options

Option

Description

<key_string>

The key word for a parameter may consist of one or more words

<value_string>

Value(s) of the parameter

Define the following parameters for the SAP MaxDB adapter program:

Parameter

Syntax

Description

Absolute path and size of a temporary file

STAGING AREA:<absolute_path>/<file_name> <size> [KB|MB|GB]

You can define up to 256 temporary files. If you do not specify a unit for the size, it is configured in bytes.

The program uses precisely one temporary file for each pipe.

Maximum number of temporary files to be processed by Backint for Oracle concurrently.

FILES PER BACKINT CALL: <number>

Default value: 1

The program can back up temporary files and generate other temporary files at the same time, providing that the <number> defined here is less than the number of pipes used during backup or recovery.

Absolute path and name of the Backint for Oracle program

BACKINT: <absolute_path>/<file_name>

-

Absolute path and name of the configuration file for the Backint for Oracle program

PARAMETERFILE OF BACKINT: <absolute_path>/<file_name>

Set this parameter only if the third-party backup tool requires you to create a configuration file.

Absolute path and name of the backup history

HISTORY FILE: <absolute_path>/<file_name>

The backup history contains the information, which is required for the recovery function.

Absolute path and name of the standard input file

INPUTFILE FOR BACKINT: <absolute_path>/<file_name>

These files must differ from the files that are configured for the Backint for SAP MaxDB connection (see INPUT, OUTPUT, ERROROUTPUT in Creating the Configuration File for Backint for SAP MaxDB).

Absolute path and name of standard output file

OUTPUTFILE FOR BACKINT: <absolute_path>/<file_name>

Absolute path and name of standard error output file

ERRORFILE FOR BACKINT: <absolute_path>/<file_name>

Maximum waiting time in seconds between creating a temporary file and starting to save the file using Backint for Oracle

MAXIMAL DELAY OF BACKINT CALL: <number>

Default value: 10

This value prevents deadlocks in exceptional situations during a parallel backup or a recovery.

If the temporary files are created at different speeds and one temporary file is already complete, the adapter program waits the maximum time specified here for a further temporary file to be completely created. If no further file is created within the specified time, the existing temporary file is saved.

Specify a time period which allows that all temporary files configured (FILES PER BACKINT CALL:) can be saved at the same time.

Specifies whether or not the adapter program should ignore the closing slash (/ or \) of an absolute directory name for Backint for Oracle.

OMIT LAST DIRECTORY DELIMITER ON RESTORE: <option>

<option> ::= YES | NO

NO: Default value

The slash or backslash is not ignored.

YES: The slash or backslash is ignored.

Use this option to avoid problems with Backint for Oracle implementations that do not expect a closing slash (/ or \) at the end of a directory name.

Value of environment variable BI_CALLER

BI_CALLER VALUE: <value>: <value>

Set this parameter only if the third-party backup tool requires you to set this parameter.

In accordance with the system default, the variable BI_CALLER is removed from the environment before Backint for Oracle is called.

For most Backint for Oracle implementations, you do not need to set this value, as these implementations do not require the environment variable BI_CALLER.