Lon - LNS Error Codes

LNS Error Codes

Object Server Errors

These errors are returned by the Object Server component. These errors will appear in the

format LCA: #<Error Number>.

 

lcaErrStringInvalidSize LNS, #1

A string passed did not match the required size, or exceeded the maximum size.

 

lcaErrInvalidType LNS, #2

An argument was passed with the wrong data type, or an assignment to a property has been

made using an inappropriate data type.

 

lcaErrDuplicateKey LNS, #3

This error indicates that the object with this key or name already exists. Names or Keys of items

being explicitly added to a collection object must be unique. It should be noted that this

restrictions does not apply to implicitly added items.

 

lcaErrInvalidOleObject LNS, #4

An invalid OLE object has been passed to the object server by making assignments to LNS

properties or calls to LNS methods.

 

lcaErrUninitializedDb LNS, #5

Contact technical support.

 

lcaErrObjectNotFound LNS, #6

An object has been requested by name or index that could not be found in the databases.

Typically, this would be a request from a LNS collection object with a bad name or index.

It should be noted that this error can also occur in some implicit assignments. For example, if

the network interface to be used has not been explicitly assigned to the appropriate property,

LNS will continue using the network interface previously assigned to the ActiveRemoteNI or

NetworkInterface property, respectively.

In such a scenario, this exception could occur even though no explicit assignment has been

made, indicating that an implicit assignment maps to an unavailable object.

 

lcaErrCannotCreateObject LNS, #7

The Object Server was unable to created the object.

 

lcaErrInternal LNS, #8

An unexpected error occurred. Please contact technical support on LonSupport@Echelon.com

 

lcaErrFeatureNotAvailible LNS, #9

A feature has been accessed which is not available in the current operating mode. Most likely,

this error message is caused by an attempt to access properties that are not available to remote

clients.

 

lcaErrFileOpen LNS, #10

The Object Server is attempting to open a file that is already opened by another application.

 

lcaErrBadApbFile LNS, #11

The file containing the binary version of the downloadable application image has been

corrupted. The device manufacturer should be contacted for providing a valid APB file, of said

file should be re-built using the NEURON C compiler and linker.

Alternatively, the APB file can be re-build using the NXE32BIN.EXE utility, which itself requires

the NXE and XFB files as input data.

 

lcaErrBadOrMissingXif LNS, #12

The file containing the external interface information of the device has been corrupted, or is

missing. The device manufacturer should be contacted to provide a valid XIF file, or the file

should be re-built using the Neuron C compiler and linker.

Alternatively, the device could be installed using an "Ad-Hoc" installation scenario, in which XIF

files are not required. This requires the device to be available, online, functioning, and not

having the self-documentation features disabled.

 

lcaErrBadOrMissingXfb LNS, #13

The file containing the binary version of the external interface file has been corrupted, or is

missing. The device manufacturer should be contacted for providing a valid APB file, or the file

should be re-built using the NEURON C compiler and linker.

Alternatively, the XFB file might be re-build from the XIF file, using the XIF32BIN.EXE utility.

 

lcaErrInvalidPgmType LNS, #14

The ProgramType property contains an invalid value.

 

lcaErrInvalidCollectionIndex LNS, #15

A query to an LNS collection object has been made using an invalid index number. The range of

valid indices starts with 1 and ends with the current item count.

 

lcaErrCannotUpdateUnattachedObject LNS, #16

An attempt was made to update a device that is not attached to the network.

 

lcaErrCannotUpdateWhenOffnet LNS, #17

An action has been requested that can’t be performed while the network management mode is

set to the lcaMgmtModeDeferConfigUpdates (1). Change the MgmtMode property of the

System object to lcaMgmtModePropagateConfigUpdates (0) to allow this action to be

performed.

 

lcaErrCannorRemoveReservedSubsystem LNS, #18

An attempt has been made to remove a reserved Subsystem object. Such Subsystem objects are

all subsystem objects in the "ALL" and "Discovered" subsystems. Other read-only subsystems

collection objects are the Router object's Subsystems property and the AppDevice object's

Subsystems property.

 

lcaErrCannotAddToReservedSubsystem LNS, #19

An attempt has been made to add a subsystem object to a reserved subsystem area. Such areas

