(Page 1 of 1 in this chapter) Version

Appendix B

Error Summary

Introduction

This appendix provides a summary of DPNSS service error codes.
The DPNSS service error codes are presented in two tables: Alphabetically by error code name, including a description. Numerically by hex number, decimal number, and error name.
All DPNSS service functions return either SUCCESS or an error code. If the return code is not SUCCESS (0), it is an error code indicating that the function has failed, and indicating the reason for the failure.
DPNSS service error codes are defined in the include files dpndef.h and ctaerr.h. The error codes are prefixed with DPNERR_ or CTAERR_.
For a complete listing of CTAERR codes, refer to the CT Access Developer's Reference Manual.
Asynchronous functions return SUCCESS if the input arguments and context state are valid for the given function, and if the DPNSS service sent the command to the hardware providing the service. SUCCESS, in this case, means the function was initiated and that a DONE event will be generated for the function.
A DONE event is a CT Access event informing the application that an asynchronous function has completed processing. DONE event codes are in the form DPNSS_function_DONE, where function is the completed function.
It is possible for an asynchronous function to return SUCCESS to the application when it is invoked, and then later fail on the board. If a board detects an error when executing a function, CT Access delivers a DONE event to the application with an error code in the event value field.

Alphabetical Error Summary

The following table is an alphabetical listing of DPNSS service errors:

Error Name

Hex

Decimal

Description

CTAERR_BAD_ARGUMENT

0x00000007

7

A function argument had an invalid value, or a required pointer argument was NULL.

CTAERR_BOARD_ERROR

0x00000003

3

An unexpected error occurred on the AG board. In most cases, a DPNEVN_BOARD_ ERROR event will occur with this error, which will contain the board error code.

CTAERR_FATAL

0x00000002

2

An internal error occurred in the CT Access library. Please contact NMS Developer Support.

CTAERR_FUNCTION_ACTIVE

0x0000000f

15

An attempt was made to start an asynchronous function that is already started. Also returned if an attempt was made to get a digit or flush the digit queue while collecting digits.

CTAERR_FUNCTION_NOT_ACTIVE

0x0000000e

14

An attempt was made to stop or modify a function that was not running.

CTAERR_INVALID_BOARD

0x0000001a

26

The specified AG board number has not been successfully configured.

CTAERR_INVALID_CTAHD

0x00000005

5

The context handle is invalid.

CTAERR_INVALID_CTAQUEUEHD

0x00000004

4

Bad CTA queue ID.

CTAERR_INVALID_SEQUENCE

0x00000013

19

An attempt was made to stop a function that is already being stopped, or a call control function was called before receiving a response to the previous call control command, or a play or record buffer was submitted when it was not expected.

CTAERR_INVALID_STATE

0x0000000c

12

The function is not valid in the current port state. For example, most functions require the port to be in the DPNSS_STATE_ STARTED state, which is entered after starting a trunk protocol.

CTAERR_LOCK_TIMEOUT

0x0000001d

29

A thread lock timed out.

CTAERR_NOT_FOUND

0x0000000a

10

The specified parameter does not exist.

CTAERR_OUT_OF_MEMORY

0x00000006

6

Unable to allocate memory for driver or port context, for play or record buffers, or for temporary storage. When this error occurs in a DONE event, it may mean that there was insufficient memory on the AG board.

CTAERR_OUT_OF_RESOURCES

0x00000008

8

Unable to create shared resources.

CTAERR_OUTPUT_ACTIVE

0x0000001b

27

An attempt to open a port failed because the stream and slot are already opened on another port, or an output operation (such as play) failed because there is another active output function.

CTAERR_SHAREMEM_ACCESS

0x00000010

16

Failed attempt to access shared memory.

DPNERR_ CHANNEL_ID_ALREADY_EXISTS

0x001400C9

1310921

The DPNSS server process detected an internal failure. Please contact NMS Developer Support.

DPNERR_CANNOT_CONNECT

0x00140068

1310824

Unable to establish a connection with the DPNSS server process. Please contact NMS Developer Support.

DPNERR_CANNOT_CREATE_CHANNEL

0x00140006

1310726

Unable to create a channel to the board due to either board or driver limitations. Please contact NMS Developer Support.

DPNERR_CANT_FREE_TIMESLOT

0x001400CB

1310923

The DPNSS server process detected an internal failure. Please contact NMS Developer Support.

