TOP

ASN.1/C++ Runtime Errors

Applies to: ASN.1/C++ 6.5

The ASN.1/C++ Compiler and runtime routines can both generate error and informatory messages. Use these error messages to help pinpoint problems in your ASN.1 syntax or application code.

Go directly to the Runtime Error Reference to look up OSS ASN.1 Runtime error messages by message number.

Format

There are four types of messages issued by the various OSS ASN.1 Tools components:

  • ASN.1 Compiler input-ASN.1 syntax checking messages
  • ASN.1 Compiler command-line format messages
  • ASN.1 Compiler input-file processing messages
  • Runtime function signal messages

Only the runtime function messages are available through this page. Refer to ASN.1/C++ Compiler Errors to look up the other three types of messages.

All four types of messages carry a unique code that identifies each issued message. This message code consists of six characters: the first identifies the OSS ASN.1 Tools component that issued the message, next is a four-digit message number, and the last indicates the severity level of the message. See the following table for more details:

Character Position
in Message Code
Purpose Possible Characters Description
First Component Identifier
A

C

L

D

E
ASN.1 syntax checker

ASN.1 compiler input-file processor

ASN.1 compiler command-line format checker

Decoder routines

Encoder routines
Second through Fifth Message Number 0001 to 9999 Unique, four-digit message ID number
Sixth Error Severity
I



W




E



S
Informatory message (Level 0)
Level 0 messages provide additional information; no error is indicated. Warning message (Level 1) Level 1 messages warn that something is unusual in the input or in how an OSS ASN.1 Tools component is used; they do not necessarily indicate an error. Regular error message (Level 2) A Level 2 message indicates that an error occurred; however, the current process continues. Severe error message (Level 3) A Level 3 message indicates that an error occurred; processing stops immediately.

Example

The D0263E error code contains the following information:

  • The letter D states that the message is issued by the ASN.1 decoder.
  • 0263 is the message number. Use this number to look up the message details.
  • The letter E indicates that this message is a Level 2 error, which refers to regular or common errors.

Format of Runtime Function Signal Messages

Error message format

Typical runtime function signal message

A typical XER encoding error message also contains the line number and position of the error occurrence, as shown in the following example:

D0174E: Canonical XER restrictions are violated: 'XML encoding for contained types should have 
been used'; check field 'content' (type: BIT STRING) of PDU #1 'DataPacket' at line 1 position 4.

A runtime function message can also have fewer details, depending on the encoder/decoder and the debug options used.

Runtime Error Reference

Go to the Runtime Error Reference to look up OSS ASN.1 runtime error messages by message number. You can also call the getErrorMsg() method of the OssControl class to retrieve a detailed error message after an error code is returned by the encoder, decoder, or other API method.


This documentation applies to release 6.5 and later of the OSS® ASN.1 Tools for C++.

Copyright © 2017 OSS Nokalva, Inc. All rights reserved.
No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or by any means electronic, mechanical, photocopying, recording or otherwise, without the prior permission of OSS Nokalva, Inc.
Every distributed copy of the OSS® ASN.1 Tools for C++ is associated with a specific license and related unique license number. That license determines, among other things, what functions of the OSS ASN.1 Tools for C++ are available to you.