CoDeSys SP V3.

x
Runtime Error Codes

tech_doc_e.doc / V1.2

Document Version 1.0

3S - Smart Software Solutions GmbH

Runtime Error Codes.doc

Page 1 of 8

Runtime Error Codes

CONTENT
1

RUNTIME ERROR CODES

3
8

tech_doc_e.doc / V1.2

CHANGE HISTORY

3S - Smart Software Solutions GmbH

Runtime Error Codes.doc

Page 2 of 8

Runtime Error Codes

Runtime Error Codes

tech_doc_e.doc / V1.2

The following constants are used by the CoDeSys SP V3.x runtime system as error codes.
Value

Description

Variable name

No error

ERR_OK

General error - to be used only for internal errors

ERR_FAILED

An invalid parameter was passed to a function.

ERR_PARAMETER

Function cannot be executed, since component

has not been initialized yet. It may work later,
though

ERR_NOTINITIALIZED

Version conflict

ERR_VERSION

Operation timed out

ERR_TIMEOUT

Insufficient memory to carry out the request

ERR_NOBUFFER

10

For asynchronous calls: call not yet complete

ERR_PENDING

11

To many pending calls. Try later

ERR_NUMPENDING

12

The function is not implemented

ERR_NOTIMPLEMENTED

13

No object with the provided id found

ERR_INVALIDID

14

Integer overflow

ERR_OVERFLOW

15

The size of a buffer is to small or invalid

ERR_BUFFERSIZE

16

No object with this specified name available

ERR_NO_OBJECT

17

No heap memory available

ERR_NOMEMORY

18

An object with the same name is still available

ERR_DUPLICATE

19

Heap memory was written out of bounds! Memory

overwrite error

ERR_MEMORY_OVERWRITE

20

Invalid handle to an object

ERR_INVALID_HANDLE

21

End of object reached

ERR_END_OF_OBJECT

22

No changes done

ERR_NO_CHANGE

23

Invalid or unknown interface

ERR_INVALID_INTERFACE

24

Functionality not supported

ERR_NOT_SUPPORTED

25

No access rights for this operation

ERR_NO_ACCESS_RIGHTS

26

Specified limits of a resource exceeded

ERR_OUT_OF_LIMITS

27

Remaining entries that could not be transmitted

because of buffer limitation

ERR_ENTRIES_REMAINING

28

Invalid online session id

ERR_INVALID_SESSION_ID

29

Exception occurred

ERR_EXCEPTION

30

Signature mismatch of an API function

ERR_SIGNATURE_MISMATCH

31

Version mismatch

ERR_VERSION_MISMATCH

32

Type mismatch

ERR_TYPE_MISMATCH

33

ID mismatch

ERR_ID_MISMATCH

34

Consistency error

ERR_NO_CONSISTENCY

3S - Smart Software Solutions GmbH

Runtime Error Codes.doc

Page 3 of 8

Runtime Error Codes

Value

Description

Variable name

General network errors (range: 256-271)

256

General failure of a network call

ERR_NET_FAILED

257

Connection not established or closed

ERR_NET_NOTCONNECTED

258

Message exceeds the maximum message size

ERR_NET_MSGSIZE

259

No route found

ERR_NET_NOROUTE

260

Timeout of the network call

ERR_NET_TIMEOUT

261

A network (Layer 3) package is invalid

ERR_NET_PKGINVALID

262

Invalid address

ERR_NET_INVALIDADDR

Network service errors (issued by the server of

a network service) (range 288-303)
288

The received package is not compliant with the

service specification

ERR_SVC_PKGINVALID

289

The requested service does not exist

ERR_SVC_INVALIDSERVICE

Network client errors (issued by the client of a

network service) (range: 320 - 415)
320

The received package is not compliant with the

service specification

ERR_CLNT_PKGINVALID

tech_doc_e.doc / V1.2

Channel server (PLC) errors (range: 384 - 415)

385

Channel Id invalid

ERR_CHC_CHINVALID

386

Channel closed or connect failed due to a timeout

ERR_CHC_TIMEOUT

387

Protocol error

ERR_CHC_PROTOCOL

388

Inrecoverable transmission error (checksum) etc.

ERR_CHC_CHECKSUM

