How to determine DataGate for IBM i's library and version

Question

How can I determine what version of ASNA DataGate for IBM i, and what its library name is, my system is using?

Answer

ASNA DataGate for IBM i is an IBM i host service that serves IBM i data to ASNA clients such as ASNA Visual RPG, Wings, and Mobile RPG. These instructions show you what version(s) of DataGate are running on your system.

If you installed DataGate to its default library, use this IBM i command line: (wherex xxx is your DataGate version-which basically renders this step meaningless because if you know the library you probably already know the version!)

dspdtaara dg8_xxx/reldate

For example, if you are using DG 16.0, then use

dspdtaara dg8_160 /reldate

This displays the screen shown below in Step 3.

If you don’t know the DataGate library on your IBM i, then use the steps below to determine what version of DataGate is currently running on your system:

Step 1. First, use WRKACTJOB and find the DG8SVC jobs. For each instance of DataGate for IBM i, there is one DB8SVC job where the Function column is “CMD-DG8SVC.” Two of those jobs are shown in the screenshot below. This indicates there are two separate instances of DataGate running on this IBM i. In most installations, there is only one version of DataGate running. If you do see more than one DG8SVC job where the Function column is “CMD-DG8SVC” do steps 2 and 3 for each of those jobs.

If you know what subsystem DataGate is running in, you can also use WRKSBSJOB to find the DG8SVC jobs. For example, if DataGate is running from QINTER, this command

WRKSBSJOB QINTER

lists only the jobs initiated from that subsystem.

Step 2. To show what library your DataGate for IBM i instance resides in, select a DG8SVC/CMD-DG8SVC job and use option 5 to work with that job. Then use option 10 to display its job log. This shows the library from which the DG8SVC job was launched (as shown below).  Note that if you have multiple instances of DataGate installed you may need to check more than one DG8SVC/CMD-DG8SVC job.

Figure 2. Show the library from which the DG8SVC job was launched.

By default, a DataGate library is named DG8_xxx where xxx = is the DataGate version number. However, some customers rename that library while installing DataGate so rather than assuming what the DataGate library is, it’s better to use this Step 2 to know what it is for sure.

Step 3. Knowing DataGate’s library name, display the DataGate version with

DSPDTAARA RELDATE

Figure 3. The DataGate version number.

The contents of the RELDATE data area show the DataGate version number. In the screenshot above you can see that this version is DataGate 16.0.8.0.

This data area shows the TCP/IP port to which DataGate is bound. The TCP/IP port is the first set of numbers after the subsystem (shown in the blue rectangle above). In this case, DataGate is bound to port 5160.