are all subsystem objects in the "ALL" and "Discovered" subsystems. Other read-only

subsystems collection objects are the Router object's Subsystems property and the AppDevice

object's Subsystems property.

 

lcaErrInvalidPath LNS, #20

An invalid subsystem path has been specified.

 

lcaErrDatabaseExists LNS, #21

An attempt has been made to create a database that already exists. The database path should

be changed to point to a different location.

 

lcaErrDatabaseNoAccess LNS, #22

Access to the database files has been denied by the operating system. When using operating

systems with file security, access permissions should be granted to applications with the

appropriate system tools.

 

lcaErrDatabasePathTooLong LNS, #23

The database path passed to the Networks collection's Add method is too long. The path to a

network database must not exceed 26 characters.

 

lcaErrMaxClientsExceeded LNS, #24

The LNS maximum of 254 simultaneous clients has been exceeded.

 

lcaErrDatabase LNS, #25

An unexpected database error occurred. Please take a note of the full error message, and

contact technical support at LonSupport@Echelon.com

 

LcaErrInvalidDeviceTemplate LNS, #26

The DeviceTemplate object has been corrupted.

 

lcaErrNoDatabase LNS, #27

The network database has not been found in the location previously registered.

 

lcaErrNoDbDictionary LNS, #28

The LNS dictionary files _objects.dat and _objects.idx are missing, or they can not be found. The

default location is C:\LONWORKS\ObjectServer\Dictionary.

 

lcaErrInvalidSystemObject LNS, #29

The System object associated with this network database is invalid. To resolve this, the network

database must be rebuilt from scratch.

 

lcaErrNetworkDbNotOpen LNS, #30

A service has been requested prior to invoking the Network object's Open method.

 

lcaErrCannotRemoveSubsystemWithDevices LNS, #31

An attempt to remove a subsystem that still contains AppDevice or Router objects has been

made. These objects must be removed first.

 

lcaErrObjectLocked LNS, #32

An attempt has been made to modify an object that has been internally locked by LNS.

 

lcaErrCantCreateDbServer LNS, #33

This error is returned by a remote client when the host is unable to launch the LNS Server.

 

lcaErrUnsupportedEvent LNS, #34

Unsupported variant type.

 

lcaErrGeneric LNS, #35

Contact customer support.

 

lcaErrDbServer LNS, #36

An LNS Server error. Contact customer support.

 

lcaErrCommissionCausesReplace LNS, #37

An attempt has been made to commission a device after changing the device’s Neuron ID. In

this situation, the Replace method should be used.

 

lcaErrAppdeviceRequired LNS, #38

The Object Server was unable to communicate with the Appdevice.

 

lcaErrWrongWriteDataSize LNS, #39

Contact customer support.

 

lcaErrInvalidFormat LNS, #40

Contact customer support.

 

lcaErrCompiler LNS, #41

Generic compiler error. See the LNS Field Compiler documentation for details.

 

lcaErrProjectMgrNotAvailable LNS, #42

The LNS Field Compiler's project manager and dependency checker is unavailable. See the LNS

Field Compiler documentation for details.

 

lcaErrInvalidLinkerOptions LNS, #43

The options passed to the NEURON Linker were invalid. See the LNS Field Compiler

documentation for details.

 

lcaErrInvalidBuildTemplate LNS, #44

The BuildTemplate object is invalid, as it does not comply with the requirements and constraints

of the LNS Field Compiler. See the LNS Field Compiler documentation for details.

 

lcaErrInvalidHardwareTemplate LNS, #45

The HardwareTemplate object is invalid, as it does not comply with the requirements and

constraints of the LNS Field Compiler. See the LNS Field Compiler documentation for details.

 

lcaErrInvalidProgramTemplate LNS, #46

The ProgramTemplate object is invalid, as it does not comply with the requirements and

constraints of the LNS Field Compiler. See the LNS Field Compiler documentation for details.

 

lcaErrInvalidExportOption LNS, #47

The options passed to the Neuron Exporter were invalid. See the LNS Field Compiler

documentation for details.

 

lcaErrCantCallDtssComponent LNS, #48

An attempt to communicate with a LNS Device Control failed.

 