389

The server application tried to send a message

although the channel is in receive mode

ERR_CHS_MODEHOST

390

Incoming message although the channel is in

send mode.

ERR_CHC_MODEPEER

391

No more channels available.

ERR_CHC_NUMCHANNELS

392

Channel closed by peer

ERR_CHC_CLOSED

393

Message exceeds the commbuffer size

ERR_CHC_MESSAGESIZE

394

The server application didn't properly handle an

incoming request

ERR_CHS_REQNOTHANDLED

400

This node is not a server node

ERR_CHS_NOTSERVER

Channel client (e.g. gateway) errors

(range: 416 - 447)
417

Channel Id invalid

ERR_CHC_CHINVALID

418

Channel closed or connect failed due to a timeout

ERR_CHC_TIMEOUT

3S - Smart Software Solutions GmbH

Runtime Error Codes.doc

Page 4 of 8

Runtime Error Codes

Value

Description

Variable name

419

Protocol error

ERR_CHC_PROTOCOL

420

Unrecoverable transmission error (checksum)

etc.

ERR_CHC_CHECKSUM

421

The client application tried to send a message

although the channel is in receive mode

ERR_CHC_MODEHOST

422

Incoming message although the channel is in

send mode

ERR_CHC_MODEPEER

423

No more channels available

ERR_CHC_NUMCHANNELS

424

Channel closed by peer

ERR_CHC_CLOSED

425

Message exceeds the communication buffer size

ERR_CHC_MESSAGESIZE

426

Not enough memory to provide the required

communication buffer

ERR_CHC_NOCHBUFFER

Gateway errors (Client-Gateway

communication) (range: 448 - 464)
448

An invalid packet was received

ERR_GW_INVALIDPKG

449

Protocol error

ERR_GW_PROTOCOL

450

Clients protocol version cannot be handled

ERR_GW_VERSION

451

The authentication modules provided by the client

are not available on the gateway

ERR_GW_NOAUTHMODULE

452

Command or command group not known by the

gateway

ERR_GW_UNKNOWNCMD

453

The request has been cancelled by a cancel

request message

ERR_GW_REQCANCELED

454