DPNERR_CHANNEL_NOT_OPENED

0x00140065

1310821

Connection with the DPNSS server process has not been established. Please contact NMS Developer Support.

DPNERR_COMM_FAILURE

0x00140064

1310820

Unable to communicate with the DPNSS server process. Please contact NMS Developer Support.

DPNERR_INCONSISTENT_MESSAGE

0x00140072

1310828

A message received from the DPNSS server process cannot be interpreted. Please contact NMS Developer Support.

DPNERR_INVALID_CALL_STATE

0x00140005

1310725

The function is not valid in the current call state. For example, many functions require the call to be in the DPNSS_ CC_STATE_ CONNECTED state.

DPNERR_MUTEX_ERROR_ON_CHANNEL

0x001400CA

1310922

The DPNSS server process detected an internal failure. Please contact NMS Developer Support.

DPNERR_OUT_OF_EVENT_BUFFER

0x00140071

1310827

Too many event buffers allocated. The application must release incoming DPNSS SIS buffer lists received with events (using dpnReleaseBuffer).

DPNERR_OWNER_CONFLICT

0x00140066

1310822

The desired stream/ timeslot is already allocated by another process. Please contact NMS Developer Support.

DPNERR_SERVER_TIMEOUT

0x00140069

1310825

A timeout occurred waiting for an answer from the DPNSS server process. Please contact NMS Developer Support.

DPNERR_TIMESLOT_BARRED

0x00140073

1310829

A timeslot is barred.

DPNERR_TRANSIT_NOT_SAME_QUEUE

0x00140070

1310826

The two ctahd specified when calling dpnSetTransitActive are not attached to the same CT Access queue.

DPNERR_UNKNOWN_SERVER_RESPONSE

0x00140067

1310823

The DPNSS server process responded with incorrect data. Please contact NMS Developer Support.

DPNERR_WRONG_CHANNEL_ID

0x001400C8

1310920

The DPNSS server process detected an internal failure. Please contact NMS Developer Support.

