Guardian Native C Library Calls Reference Manual (G06.28+, H06.05+)

Guardian Native C Library Calls (n - r) __ns_start_backup(3)
NAME
__ns_start_backup - Creates a backup process for the primary process
LIBRARY
G-series native nonPIC Guardian processes: $SYSTEM.SYSTEM.CRTLNS
G-series native PIC Guardian processes: $SYSTEM.SYSTEM.CRTLNS2
H-series native Guardian processes: $SYSTEM.ZDLLnnn.CRTLNSE
SYNOPSIS
#include <crtlns.h>
long __ns_start_backup (
[ short *error_detail, ]
[ short backup_cpu, ]
[ short *backup_process_handle
, ]
[ char *backup_hometerm, ]
[ short backup_debug_options
, ]
[ char *backup_program_file ]
);
PARAMETERS
error_detail Points to a variable that receives the error detail information from the Guardian
procedure PROCESS_CREATE_. This parameter is optional.
backup_cpu Specifies the number of the CPU in which to start the backup process. This
parameter is optional. If this parameter is omitted or its value is -1, the operating
system selects a processor.
backup_process_handle
Points to a variable that receives the process handle of the backup process. This
parameter is optional.
backup_hometerm
Points to a null-terminated string that is the Guardian filename of a home termi-
nal for the backup process (for example, $VHS). This parameter is optional. If
this parameter is omitted, the backup process has the same home terminal as the
primary process.
backup_debug_options
Specifies the debugging options for the backup process. This parameter is
optional. backup_debug_options corresponds to the debug-options parameter of
the Guardian procedure PROCESS_CREATE_. Refer to PROCESS_CREATE_
in the Guardian Procedure Calls Reference Manual for details.
backup_program file
Points to a null-terminated string that is the Guardian filename of the native
object file to run as the backup process (for example,
\NODE1.$VOL.SUBVOL.NEWOBJ).
This parameter is optional for programs compiled by a native compiler but is not
recognized for programs compiled by the TNS compiler. If this parameter is
omitted, the object file for the primary process is used.
527192-007 Hewlett-Packard Company 5−23