lcaErrCantLoadDevice LNS, #49

The application could not be loaded into the device.

 

lcaErrCantRemoveFromReservedSubsystem LNS, #50

An attempt has been made to remove an item from a reserved subsystem. Reserved subsystems

are all subsystem objects in the "ALL" and "Discovered" subsystems.

Other read-only subsystems collection objects are the Router object's Subsystems property and

the AppDevice object's Subsystems property.

 

lcaErrDeviceTemplatePgmMismatch LNS, #51

The program ID from the DeviceTemplate object does not match the one found on the device

during an attempt to commission the device.

 

lcaErrMustSetNeuronIdFirst LNS, #52

The Neuron ID of an object must be set prior to querying this property or invoking the method.

This error will occur if you invoke the Test method on an AppDevice or Router object before

setting the object’s Neuron ID.

 

lcaErrInvalidOnDiscoveredDevice LNS, #53

Operation is invalid on a discovered device. You can only perform the requested operation on a

device that resides in a user subsystem (i.e. not in one of the discovered subsystems).

 

lcaErrCantCopyLNSDirectory LNS, #54

Internal error. Contact customer support.

 

lcaErrCantRecoverNotNewDb LNS, #55

A call to the RecoverFromNetwork method has been made, using a previously used network

database. For the recovery process, a newly created network database is required.

 

lcaErrCantRecoverMissingLNSDbFiles LNS, #56

Some parts of the network database are lost and can not be recovered. The network must be

re-build from scratch, if no database backup is available.

 

lcaErrCompilerInit LNS, #57

Initialization of the NEURON C Compiler failed. See the LNS Field Compiler documentation for

details.

 

lcaErrAssembler LNS, #58

Generic error message, indicating an unspecified NEURON Assembler error. See the LNS Field

Compiler documentation for details.

 

lcaErrAssemblerInit LNS, #59

Initialization of the NEURON Assembler failed. See the LNS Field Compiler documentation for

details.

 

lcaErrLinker LNS, #60

Generic error message, indicating an unspecified NEURON Linker error. See the LNS Field

Compiler documentation for details.

 

lcaErrLinkerInit LNS, #61

Initialization of the NEURON Linker failed. See the LNS Field Compiler documentation for details.

 

lcaErrExport LNS, #62

Generic error message, indicating an unspecified NEURON Exporter error. See the LNS Field

Compiler documentation for details.

 

lcaErrExportInit LNS, #63

Initialization of the NEURON Exporter failed. See the LNS Field Compiler documentation for

details.

 

lcaErrGlobalDbNotOpen LNS, #64

An attempt has been made to obtain a service from LNS prior to opening the LNS global

database. This database can be opened and closed by opening and closing the ObjectServer

object.

 

lcaErrOnlyAllowedOnHostIntf LNS, #65

The requested operation is only allowed on an Interface object contained by a device that

supports dynamic network variables, dynamic message tags, or dynamic LonMarkObjects.

 

lcaErrAnotherNetworkAlreadyOpen LNS, #66

An attempt to open a network database failed because another network object is still held open

by the same client process. This error should not occur in LNS 3 or greater. If it does, contact

customer support.

 

lcaErrSystemNotOpen LNS, #67

A service that requires the system to be open has been accessed prior to successfully opening

the System object. There are many circumstances that could cause this. For example, if you call

the Validate method to validate a network database before opening the system, or if you call the

Backup method to copy a network database before opening the system, this exception will be

thrown.

 

lcaErrDbConversionRequired LNS, #68

The global database or local database is from an older version of LNS, and the appropriate

CompactDb method must be called prior to opening the object. The CompactDb method will

compact the database, reorganize its contents, and automatically upgrade to the latest version.

 

lcaErrPropertyCantBeSetWhenOpen LNS, #69

An attempt has been made to change a property while the associated key object (the System,

Network, or ObjectServer object) is open. This property requires the object to be closed prior to

accepting changes.

 

lcaErrCantRecoverReadOnlyFile LNS, #70

Contact customer support.

 

lcaErrStringIsEmpty LNS, #71

Contact customer support.

 

lcaErrWrongServerDll LNS, #72

This error may occur if the RemoteFlag property is set to False in an application that has been

