CA_Start_CA()

Purpose

Requests the custom server control program to start the execution of a custom server.

Libraries

Blueworx Voice Response library (libvae.a)

Custom Server library (libca.a)

Syntax

#include "CA_header.h"
int CA_Start_CA (
 char  *application_name,
 int   num_args,
 char  *arg_array[]
);

Description

This subroutine allows a custom server to request that another custom server be started, using the main arguments specified. If num_args is set to zero, the custom server control program will use the default main arguments supplied previously using the custom server user interface.

Parameters

application_name

The name of the custom server to start.

num_args

The number of arguments being passed in the arg_array to the custom server.

arg_array

An array of pointers to character strings, each string being an argument to be passed to the specified custom server. If there are no arguments, set this parameter to NULL.

There is a limit to the maximum combined length of all parameters passed to the arg_array, see CA_PARMS_TOO_LARGE.

Return codes

0

Successful

-1

Unsuccessful (global error number CA_errno is set to indicate the error)

Error names

CA_ACCESS_NOBUFS
CA_ALREADY_STARTED
CA_APPL_NOT_INSTALLED
CA_INV_ADDR
CA_INV_APPL
CA_NO_MSG_RECV
CA_NOT_INIT
CA_PARMS_TOO_LARGE
CA_REQ_FAILED
CA_START_FAILED
CA_TERMINATING

Related information

CA_Delete_CA(), CA_Deinstall_CA(), CA_Get_CA_Info(), CA_Send_CA_Msg(), CA_Set_CA_Ipl_Status(), CA_Stop_CA().