CA_Set_CA_Ipl_Status()

Purpose

Set the initial program load (IPL) status of an installed custom server.

Libraries

Blueworx Voice Response library (libvae.a)

Custom Server library (libca.a)

Syntax

#include "CA_header.h"
int CA_Set_CA_Ipl_Status (
 char *appl_name,
 IPL_STATUS_ENUM ipl_status
);

Description

This subroutine sets the IPL Status of an installed custom server.

Parameters

appl_name
Specifies the name of the custom server. A #define for APPL_NAME is provided in the system generated header file for each custom server. The maximum number of characters allowed in this string is MAX_CA_NAME_LENGTH.
ipl_status
Specifies the IPL status of the custom server. Valid values are:
  • CA_IPL_STATUS_INSTALLED: the system is not to start the server automatically.
  • CA_IPL_STATUS_AUTOEXEC: the system is to start the server automatically.

Return codes

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

Error names

CA_ACCESS_NOBUFS
CA_APPL_NOT_INSTALLED
CA_INV_ADDR
CA_INV_APPL
CA_INV_CA_IPL_STATUS
CA_INV_REQUEST
CA_NO_MSG_RECV
CA_NOT_INIT
CA_REQ_FAILED
CA_TERMINATING

Related information

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