distributed as an LNS Remote redistributable. Other occurrences of this error should be reported

to customer support.

 

lcaErrInvalidProgramType LNS, #73

Contact customer support.

 

lcaErrNotAvailableOnRemoteClient LNS, #74

The requested property of method is not available on the remote client.

 

lcaErrDuplicateApplicationName LNS, #75

The value assigned to the ApplicationName property was invalid, as it already exists.

 

lcaErrCantRecoverNotAttachedToNetIntf LNS, #76

Recovery fails due to a lack of an LNS network interface.

 

lcaErrDevTemplateWithThisProgramExists LNS, #77

Implicit or explicit creation of a DeviceTemplate object failed due to the program ID already

being in use with a different device template in the same network database.

The program ID is a unique identifier for each device type (i.e. device template object). Devices

certified by the LonMark Interoperability Association will have a unique program id, using a

globally unique manufacturer ID allocated by LonMark.

 

lcaErrCantCreateLcaServer LNS, #78

The LNS Server cannot be created.

 

lcaErrCantLaunchLcaServer LNS, #79

The LNS Server cannot be launched.

 

lcaErrNoMemory LNS, #80

No more system memory available.

 

lcaErrDbInvalidVersion LNS, #81

The database has an invalid version. Note that LNS databases can be upgraded using the

CompactDb method, but also note that LNS databases are not backwards compatible. Once

updated to version N+1, the database will not be accessible for a version N client any more.

 

lcaErrDictionaryInvalidVersion LNS, #82

The LNS database dictionary files are using an invalid version.

 

lcaErrDbAndDictionaryMismatch LNS, #83

The LNS dictionary files do not match the requirements of the global database and network

database. After making a backup copy, try upgrading the databases using the CompactDb

method. Note that LNS databases can be upgraded using the CompactDb method, but also note

that LNS databases are not backwards compatible. Once updated to version N+1, the database

will not be accessible for a version N client any more.

 

lcaErrCouldNotOpenNeuronCFile LNS, #84

The NEURON C source code file could not be opened. It may be locked by another application, it

may be corrupted, or the operating system's security mechanism might prevent LNS from

accessing the file.

 

lcaErrCouldNotOpenLangResourceFile LNS, #85

The language resource file, which is part of the LonMark device resource files, could not be

opened. It may be locked by another application, it may be corrupted, or the operating system's

security mechanism might prevent LNS from accessing the file.

 

lcaErrCouldNotOpenFuncProfileFile LNS, #86

The functional profile template file, which is part of the LonMark device resource files, could not

be opened. It may be locked by another application, it may be corrupted, or the operating

system's security mechanism might prevent LNS from accessing the file.

 

lcaErrStringInvalidChar LNS, #87

The string passed contains one of more characters that are invalid in the current environment.

For example, file names must follow, style conventions taken from the Windows operating

system on the PC running an application. When writing to the Name property of any object, use

of the forward slash (/), back slash (\), period (.), and colon (:) characters will cause this

exception to be thrown.

 

lcaErrAuthKeyNotSet LNS, #88

The authentication key has not been set prior to accessing authenticated objects. Such an object

can be any AppDevice or Router object, including the LNS Server itself. Note that prior to

opening a remote system, a remote client needs to specify the authentication key.

 

lcaErrReadOnlyCollection LNS, #89

An attempt to change a member of a read-only collection has been made. Such collection

objects do not support adding or removing items at runtime. It should be noted that this

exception may also occur with collections which are usually write-enabled, as the context might

not allow for changes.

For example, the Subsystems collection would typically be seen in the hierarchy

System::Subsystems context, to which further items can be added using the Subsystems

collection's Add method. The AppDevice and Router object's Subsystems collection objects,

however, represent all subsystem objects to which the device belongs. Such a collection would

be a read-only collection in this particular context, and a write-enabled collection in another

context.

 

lcaErrValueOutOfRange LNS, #90

The value supplied to the property exceeds the range limit for that property.

 

lcaErrCantUpdateWhenPaused LNS, #91

A requested service cannot be completed due to the DataServer being paused. DsPause should

be set to FALSE to re-start the DataServer.

 

lcaErrCantCreateLcaMonitor LNS, #92

The Lca Monitor, a utility component for internal purposes, could not be created. This failure is

