Ransomware attackers specifically target and attempt to destroy backup systems to increase the probability of payment. Hardening your system is critical. Please ensure you have reviewed your platform security using the Security Hardening Checklist
Cohesity

COHESITY Documentation

Explore our documentation to get started, discover products & new features, access troubleshooting guides, register sources, platforms support.

Products
Data Security Alliance
Visit Cohesity.com
Demos
Support
Blogs
Developers
Partner Portals
Cohesity Community
© 2026 Cohesity, Inc. All Rights Reserved.
Terms of Use|
Privacy Policy|
Legal|
  1. Home
  2. Veritas NetBackup™ for SAP Administrator's Guide
  3. Appendix A. backint command line interface
  4. About backint command line interface for SAP
Veritas NetBackup™ for SAP Administrator's Guide

About backint command line interface for SAP

The NetBackup for SAP backint interface communicates instructions from the SAP tools to NetBackup. The backint interface implements the SAP system's BC-BRI BACKINT Interface specification.

See About the BC-BRI BACKINT Interface.

Note:

Veritas recommends that you use the backint command only with guidance from a technical support staff member.

The backint interface performs the following functions:

  • The backup function. The backup function of the backint interface supports and defines the SAP brbackup and brarchive tools to NetBackup. brbackup and brarchive communicate with the backint interface through an in_file and an out_file parameter. The in_file parameter includes a list of files to be backed up or archived. The out_file parameter reports the status for each file and assigns a backup ID (BID) to each file. In the event of a partial backup, this function can identify successfully backed up files to the user.

  • The restore function. The restore function of the backint interface supports and defines the brrestore tool to NetBackup. It communicates with the backint interface through the in_file parameter and out_file parameter. The in_file parameter includes a list of files to be restored through NetBackup. It also includes the BID assigned during the backup function. The out_file parameter contains the status of the restore for each file. When the NetBackup restore operation is complete, the restore function lists successfully restored files. It also lists BIDs used during the operation.

    During the backup function, NetBackup assigns the BID. It can identify one or more backup runs, a single file backup, or a group of files. During a backup function, the BID is submitted to the out_file parameter. During the restore and the inquiry functions, the BID can only be set in the in_file parameter.

    If the BID is not set, the restore function uses the BID of the last backup. As an option, this function can also include a list of directories into which files are restored.

  • The inquiry function. The inquiry function supports and defines the sapdba tool to NetBackup. sapdba uses the in_file parameter and the out_file parameter to collect backup information. The in_file parameter contains optional BIDs and file names.

    If only a #NULL is received on the in_file parameter, a list of BIDs is generated to the out_file parameter. If a BID is received, a list of files belonging to the BID is generated. If a file name is entered along with the #NULL, a list of BIDs containing that file is listed.

The backint command line uses the following syntax:

backint -u user_id -f function [-t type] -p par_file [-i in_file] [-o out_file]

Table: backint command options shows the backint command options.

Table: backint command options

Option

Arguments and purpose

-u user_id

Required. UID for backup utility user. No default.

-f function

Required. Defines the function that SAP tools requests of NetBackup for SAP:

  • backup - If backup is specified, NetBackup backs up the files in the list that SAP tools provide.

  • restore - If restore is specified, NetBackup restores the files in the list that SAP tools provide.

  • inquiry - If inquiry is specified, NetBackup returns the saved, or the not saved status of the files in the list that SAP tools provide.

-t type

Optional. It defines the type of backup that NetBackup for SAP should perform. If no type is specified, the default value of file is used. Specify one of the following arguments:

  • file - All data files are either offline or in backup mode. NetBackup for SAP can back them all up without coordination with SAP tools.

  • file_online - Allows NetBackup for SAP to request that SAP tools set each tablespace into #BEGIN/#END backup mode when a related file backup takes place. It is used for online backups only. The architecture is based on the switch files that are defined in the -p par_file parameter.

-p par_file

Required. A text file that contains parameters (required and optional), and parameter values. These parameters determine the backup and restore procedure between the SAP tools and NetBackup for SAP and between NetBackup for SAP and NetBackup. The following list explains the components of par_file:

  • A pound character (#) in column one denotes a comment. Any other character in column one is considered valid.

  • All required parameters must be specified with a valid value before the NetBackup for SAP backint interface can execute correctly.

  • You can comment out an optional parameter by placing a # in column one. If optional parameters are specified, they must have valid values for the NetBackup for SAP backint interface to run correctly. If an invalid parameter name is found, the NetBackup for SAP backint interface reports a warning message and continues.

The SAP tools parameter file specifies the location of this par_file. For an example file, see the following:

on UNIX or Linux:

/usr/openv/netbackup/ext/db_ext/sap/scripts/sap_oracle/
initSAP.utl

on Windows:

install_path\NetBackup\dbext\sap\samples\initSAP.utl

-i in_file

Optional. Specifies a text file, the contents of which list the files to backup, inquire, or restore. The format can vary. If this option is not specified, the content of this file is data from standard input.

-o out_file

Optional. Specifies a text file that contains each file that is processed and associated status. May also contain other process messages. If this option is not specified, the output is written to standard output.

More Information

About parameters used in initSID.utl

About backint -i in_file contents

About backint -o out_file contents

Feedback

Was this page helpful?
Previous

Appendix A. backint command line interface

Next

About the BC-BRI BACKINT Interface

Feedback

Was this page helpful?