CA_Install_CA()

Purpose

Install a specified custom server.

Libraries

Blueworx Voice Response library (libvae.a)

Custom Server library (libca.a)

Syntax

#include "CA_header.h"
#include "CA_access_db.h"
int CA_Install_CA (
  char  *appl_name
);

Description

This subroutine installs a specified custom server that is currently in the built state.

It will not replace a custom server that is already installed. If you want to replace an installed custom server, you must first deinstall it, for example, using CA_Deinstall_CA().

Parameters

appl_name
Custom server name. The maximum number of characters allowed in this string is MAX_CA_NAME_LENGTH.

Return codes

0
Successful
-1
Unsuccessful (global error number CA_errno is set to indicate the error)

Error Condition

CA_ACCESS_NOBUFS
CA_APPL_INSTALLED
CA_APPL_NOT_FOUND
CA_INV_ADDR
CA_INV_APPL
CA_INV_REQUEST
CA_NO_MSG_RECV
CA_NOT_INIT
CA_REQ_FAILED
CA_TERMINATING

Related information

CA_Start_CA(), CA_Stop_CA(), CA_Delete_CA(), CA_Deinstall_CA(), CA_Get_CA_Info(), CA_Set_CA_IPL_Status().