Guardian C Library Calls Reference Manual

__ns_start_backup (supplementary)

3-134 128833—Guardian TNS C Library Calls Reference Manual

Reference to Library Calls

__ns_start_backup (supplementary)

The __ns_start_backup function creates a backup process for the primary process.

error_detail

is an optional output parameter that receives the error detail information from the

Guardian procedure PROCESS_CREATE_.

backup_cpu

is an optional input parameter that specifies the number of the CPU in which to start

the backup process. If this parameter is omitted or its value is -1, the operating

system selects a CPU.

backup_process_handle

is an optional output parameter that receives the process handle of the backup

process.

backup_hometerm

is an optional input parameter that points to a string naming a home terminal for the

backup process. If this parameter is omitted, the backup process has the same home

terminal as the primary process.

backup_debug_options

is an optional input parameter that specifies debugging options for the backup

process. backup_debug_options corresponds to the debug-options parameter of the

Guardian procedure PROCESS_CREATE_. Refer to the Guardian Procedure Calls

Reference Manual for details.

Return Value

0 if the operation is successful, -1 or a positive value if an error occurs.

#include <nonstoph>

_extensible long __ns_start_backup(

short *error_detail,

short backup_cpu,

short *backup_process_handle,

char *backup_hometerm,

short backup_debug_options);