What's New

Applies to: NAS/C++ 5G r15.6.0 v7.1.7

What's New in NAS/C++ 5G r15.6.0 v7.1.7

New Features

  • New JSON2Binary() and XML2Binary() methods that convert textual JSON or XML NAS messages to binary encoded form.
  • New decodeJSON() and decodeXML() methods that decode JSON or XML encoded NAS messages. The decoded messages, which can be optionally modified, can then be re-encoded to binary NAS messages using the encode() method.
  • New methods that retrieve the Extended protocol discriminator, Message type, PDU session identity, and Procedure transaction identity IEs of a binary NAS message even when the message decoding fails with an unrecoverable error. These methods are useful when preparing an error response as specified in Section 7 of 3GPP TS 24.501.


  • The decode() method now always ignores a truncated optional Information Element at the end of a message. Previously, it could return a non-zero error code in this case.
  • The decode() method now returns the new error code 71 and the "Too short message" error message when, according to 3GPP TS 24.501 7.2.1, the input message should be ignored because it is too short to contain a message type Information Element. Previously, other error codes were returned in this case.
  • A few defects in mapping NAS messages to the annotated ASN.1 specification are fixed. Some of the modifications result in changes to the NAS1560.h header file.

This documentation applies to the OSS NAS Tools for C++ for 5G v7.1.7 for 3GPP Release 15.6.0.

Copyright © 2022 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 NAS Tools for C++ for 5G is associated with a specific license and related unique license number. That license determines, among other things, what functions of the OSS NAS Tools for C++ for 5G are available to you.