Transoft AppIntegrate (Deployment)
OS/400 Installation Instructions

NOTE: The OS/400 release is available on request from Transoft.

Contents

Extracting the OS/400 software

It is recommended that you sign on as QSECOFR to install the Transoft AppIntegrate Server software.

Create a base library for the Transoft AppIntegrate Server software. For example, if you wanted to use a library called APPINT, use:

CRTLIB LIB(APPINT)

Create an empty save file to receive the distribution from your PC. For example to use a save file called APPINTDIST in QGPL, use:

CRTSAVF FILE(QGPL/APPINTDIST)

Using FTP to transfer the Server save file from the CD on your PC to your AS/400 or iSeries

Before you start, make sure that the FTP server is running. To start it, go to the OS/400 command line and type:

STRTCPSVR *FTP

On the PC, the FTP command sequence is as follows:

  1. At the DOS prompt, type:

    ftp

    to start an FTP session.

  2. At the ftp> prompt, type:

    open server_name

    where server_name is the name of your AS/400 or iSeries.

    Note: To access FTP's in-built Help, type
    help
    at the ftp> prompt.

  3. Sign on to the FTP session using a valid user profile and password.

  4. At the ftp> prompt, type:

    lcd d:\os400\server

    where d is the drive letter for the CD-ROM.

  5. At the ftp> prompt, type:

    binary

    to change the transfer type to binary mode.

  6. At the ftp> prompt, type:

    put APPINTDIST.SAVF QGPL/APPINTDIST

    to transfer the AppIntegrate server save file to the AS/400 or iSeries (assuming you created a save file called APPINTDIST in QGPL).

  7. To close the FTP session, type:

    bye

  8. Sign on to the AS/400 or iSeries and extract the save file to the base library, for example:

    RSTOBJ OBJ(*ALL) SAVLIB(TCFDIST) DEV(*SAVF) SAVF(QGPL/APPINTDIST) RSTLIB(APPINT)

    will extract the save file QGPL/APPINTDIST into the APPINT library.

  9. The LIBASCII library now needs to be extracted. Create the library QLIBASCII:

    CRTLIB LIB(QLIBASCII)

  10. Now extract the LIBASCII save file to QLIBASCII:

    RSTOBJ OBJ(*ALL) SAVLIB(QLIBASCII) DEV(*SAVF) SAVF(base_library/LIBASC10)

    where base_library is the library you extracted the Server software into.

  11. The /home/tcf directory in the IFS must now be extracted as follows:

    RST DEV('/QSYS.LIB/Base.LIB/TCFDIRS.FILE') OBJ(('/home/tcf'))

    Where base is the library that the server software was extracted into.

Configuring the AS/400 or iSeries

If you are going to be using Transoft Data Adapters, you will need to set up the 'Local Relational Database Directory Entry'. To do this, sign on as QSECOFR and issue the command:

ADDRDBDIRE RDB(OS/400_server_name) RMTLOCNAME(*LOCAL)

where OS/400_server_name is the name of the AS/400 or iSeries.

In addition to this, you must be sure that the machine's name resolves correctly. Type PING OS/400_server_name. If this does not complete successfully, use the CFGTCP command to set up the machine name.

Setting the default job description

By default, the STRAPPSRV command uses the APPSERVER job description. To change the default job queue that the Component Broker is submitted to, use the command

CHGJOBD JOBD(base_library/APPSERVER) JOBQ(job_queue)

As the Component Broker runs continuously, it may be desirable to set up a specific job queue for the job to run from (as opposed to QBATCH, for example). The tool described below may be used to set up a job queue and subsystem

Setting up subsystems

To set up a subsystem for a specific instance of the Component Broker to run in, a tool has been supplied called TCASETUP.

At the command line, enter:

TCASETUP

and press

F4
.

The options are as follows:

  • Target Library: This is the library into which the subsystem, class and job description objects are placed.
  • Subsystem Name: The name of the subsystem object which is to be created for this instance of the Component Broker.
  • Autostart with subsystem: To automatically start the Component Broker when the system is IPL'd, this option will create an autostart job entry to start the the Component Broker subsystem. For example, if the Component Broker is to be started whenever the interactive subsystem is brought up, enter QINTER in here.


 

Phone: 770-933-1965 (U.S.) or +44 (0) 1753 778000 (U.K.)
Copyright © Transoft Group Limited 2012. All rights reserved