Error Name	Hex	Decimal	Description
`CTAERR_BAD_ARGUMENT`	`0x00000007`	`7`	A function argument had an invalid value, or a required pointer argument was `NULL`.
`CTAERR_BOARD_ERROR`	`0x00000003`	`3`	An unexpected error occurred on the AG board. In most cases, a `DPNEVN_BOARD_ ERROR` event will occur with this error, which will contain the board error code.
`CTAERR_FATAL`	`0x00000002`	`2`	An internal error occurred in the CT Access library. Please contact NMS Developer Support.
`CTAERR_FUNCTION_ACTIVE`	`0x0000000f`	`15`	An attempt was made to start an asynchronous function that is already started. Also returned if an attempt was made to get a digit or flush the digit queue while collecting digits.
`CTAERR_FUNCTION_NOT_ACTIVE`	`0x0000000e`	`14`	An attempt was made to stop or modify a function that was not running.
`CTAERR_INVALID_BOARD`	`0x0000001a`	`26`	The specified AG board number has not been successfully configured.
`CTAERR_INVALID_CTAHD`	`0x00000005`	`5`	The context handle is invalid.
`CTAERR_INVALID_CTAQUEUEHD`	`0x00000004`	`4`	Bad CTA queue ID.
`CTAERR_INVALID_SEQUENCE`	`0x00000013`	`19`	An attempt was made to stop a function that is already being stopped, or a call control function was called before receiving a response to the previous call control command, or a play or record buffer was submitted when it was not expected.
`CTAERR_INVALID_STATE`	`0x0000000c`	`12`	The function is not valid in the current port state. For example, most functions require the port to be in the `DPNSS_STATE_ STARTED` state, which is entered after starting a trunk protocol.
`CTAERR_LOCK_TIMEOUT`	`0x0000001d`	`29`	A thread lock timed out.
`CTAERR_NOT_FOUND`	`0x0000000a`	`10`	The specified parameter does not exist.
`CTAERR_OUT_OF_MEMORY`	`0x00000006`	`6`	Unable to allocate memory for driver or port context, for play or record buffers, or for temporary storage. When this error occurs in a `DONE` event, it may mean that there was insufficient memory on the AG board.
`CTAERR_OUT_OF_RESOURCES`	`0x00000008`	`8`	Unable to create shared resources.
`CTAERR_OUTPUT_ACTIVE`	`0x0000001b`	`27`	An attempt to open a port failed because the stream and slot are already opened on another port, or an output operation (such as play) failed because there is another active output function.
`CTAERR_SHAREMEM_ACCESS`	`0x00000010`	`16`	Failed attempt to access shared memory.
`DPNERR_ CHANNEL_ID_ALREADY_EXISTS`	`0x001400C9`	`1310921`	The DPNSS server process detected an internal failure. Please contact NMS Developer Support.
`DPNERR_CANNOT_CONNECT`	`0x00140068`	`1310824`	Unable to establish a connection with the DPNSS server process. Please contact NMS Developer Support.
`DPNERR_CANNOT_CREATE_CHANNEL`	`0x00140006`	`1310726`	Unable to create a channel to the board due to either board or driver limitations. Please contact NMS Developer Support.
`DPNERR_CANT_FREE_TIMESLOT`	`0x001400CB`	`1310923`	The DPNSS server process detected an internal failure. Please contact NMS Developer Support.
`DPNERR_CHANNEL_NOT_OPENED`	`0x00140065`	`1310821`	Connection with the DPNSS server process has not been established. Please contact NMS Developer Support.
`DPNERR_COMM_FAILURE`	`0x00140064`	`1310820`	Unable to communicate with the DPNSS server process. Please contact NMS Developer Support.
`DPNERR_INCONSISTENT_MESSAGE`	`0x00140072`	`1310828`	A message received from the DPNSS server process cannot be interpreted. Please contact NMS Developer Support.
`DPNERR_INVALID_CALL_STATE`	`0x00140005`	`1310725`	The function is not valid in the current call state. For example, many functions require the call to be in the `DPNSS_ CC_STATE_ CONNECTED` state.
`DPNERR_MUTEX_ERROR_ON_CHANNEL`	`0x001400CA`	`1310922`	The DPNSS server process detected an internal failure. Please contact NMS Developer Support.
`DPNERR_OUT_OF_EVENT_BUFFER`	`0x00140071`	`1310827`	Too many event buffers allocated. The application must release incoming DPNSS SIS buffer lists received with events (using dpnReleaseBuffer).
`DPNERR_OWNER_CONFLICT`	`0x00140066`	`1310822`	The desired stream/ timeslot is already allocated by another process. Please contact NMS Developer Support.
`DPNERR_SERVER_TIMEOUT`	`0x00140069`	`1310825`	A timeout occurred waiting for an answer from the DPNSS server process. Please contact NMS Developer Support.
`DPNERR_TIMESLOT_BARRED`	`0x00140073`	`1310829`	A timeslot is barred.
`DPNERR_TRANSIT_NOT_SAME_QUEUE`	`0x00140070`	`1310826`	The two ctahd specified when calling dpnSetTransitActive are not attached to the same CT Access queue.
`DPNERR_UNKNOWN_SERVER_RESPONSE`	`0x00140067`	`1310823`	The DPNSS server process responded with incorrect data. Please contact NMS Developer Support.
`DPNERR_WRONG_CHANNEL_ID`	`0x001400C8`	`1310920`	The DPNSS server process detected an internal failure. Please contact NMS Developer Support.

Numerical Error Summary

