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