caused by a lack of memory available to LNS.

 

lcaErrCantLaunchLcaMonitor LNS, #93

The Lca Monitor, a utility component for internal purposes, could not be launched. This utility,

LCAMON.EXE, would typically be located in the C:\LONWORKS\Bin folder, which must be part of

the search path or otherwise visible from the working directory of the calling tool. The 93

exception would indicate any problem launching the LCA Monitor utility tool like memory

shortage, bad permissions, executable not found, etc.

 

lcaErrMustSetDsPauseToChange LNS, #94

The DataServer must be paused prior to applying the requested changes. Use DsPause to pause

the DataServer.

 

lcaErrNotAvailableOnLocalClient LNS, #95

A service only available to remote clients has been requested from a local client.

 

lcaErrObjectDeleted LNS, #96

The object has been deleted.

 

lcaErrInvalidRmcObject LNS, #97

Invalid object received through remote procedure call. Contact customer support.

 

lcaErrInvalidRmcServer LNS, #98

Contact customer support.

 

lcaErrInvalidRmcClient LNS, #99

Contact customer support.

 

lcaErrInvalidRmcVersion LNS, #100

The client and server are running different versions of LNS and the Object Server was unable to

compensate.

 

lcaErrInvalidRmcMethod LNS, #101

Contact customer support.

 

lcaErrNeuronIdInUse LNS, #102

The Neuron ID assigned is already being used by another device in the network.

 

lcaErrDbCantBeCompactedWhenOpen LNS, #103

CompactDb() methods must be called prior to opening the associated object.

 

lcaErrDbCantBeRemovedWhenInUse LNS, #104

The object can not be removed as it still is in use.

 

lcaErrCantRemoveDefaultAccount LNS, #105

The default Account object can not be removed.

 

lcaErrCantRemoveAccountWithCharges LNS, #106

An account object needs to be empty when being removed.

 

lcaErrCantRemoveLNSNode LNS, #107

The device can not be removed, as it is associated with the network interface currently in use.

 

lcaErrCantConnectToServer LNS, #108

The remote client fails to connect to the LNS Server.

 

lcaErrTcpSocketError LNS, #109

An unspecified socket error occurred, causing the IP connection to be lost.

 

lcaErrBadPermissionFormat LNS, #110

Malformed data was assigned to the PermissionString property.

 

lcaErrCantModifyInSharedMode LNS, #111

An attempt has been made to modify a shared DataServer property. Change the DsMode

property to enter exclusive mode, or refrain from modifying the property.

 

lcaErrDataUnderrun LNS, #112

An IP remote client did not receive expected data in time. The connection might be lost.

 

lcaErrDataOverrun LNS, #113

An IP remote client received unexpected data. The configuration should be verified.

 

lcaErrIllegalInTransaction LNS, #114

A service that can not be part of an explicit transaction has been requested within an explicit

transaction. Complete or dismiss the transaction using the CancelTransaction method or

CommitTransaction method prior to invoking this service.

 

lcaErrNoPermission LNS, #115

Permission to an item has been requested and denied. Use the PermissionString property local

to the server to change permission preferences.

 

lcaErrStaleObject LNS, #116

An attempt was made to modify or use a stale LNS object.

For example, once the system object has been successfully closed, all objects accessed through

the system object will be stale, and should be de-referenced. Or, if the Network Service Device

has been replaced, all collection objects accessed before the replacement will be stale, and

should be de-referenced.

 

lcaErrNotAvailableOnTcpClient LNS, #117

A service which is only available local to the server or on a Full client has been requested from a

Lightweight client.

 

lcaErrNotAnNsiHost LNS, #118

The (hosted) device does not execute the NSI firmware, and as a result, the requested service

can not be completed.

 

lcaErrInterfaceNotModifyable LNS, #119

An attempt to dynamically modify a static interface was made. This error will occur if you

attempt to use the Add method to define a dynamic LonMarkObject on a device that does not

support dynamic function blocks.

To support dynamic interface modifications, you can implement the wink command extensions

as documented in the LonMark Application Layer (7) Interoperability Guidelines, Version 3.1 or

higher.

 

lcaErrNoConnectionToServer LNS, #120

