ASNA WingsRPG™ Reference Manual

IBM i Components: DataGate

This topic describes the process of installing DataGate onto the IBM i.

There are two ways to install DataGate onto the IBM i:

  • FTP from Windows
  • On a CD

With either method, you must also complete the Registration Assistant to proceed.

Installing DataGate via FTP

Note – The user installing DataGate on the IBM i must have *SECOFR authority.

Critical – Prior to installation, DO NOT DELETE or RENAME the ASNA_DG8 library. It is required for all versions of DataGate, even though you may be installing into a library with a different name. Also, if you are installing to an existing subsystem, please be sure that the subsystem has been started prior to the installation.

In order to install DataGate on the IBM i from a Save file (obtained from the Installation CD), you must have TCP/IP installed on both Windows and on the IBM i . You must also have FTP installed on your IBM i.

(Installing TCP/IP and FTP on the IBM i is beyond the scope of this document. If you do not know whether your IBM i has TCP/IP and/or FTP, please check with your network manager or system provider. )

On the IBM i
  1. Sign onto the IBM i using the QSECOFR account.
  2. Create a Save file in QGPL by entering the following command: CRTSAVF QGPL/ASNAINST
On Windows
  1. To upload the Save file from the CD via Windows, an FTP session must be started to the System i.
    From Windows, click on the Start button, select Run and enter the following command:
    FTP tcpipadress
    Where 'tcpipadress' is either the IBMi's TCP/IP address (such as 198.076.129.35), or a machine name that is registered either in a DNS or a HOSTS file.
  2. When prompted for a user name and password, enter the appropriate information that will give you privileges to upload data to the IMB i.
  3. Once FTP has been started, upload the Save file to the IBM i by entering the following commands:
    1. binary
    2. put x:\Datagate\FTP\ASNAINST QGPL/ASNAINST
      where x is the Windows CD-ROM drive.
    3. quit
On the IBM i
  1. Restore the library called ASNAINST from the Save file by entering the following command:
    RSTLIB ASNAINST DEV(*SAVF) SAVF(QGPL/ASNAINST)
  2. To install DataGate, execute the following command:
    ASNAINST/DG8LOAD
    When DataGate for IBM i is installed, it is automatically authorized for one user license. If you wish to authorize more than one licensed use, obtain a license code from ASNA and then enter ASNA_DG8/REGISTER from the IBM i command line.
  3. The installation program will display the ASNA Software License Agreement. If you agree with the terms of the license, press the F8 key to continue with the installation. If you do not agree, press the F3 key and the installation will be cancelled.

    Next, the installation program displays the installation options. The installation can be cancelled at any time by pressing the F3 key.

    Installation Library Option:

    Select a library where DataGate will be installed. If the library does not exist, it will be automatically created during the installation. The following libraries are not allowed for the installation: QSYS, QGPL, QSPL, QTEMP, VCAT_72 and the distribution library. Libraries called ASNA_DG8 and VCAT_72 are always created.

    Subsystem Options:

    Select a subsystem where DataGate will run. You must also specify the library where the subsystem description is located or where it will be created during the installation. This is required so that the installation program can determine whether the specified subsystem exists or must be created. If the subsystem does not exist, it will be automatically created in the specified library during the installation. If you are installing to an existing subsystem, please be sure that the subsystem has been started prior to the installation.

    Service Table Entry Options:

    Select the name of the service table entry and the port that DataGate will use. The default values are recommended.

    Start DataGate Option:

    Enter 'Y' to have DataGate for IBM i started as soon as the installation has completed. If you select not to start DataGate, you will have to start it manually with the STRDG8SVR command by entering:
    InstallLib/STRDG8SVR
    Where InstallLib is the library into which DataGate was installed.

    Clear Cache Library Option:

    Enter 'Y' to clear the DataGate for IBM i cache library. This is recommended. Make sure that there are no active DataGate jobs if you select this option.

  4. When all options have been selected, press the F6 key to display a verification screen for each of the above options. As you review each option, press Enter if you are satisfied with your selection, otherwise press the F12 key to redisplay the options screen and enter your changes. When all options have been verified, the installation will start.
  5. The installation program will stop the version of DataGate for System i that is running out of the specified installation library - if there is one. If there are multiple versions of DataGate running, those other versions will not be stopped
  6. Once the installation has completed, the ASNAINST Save file is no longer needed, and may be deleted. The ASNAINST library is automatically deleted.
  7. You must name the IBM i Database in DataGate Database Manager using Work with Database Names. See Naming an IBM i Database for more information.