The following table is a list of DPNSS service errors in numerical order: Hex Decimal Error Name 0x00000002 2 CTAERR_FATAL 0x00000003 3 CTAERR_BOARD_ERROR 0x00000004 4 CTAERR_INVALID_CTAQUEUEHD 0x00000005 5 CTAERR_INVALID_CTAHD 0x00000006 6 CTAERR_OUT_OF_MEMORY 0x00000007 7 CTAERR_BAD_ARGUMENT 0x00000008 8 CTAERR_OUT_OF_RESOURCES 0x0000000a 10 CTAERR_NOT_FOUND 0x0000000c 12 CTAERR_INVALID_STATE 0x0000000e 14 CTAERR_FUNCTION_NOT_ACTIVE 0x0000000f 15 CTAERR_FUNCTION_ACTIVE 0x00000010 16 CTAERR_SHAREMEM_ACCESS 0x00000013 19 CTAERR_INVALID_SEQUENCE 0x0000001a 26 CTAERR_INVALID_BOARD 0x0000001b 27 CTAERR_OUTPUT_ACTIVE 0x0000001d 29 CTAERR_LOCK_TIMEOUT 0x00140005 1310725 DPNERR_INVALID_CALL_STATE 0x00140006 1310726 DPNERR_CANNOT_CREATE_CHANNEL 0x00140064 1310820 DPNERR_COMM_FAILURE 0x00140065 1310821 DPNERR_CHANNEL_NOT_OPENED 0x00140066 1310822 DPNERR_OWNER_CONFLICT 0x00140067 1310823 DPNERR_UNKNOWN_SERVER_RESPONSE 0x00140068 1310824 DPNERR_CANNOT_CONNECT 0x00140069 1310825 DPNERR_SERVER_TIMEOUT 0x00140070 1310826 DPNERR_TRANSIT_NOT_SAME_QUEUE 0x00140071 1310827 DPNERR_OUT_OF_EVENT_BUFFER 0x00140072 1310828 DPNERR_INCONSISTENT_MESSAGE 0x00140073 1310829 DPNERR_TIMESLOT_BARRED 0x001400C8 1310920 DPNERR_WRONG_CHANNEL_ID 0x001400C9 1310921 DPNERR_ CHANNEL_ID_ALREADY_EXISTS 0x001400CA 1310922 DPNERR_MUTEX_ERROR_ON_CHANNEL 0x001400CB 1310923 DPNERR_CANT_FREE_TIMESLOT

Hex	Decimal	Error Name
`0x00000002`	`2`	`CTAERR_FATAL`
`0x00000003`	`3`	`CTAERR_BOARD_ERROR`
`0x00000004`	`4`	`CTAERR_INVALID_CTAQUEUEHD`
`0x00000005`	`5`	`CTAERR_INVALID_CTAHD`
`0x00000006`	`6`	`CTAERR_OUT_OF_MEMORY`
`0x00000007`	`7`	`CTAERR_BAD_ARGUMENT`
`0x00000008`	`8`	`CTAERR_OUT_OF_RESOURCES`
`0x0000000a`	`10`	`CTAERR_NOT_FOUND`
`0x0000000c`	`12`	`CTAERR_INVALID_STATE`
`0x0000000e`	`14`	`CTAERR_FUNCTION_NOT_ACTIVE`
`0x0000000f`	`15`	`CTAERR_FUNCTION_ACTIVE`
`0x00000010`	`16`	`CTAERR_SHAREMEM_ACCESS`
`0x00000013`	`19`	`CTAERR_INVALID_SEQUENCE`
`0x0000001a`	`26`	`CTAERR_INVALID_BOARD`
`0x0000001b`	`27`	`CTAERR_OUTPUT_ACTIVE`
`0x0000001d`	`29`	`CTAERR_LOCK_TIMEOUT`
`0x00140005`	`1310725`	`DPNERR_INVALID_CALL_STATE`
`0x00140006`	`1310726`	`DPNERR_CANNOT_CREATE_CHANNEL`
`0x00140064`	`1310820`	`DPNERR_COMM_FAILURE`
`0x00140065`	`1310821`	`DPNERR_CHANNEL_NOT_OPENED`
`0x00140066`	`1310822`	`DPNERR_OWNER_CONFLICT`
`0x00140067`	`1310823`	`DPNERR_UNKNOWN_SERVER_RESPONSE`
`0x00140068`	`1310824`	`DPNERR_CANNOT_CONNECT`
`0x00140069`	`1310825`	`DPNERR_SERVER_TIMEOUT`
`0x00140070`	`1310826`	`DPNERR_TRANSIT_NOT_SAME_QUEUE`
`0x00140071`	`1310827`	`DPNERR_OUT_OF_EVENT_BUFFER`
`0x00140072`	`1310828`	`DPNERR_INCONSISTENT_MESSAGE`
`0x00140073`	`1310829`	`DPNERR_TIMESLOT_BARRED`
`0x001400C8`	`1310920`	`DPNERR_WRONG_CHANNEL_ID`
`0x001400C9`	`1310921`	`DPNERR_` `CHANNEL_ID_ALREADY_EXISTS`
`0x001400CA`	`1310922`	`DPNERR_MUTEX_ERROR_ON_CHANNEL`
`0x001400CB`	`1310923`	`DPNERR_CANT_FREE_TIMESLOT`

(Page 1 of 1 in this chapter) Version

tech_support@nmss.com