There is no communication with the LNS Server.

 

lcaErrInvalidInitString LNS, #121

The AddNvFromString or InitFromString method was provided with an invalid string.

 

lcaErrReadOnlyInContext LNS, #122

An attempt was made to write to, or delete, an object that is read-only. LNS contains multiple

read-only objects that could cause this exception to be thrown. For example, if you use the

Remove method to delete a pre-defined FormatLocale object, this exception will be thrown.

 

lcaErrInvalidPropChangeEvent LNS, #123

Contact customer support.

 

lcaErrNotAllowedWhenIndependent LNS, #124

The called service doesn't work in server-independent mode.

 

lcaErrNetworkNotOpen LNS, #125

The network is not open.

 

lcaErrCantReadMsgPoint LNS, #126

The object server is unable to read the message point.

 

lcaErrOpenCloseTypeMismatch LNS, #127

If the Network object's Open method is used to open a network, the Close method must be used

to close it. If the OpenIndependent method is used to open the network, the CloseIndependent

method must be used to close it. This error may occur when these methods are not matched

properly.

 

LcaErrInvalidDomainLength LNS, #128

The domain is the wrong length.

 

lcaErrDatabaseRecoveryFailed LNS, #129

The database recovery operation failed.

 

lcaErrOnlyAllowedOnLocalVNI LNS, #130

The requested service is not available on a remote Full client.

 

lcaErrInvalidHexValue LNS, #131

An invalid hexadecimal value was supplied.

 

lcaErrUniqueNVNameRequired LNS, #132

A unique network variable name is required for this service. Some devices, such as the i.LON

100, require that all network variables within the device have a unique name. If you attempt to

assign a duplicate name to a network variable on such a device, the operation will fail, and this

exception will be thrown.

 

lcaErrInternalErrBadExceptionCode LNS, #133

This is an internal error and should be reported to customer support.

 

lcaErrInternalErrBadHresultExceptionCode LNS, #134

This is an internal error and should be reported to customer support.

 

lcaErrInternalErrBadVNIDataServer LNS, #135

This is an internal error and should be reported to customer support.

 

lcaErrInternalErrBadNsdHandle LNS, #136

This is an internal error and should be reported to customer support.

 

lcaErrInternalErrStartTransaction LNS, #137

This is an internal error and should be reported to customer support.

 

lcaErrNotAllowedOnVniNetwork LNS, #138

An attempt was made to call the OpenIndependent method on a Network object that was

retrieved from the VNINetworks collection.

 

lcaErrInvalidAddressingMode LNS, #139

When using the GetMessagePoint method, an invalid addressing mode was supplied.

 

lcaErrNotAllowedOnPermanentNsd LNS, #140

An attempt was made to remove a permanent network service device.

 

lcaErrOnlyAllowedWhenIndependent LNS, #141

The requested service can only be performed on networks opened with the OpenIndependent

method.

 

lcaErrDatabaseDiskFullErr LNS, #142

The disk containing the LNS database is full.

 

lcaErrNotAllowedWithoutNetworkInterface LNS, #143

This operation is not allowed because the Object Server global flag lcaNoNetworkInterface is set.

 

lcaErrDbTcpIpNetworkError LNS, #144

Please verify the TCP/IP stack is installed. You may need to add a dial-up connection to initialize

the stack.

 

lcaErrXDriverBusy LNS, #145

The profile selected is already in use by another OpenLDV xDriver listener application. Only one

application may use an xDriver profile at any given time. For more information on xDriver

profiles, see the OpenLDV Programmer’s Guide, xDriver Supplement.

 

lcaErrXDriverCantConnect LNS, #146

There was no response from the xDriver connection broker. Make sure that the xDriver

connection broker service has been started. For more information on the xDriver connection

broker, see the OpenLDV Programmer’s Guide, xDriver Supplement.

 

lcaErrXDriverNotListener LNS, #147

The current process is not registered for xDriver uplink events for this profile. For more

information on xDriver profiles and uplink events, see the OpenLDV Programmer’s Guide, xDriver

Supplement.

 

lcaErrXDriverNoSuchProfile LNS, #148

The xDriver profile selected does not exist, or the xDriver connection broker is not currently