A reference to an other request is unknown (e.g.

a cancel request referring to a request that has
already been answered.

ERR_GW_REQUNKNOWN

455

The referenced request cannot be cancelled

(certain requests may not be cancelled once they
are initiated)

ERR_GW_CANCELFAILED

456

The connection handle is invalid.

ERR_GW_INVALIDCONN

457

GWClient/driver can't handle another connection.

ERR_GW_NUMCONNECTIONS

tech_doc_e.doc / V1.2

Socket errors (range: 512 - 767)

513

The provided socket handle is not initialized

ERR_SOCK_NOTINITIALIZED

514

The provided socket handle is invalid

ERR_SOCK_NOTSOCKET

515

The address family is not supported

ERR_SOCK_AFUNSUPPORTED

516

Protocol is not supported

ERR_SOCK_PROTOUNSUPPORTED

517

Not enough buffer to handle the request

ERR_SOCK_NOBUFFER

518

Socket is in non-blocking mode but this call would

block

ERR_SOCK_WOULDBLOCK

519

The provided address is already in use

ERR_SOCK_ADDRINUSE

520

The provided address is not available on this

ERR_SOCK_ADDRNOTAVAILABLE

3S - Smart Software Solutions GmbH

Runtime Error Codes.doc

Page 5 of 8

Runtime Error Codes

Value

Description

Variable name

computer
521

Connection has been refused by the remote host

ERR_SOCK_CONNREFUSED

522

Operation timed out

ERR_SOCK_TIMEDOUT

523

The host has not been found

ERR_SOCK_HOSTNOTFOUND

524

Host is unreachable

ERR_SOCK_HOSTUNREACHABLE

525

Socket is already connected

ERR_SOCK_ISCONNECTED

526

The socket is not connected

ERR_SOCK_NOTCONNECTED

527

Shutdown has been called on the socket

ERR_SOCK_SHUTDOWN

528

For sockets of type DGRAM. The package to

send exceeds the maximum package size

ERR_SOCK_MSGSIZE

529

Socket has been gracefully closed. No more

send/receives allowed

ERR_SOCK_CLOSED

L7 Protocol errors (range: 768 - 1023)

768

Tag missing in online communication buffer

ERR_L7_TAG_MISSING

769

Unknown command group

ERR_L7_UNKNOWNCMDGROUP

770

Unknown command (within a valid command

group)

ERR_L7_UNKNOWNCMD

771

Level 7 service incomplete

ERR_L7_INCOMPLETE

Errors of the BinTagUtils library

(range: 1024-1039)
1024

A nested tag reaches beyond the end of the

surrounding tag

ERR_BTAG_TAGOVERLAP

1025

A tag reaches beyond the end of the buffer

ERR_BTAG_BUFFEROVERRUN

1026

The number of nested tags exceeds the

maximum nesting depth

ERR_BTAG_MAXNESTINGDEPTH

1027

No current tag - reader/writer is at the toplevel.

ERR_BTAG_NOTAG

1028

The current tag is not a data tag

ERR_BTAG_NODATATAG

1029

The operation is allowed only on a container tag

not on a data tag

ERR_BTAG_NOCONTAINERTAG

1030

Operation only allowed on toplevel (not inside a

tag)

ERR_BTAG_NOTTOPLEVEL

1031

Invalid alignment

ERR_BTAG_ALIGNMENT

tech_doc_e.doc / V1.2

Errors of the Application component

(range: 1280-1295)
1280

Application with same name exists

ERR_APP_EXISTS

1281

Application not available

ERR_APP_NOT_EXIST

1282

Invalid session id

ERR_APP_INVALID_SESSIONID

1283

Invalid data id of application. Data don't match!

ERR_APP_INVALID_DATAID

1284

Application not loaded

ERR_APP_NOT_LOADED

3S - Smart Software Solutions GmbH

Runtime Error Codes.doc

Page 6 of 8

Runtime Error Codes

Value

Description

Variable name

1285

no session id specified

ERR_APP_NO_SESSIONID

1286

unresolved external function

ERR_APP_UNRESOLVED_REFERENCE

1287

signature mismatch

ERR_APP_SIGNATURE_MISMATCH

1288

loading retain data failed

ERR_APP_LOAD_RETAIN_DATA_FAILED

1289

Version mismatch of an external lib function

ERR_APP_VERSION_MISMATCH

1290

Retain mismatch of the retain area

ERR_APP_RETAIN_MISMATCH

1291

Ask, if single cycle should be done on breakpoint

ERR_APP_SINGLECYCLE_ON_BREAKPOINT

FileTransfer errors
2048

File size don't match

ERR_FT_FILE_SIZE_MISMATCH

2049

CRC of file don't match

ERR_FT_CRC_MISMATCH

IecVarAccess errors
2304

Unknown symbolic node type

ERR_IECVARACC_UNKNOWN_NODE_TYPE

2305

No child not available

ERR_IECVARACC_NO_CHILD_NODE

Monitoring errors - For use in the monitoring

reply packages only. Not to be mixed with the
standard ERR_xxx result values. These errors
values must not exceed a single byte (ie. <= 255)
No Error

MONITORING_ERR_OK

The area id is invalid

MONITORING_ERR_INVALID_AREA

The requested datatype not supported

MONITORING_ERR_UNSUPPORTED_DATATYPE

Monitoring size was zero.

MONITORING_ERR_SIZE_0

Application is not in state

HALTED_ON_BREAKPOINT

MONITORING_ERR_NOBP

Invalid Pointer was monitored

MONITORING_ERR_INVALID_POINTER

Too many nestings

MONITORING_ERR_NESTING_DEPTH

255

Unknown error

MONITORING_ERR_UNKNOWN

tech_doc_e.doc / V1.2

3S - Smart Software Solutions GmbH

Runtime Error Codes.doc

Page 7 of 8

Runtime Error Codes

Change History
Description

Editor

Date

0.1

Issued

MN

18.07.2007

0.2

Update on status codesys V3.2

MN

29.02.2008

0.3

Update

AK

04.03.2008

1.0

Formal Review, minor corrections, Release

MN

04.03.2008

tech_doc_e.doc / V1.2

Version

3S - Smart Software Solutions GmbH

Runtime Error Codes.doc

Page 8 of 8