Upcoming ASNA Webcast
How to persist your IBM RPG applications well into the future
Your business depends on your core RPG applications to keep your business running. Can you keep them running when your RPG programming team retires? And what happens to your business if you can't?
Date and time: Thursday, June 26th, at 1pm central
Register now
ASNA Knowledge Base
Technical references, how-tos, and trouble-shooting for ASNA products

Licensing DataGate for IBM i 16.x and up

This article applies to DataGate for IBM 16.0 and higher

ASNA DataGate for IBM i 16.x introduced a license registration change. Starting with 16.x, the license now includes the IBM i partition number (LPAR). While there isn’t a direct way to see this value on your IBM i, there is an easy, indirect way. These steps are all read-only and don’t change anything on your IBM i.

First, from the IBM i command line:

CALL QCMD

Then, from the QCMD panel:

CALL QSYS/QLZARCAPI

Which shows this display:

Using IBM's qlzarcapi API
Figure 1.

The Partition ID is in thePartition Info-> area, about four or five lines down (shown in Figure 1 above in the red box).

We’ll also need your IBM serial number. Get it with:

DSPSYSVAL QSRLNBR

and your IBM i model number. Get it with:

DSPSYSVAL QMODEL

Getting your license

Contact us and provide us with:

  • Company name
  • DataGate version number
  • IBM i model number
  • IBM i serial number
  • IBM i partition number (the red box in the image below)
  • User Count

and we’ll generate a license for you.

Applying the license

A apply the license with this command:

[Library]/register

where [library] is the name of your DataGate library.

That displays the screen below shown in Figure 2:

Applying a DataGate license on the IBM i
Figure 2.

As an aside, notice the the red box above in the Registration Assistant panel shows the Partition ID.

A big thank you to Matt Marsh at The Walt Disney Company for bringing the QLZARCAPI API to our attention and a big thank you to Simon Hutchinson for writing about the API at his blog RPGPGM.com.

Published: Jan 4, 2024