Installing DataGate via CD-ROM

Note – The user installing DataGate on the IBM i must have *SECOFR authority.

  1. To restore the installation library, load the CD, then enter the following command:
    RSTLIB ASNAINST OPT01 OPTFILE('DATAGATE/RSTLIB/ASNAINST')
    Where OPT01 is the device name from which the library will be restored.
  2. See the above section titled Installing DataGate for System i with FTP, starting with step 8, for detailed instructions and information about the various installation options.

    Once the installation is completed, the ASNAINST Save file is no longer needed, and may be deleted. The ASNAINST library is automatically deleted.

    When DataGate for IBM i is installed, it is automatically authorized for one user license. If you wish to authorize more than one licensed use, obtain a code from ASNA and then enter ASNA_DG8/REGISTER from IBM i command line.

The Registration Assistant

When installing the product for the first time, or when an upgrade is installed, the Registration Assistant screen is displayed with the bottom of the screen displaying whether the current License Code is valid or not. If the License Code is valid, press F3 to continue. If not, call ASNA or your Distributor to get a new License Code.

  1. If you are not already at the Registration Assistant Screen, enter the following:
    InstallLib/REGISTER
    Where InstallLib is the library into which DataGate for IBM i was installed.
  2. Enter or verify the information to display, as detailed below.
    System Name
    The name of the IBM i will automatically display
    Model
    The model of the IBM i will automatically display.
    Serial Number
    The serial number of the IBM i will automatically display.
    License Key
    For a new license, enter the 16-digit license code acquired from ASNA exactly as it is given.
    License Type
    License Type specifies if the licensing is for an individual machine, or for the entire company.
    • To license, or register the current machine, use *MACH, which is the default.
    • To license, or register the entire company, enter *SITE.
    Customer Name
    The name of the user that was entered when the product was installed will automatically display. However, you can change this name as needed.
    Company Name
    The name of the company that was entered when the product was installed will automatically display. However, you can change this name as needed. If you are entering a Site License, the name of the company must be spelled exactly as determined by you and ASNA. This name is also case-sensitive, so capitalization must match exactly.
    Start Date
    The Start Date specifies if the product has been purchased, in which you have a Permanent code, or if the product is a 'Trial', which is only valid for a specified period.
    • If the product has been purchased, use *PERM, which is the default.
    • For a 'Trial' of the product, enter the starting date in the format MM/DD/YYYY.
    Expiration Date
    The Expiration Date indicates the date in which the license code will expire.
    • If the product has been purchased, use *PERM, which is the default.
    • For a 'Trial' of the product, enter the ending date of the trial as specified by ASNA in the format MM/DD/YYYY.
    User Count
    User Count specifies the number of concurrent users that can access the product, as a per-user-basis, or as unlimited.
    • For unlimited users, use *UNLIM, which is the default.
    • For a specified number of users, enter the user count as a positive integer.
  3. Acceptance of a valid licensing code is confirmed at the bottom of the screen. Press F3 to continue.

    If the message "The License is Invalid" displays, recheck all entries. If no errors were made in any of the entries, call ASNA or your National Distributor for further assistance.

    If the message "Couldn't create license data area, check authority and try again" displays, you do not have the proper authority to register DataGate for System i. See Authority of the User Profile used to Register DataGate for more information.