running. Make sure that the profile you are using exists, and that the xDriver connection broker

service has been started if you encounter this error. For more information on the xDriver

connection broker, see the OpenLDV Programmer’s Guide, xDriver Supplement.

 

lcaErrInvalidExportFile LNS, #149

LNS was unable to export the database validation report when the Export method was called.

This may occur if the target directory supplied to the method as the path element cannot be

opened for writing, or if the target directory already exists, and the overwriteExisting element

(which indicates whether or not the exported report should overwrite the contents of the target

directory) is set to False.

 

lcaErrNotYetSet LNS, #150

This exception will be thrown if you attempt to read the RemoteChannel property, and the

property has not yet been set. The RemoteChannel property must be explicitly set by a Full

client application before it can be read by any other application.

 

lcaErrUniqueNameRequired LNS, #151

You attempted to create an object with a name that is already being used by an object of that

type. For example, the name assigned to all LonMarkObject objects must be unique. Therefore,

if you use the Add method to create a LonMarkObject and specify a name that is already being

used by another LonMarkObject, this exception will be thrown.

 

lcaErrInvalidServiceType LNS, #152

The service type(s) specified for the operation is invalid. This exception will be thrown if you

attempt to create a network variable that uses both the acknowledged and unacknowledged

messaging services with the Add method.

 

lcaErrDbValidationCancelled LNS, #153

If you use the CancelValidation method to cancel a database validation, this exception will be

thrown to notify you that LNS has successfully stopped the database validation procedure.

 

lcaErrUnavailableResourceFiles LNS, #154

LNS was unable to locate the resource file referenced by a TypeSpec object. This exception will

be thrown if you call the Lookup method to verify that the program ID and scope of a TypeSpec

object reference a valid resource file, and LNS is unable to locate the resource file. LNS may be

unable to locate the resource file if the value of the program ID or scope property is entered

incorrectly, or if the LdrfCatalogPath property does not correctly point to the location of the

resource files.

 

lcaErrNotFoundInResourceFiles LNS, #155

LNS unable to locate the format name referenced by a TypeSpec object. This exception may

occur if you call the Lookup method to verify that the program ID, scope and format name of a

TypeSpec object reference a valid format type. If LNS is able to locate the resource file

referenced by the program ID and scope of the TypeSpec object, but does not find a definition

of the specified format name in that file, this exception will be thrown. In this case, check to

make sure that the value of the FormatName property was written correctly, and that the

specified resource file contains a definition of that type.

 

lcaErrTypeLengthTooLong LNS, #156

The maximum length of a network variable is not long enough to support the type assigned to

the network variable. This exception will be thrown if you change the type assigned to a network

variable by writing to the TypeSpec property, and the Length of the newly selected TypeSpec

object exceeds the MaxLength of the network variable.

 

lcaErrTypeNotChangeable LNS, #157

The network variable does not support changeable types. This exception will be thrown if you

attempt to write to the TypeSpec property of a network variable that does not support

changeable types. You can check if a network variable supports changeable types by reading its

ChangeableTypeSupport property.

 

lcaErrOutOfRange LNS, #158

A value was supplied to a property or method parameter that is outside the valid range for that

property or parameter. For example, the TxTimer property accepts a range of encoded values

from 0 to 15, and you can write the value 254 to the property to restore it to its default value. If

you wrote any other value to the property, this exception would be thrown.

 

lcaErrUnableToCreateBackup LNS, #159

LNS was unable to create a backup copy of the network database when the Backup method was

called. This may occur if there was an error copying the network database, or if the systemPath

element supplied when the method was called did not reference a valid system path.

 

lcaErr12HourTimeFormatNotSupported LNS, #160

This exception will be thrown if you write a value to the ShortTimeFormat property that would

cause LNS to display time values in 12-hour format. For more information on this, see the online

help for the ShortTimeFormat property.

 

lcaErrNotAllowedOnTemporaryObject LNS, #161

The requested operation can only be performed on permanent monitor sets and monitor points.

For example, if you are adding a MsgMonitorPoint object to a temporary monitor set, and specify

a MessageTag as the targetDevice element, this exception will be thrown. See the online help forthe MsgMonitorPoints collection’s Add method for more information on this.

 

Add Feedback