NetBackup for Lotus Notes database agent backup finished with Status Code 1; error "WIN32 1: Incorrect function" is seen in the Job Details

Article:TECH29863  |  Created: 2004-01-06  |  Updated: 2013-10-24  |  Article URL http://www.symantec.com/docs/TECH29863
Article Type
Technical Solution


Issue



NetBackup for Lotus Notes database agent backup finished with Status Code 1; error "WIN32 1: Incorrect function" is seen in the Job Details

 


Error



ERR - NBLN_ChgInfoBackupOpen() NSFBackupGetChangeInfoSize() Failed:0x3810:Backup terminated due to timeout
ERR - failure reading file: Lotus Notes:\C:\[path_to_Domino_Data_Dir]\[database_name].nsf (WIN32 1: Incorrect function.)

 


Solution



This issue has been observed in Domino Server 6.0.2 and later. The following notes.ini entries are platform independent.

IBM Lotus Support has acknowledged a Domino Server setting called BACKUP_TIMEOUT.  When the backup of a (usually larger) database exceeds the default BACKUP_TIMEOUT setting of 15 minutes, the Lotus C API will return the error mentioned above, and cause the database to be skipped.

The timeout setting may be adjusted by adding the following variable to the Domino server's notes.ini file:

BACKUP_TIMEOUT=[number of minutes allowed for backup]

Alternatively, the timeout setting may be disabled by adding the following variable to the Domino server's notes.ini file:

BACKUP_NO_TIMEOUT=1

Notes:

There exists a potential danger that disabling the timeout will result in Domino resources being consumed to the extent that the Domino server could crash during the backup.

The Domino Server service must be restarted in order for the changes to the notes.ini file to take effect.

Please refer to the NetBackup Database Agent Compatibility matrix for supported platforms.

For more information concerning the Domino Server configuration, refer to the Lotus Domino Server documentation, or contact IBM Lotus Support.
 

Supplemental Materials

Value01
Description

NetBackup exit status code 1: The requested operation was partially successful.


Value0x3810
Description

Failed:0x3810:Backup terminated due to timeout



Legacy ID



264987


Article URL http://www.symantec.com/docs/TECH29863


Terms of use for this information are found in Legal Notices