Introduction

This appendix provides a summary of Point-to-Point Switching service error codes and event codes.

The Point-to-Point Switching service error and event codes are defined in the include file ppxdef.h . The CT Access and the Switching service error codes are defined in the include files ctaerr.h and swidef.h.

All CT Access functions return a status code. If the return code is not SUCCESS (0), it is an error code indicating that the function has failed and a reason for the failure.

The SWIERR_ and CTAERR_DRIVER_ERROR errors returned by some Point-to-Point Switching functions may be returned from calls made by the Point-to-Point Switching service to swiSendPattern, swiDisableOutput, or swiMakeConnection. If these errors occur, validate that the bus streams and timeslots defined within the ppx.cfg file are accurate, in both the bus definition(s) and within the switch definition for INPUTS and OUTPUTS.

The error codes are presented in two tables:

• Alphabetical, by error code name, including a description of the problem and a possible solution.

• Numerical, by hexadecimal value, decimal value, and error name.

The following table is an alphabetical listing of Point-to-Point Switching errors. All errors are 32 bits.

Error Name	Hex Value	Decimal Value	Description
PPXERR_CFG_FAILED	0xD0004	851972	The PPX configuration file has an error.
PPXERR_COMM_FAILURE	0xD000A	851978	Cannot communicate with PPX server.
PPXERR_CONN_OWNERSHIP	0xD000E	851982	An attempt was made to disconnect a connection where the listener point is not owned by the calling application or the connection was nailed up.
PPXERR_CONNECTION_ALREADY_EXISTS	0xD0002	851970	The specified connection already exists.
PPXERR_DISABLED	0xD000F	851983	The specified switch has been disabled.
PPXERR_DRIVER_OPEN_FAILED	0xD000C	851980	The driver open failed, or the driver DLL or device was not found. Validate that the DeviceName and DeviceNumber fields are accurate in the ppx.cfg switch definitions.
PPXERR_INVALID_COMMAND	0xD0000	851968	Invalid command in a Begin/Submit block.
PPXERR_INVALID_COUNT	0xD0009	851977	Number of listeners in array of listeners does not match the count specified.
PPXERR_INVALID_SWITCH	0xD000B	851979	Switch number specified is inaccessible from the specified bus, stream, and timeslot.
PPXERR_LISTENER_BUSY	0xD0001	851969	The listener is already connected to a connection block or the listener is already configured as an input.
PPXERR_NO_PATH	0xD0005	851973	Cannot find a connection path between the two endpoints.
PPXERR_NOT_CONNECTED	0xD000D	851981	The listener is not receiving input from the talker.
PPXERR_NOT_LISTENER	0xD0007	851975	The listener is not capable of receiving output from the connection.
PPXERR_NOT_TALKER	0xD0008	851976	The talker is not capable of driving output to the connection.
PPXERR_UNKNOWN_SWITCHTYPE	0xD0003	851971	The switch type is invalid. Check the PPX configuration file.

The following table is a list of Point-to-Point Switching service errors in numerical order:

Hex Value	Decimal Value	Error Name
0xD0000	851968	PPXERR_INVALID_COMMAND
0xD0001	851969	PPXERR_LISTENER_BUSY
0xD0002	851970	PPXERR_CONNECTION_ALREADY_EXISTS
0xD0003	851971	PPXERR_UNKNOWN_SWITCH_TYPE
0xD0004	851972	PPXERR_CFG_FAILED
0xD0005	851973	PPXERR_NO_PATH
0xD0006	851974	PPXERR_INCOMPLETE
0xD0007	851975	PPXERR_NOT_LISTENER
0xD0008	851976	PPXERR_NOT_TALKER
0xD0009	851977	PPXERR_INVALID_COUNT
0xD000A	851978	PPXERR_COMM_FAILURE
0xD000B	851979	PPXERR_INVALID_SWITCH
0xD000C	851980	PPXERR_DRIVER_OPEN_FAILED
0xD000D	851981	PPXERR_NOT_CONNECTED
0xD000E	851982	PPXERR_CONN_OWNERSHIP
0xD000F	851983	PPXERR_DISABLED

ppxSubmit is an synchronous function which returns the event PPXEVN_SUBMIT_COMPLETE.

The value field contains either SUCCESS or the first non-SUCCESS response issued by the commands included in the ppxBegin/ppxSubmit block.