|
April 2009 |
|
|
|
uniPaaS
Server for system i
V1.5 Service Pack 1 |
|
|
|
|
|
We are pleased to present
you with the release of uniPaaS Server V1.5 Service Pack 1 for system i platform. Please read the information
below to learn more about uniPaaS Server for system i, Version 1.5 SP1. For information about
uniPaaS Version V1.5 Service Pack 1 see ftp://ftp.magicsoftware.com/uniPaaSproduct/Documents/uniPaaS1.5SP1ReleaseNotes.pdf For information about
uniPaaS Version V1.5 see ftp://ftp.magicsoftware.com/uniPaaSproduct/Documents/uniPaaS1.5ReleaseNotes.pdf HTTP Server (Powered by Apache) Using colors for browser tasks
uniPaaS for system i Server Version 1.5 lets you run remote, Internet and batch programs directly on system i and allows access to local and remote DB2/400 DDS (ISAM) files, DB2/400 SQL tables, Memory files, and OS/400 functions such as CL/RPG/COBOL programs, CL commands, Data Area, and other system i objects. ·
OS/400 V5R4 or OS/400 V6R1 ·
OS/400 Private Address Space Environment (PASE) - IBM
License program ·
5722SS1 option 33 V5R4 ·
5761SS1 option 33 V6R1 ·
TCP/IP configuration for system i ·
TCP/IP Interface must be Active ·
Local Host name has to be defined in the host table
entries ·
Domain Name has to be configured ·
Easycom Host Library from uniPaaS
1.5 and later installation ·
Permanent or Evaluation License PAK Execute the unipaas1.5sp1.zip in your PC Temp directory and run
the installation program Mgobjtrf.exe. Accept the system i
library default and choose the FTP transfer protocol. You configure and manage
the uniPaaS server using the server administration menu. Enter the following
commands in the system i command line in order to
invoke the uniPaaS server administration menu: ·
Type CHGCURLIB <New
Library name>
and press ENTER. ·
Type CFGMGCSVR and press ENTER. Subsystem Configuration (Back) Configure UniPaas Server using “Magic Config/Magic Subsystem Confg” Configure UniPaas
Broker using “Magic Config/Broker Subsystem Confg” HTTP
Server (Powered by Apache) configuration (Back)
- Start the administrative server instance
by issuing following command: STRTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN)
Open
the following URL to create the Apache instance: http://<server_name>:2001 The
Apache instance directory and its configuration files are created in the /www
directory. Add the lines contained in UNIPAAS15/web_utils/magic.conf to the Apache configuration file.
Note: The MGREQ.INI
file, which is used by the Apache is located in the same directory where
uniPaaS Internet requester program mgrqcgi015 is located. The default location of MGREQ.INI
file and uniPaaS Internet requester program mgrqcgi015 are in the cgibin directory. uniPaaS requester settings (Back) The following settings in the MGREQ.INI file affect the
requester execution: The uniPaaS 10 log file is
created for each server you start. Its name is determined by the ExternalLogFileName entry in the MAGIC.ini file.
This entry must include an absolute path of a file name ,
not a relative path. The uniPaaS 10 log file is
created for each server instance. The log file name is set via ExternalLogFileName entry in the MAGIC.ini file.
The file path is absolute. i.e. /New Library name/logs/LogFileName The Java CLASSPATH
separator character on system i platforms is a
colon (:) as opposed to the Windows platform
separator character which is a semicolon (;). For example: CLASSPATH = /java/MyClasses:/java/OtherClasses
For more information,
please refer to the Java documentation See:
(http://java.sun.com/j2se/1.5.0/docs/guide/javadoc/index.html). For V5R4 only: Make sure you have
installed Java Developer Kit (JDK) 1.5. In
order to set java 1.5 as your default Java you should: Specify
-Djava.version=1.5 on the java command or in your SystemDefaul.properties file otherwise the java will
default to 1.4. For
V5R4 and V6R1: There is
an option to run the
32bit java 1.5 by specifying the JAVA_HOME environment
variable. Make
sure you also have the most recent java group PTF installed on your system - sf99291 lvl 16 and later. (V5R4)
WebSphere
MQseries (Back) If you are using an MQseries Queue manager on system i,
you need to set the following logical name in the MAGIC.INI file: Enter following lines in
the MGENV400 server profile file: # Websphere
MQ - UDP WMQseriesS=$MAGIC_HOME/bin/mgmqseries_c WMQseriesC=$MAGIC_HOME/bin/mgmqseries_c Using
colors in browser tasks (Top) - In
order to use colors properly on system i, you must
define all the colors that are used as non-system colors. The easiest way to
do this is to access the color file in the uniPaaS studio mode and define the
colors accordingly. The browser client technology of uniPaaS enables the
end-user’s browser to locally cache the logic segments of the application. In
this way a significant amount of data is retrieved from the client’s cache
instead of being transmitted anew for every task. The browser client caching
mechanism is aware of changes introduced to existing tasks and will cache and
utilize the modified task. This mechanism is affected by the following
environment settings: Browser client cache path and Browser client cache
alias (CTLCacheFilesPath and CTLCacheFilesAlias
accordingly). Both are defined in the MAGIC.INI file. The uniPaaS server should have write
permission to the directory defined by the CTLCacheFilesPath
environment setting. The Web server should have read permission to
the same directory. You may choose to create a different directory and point
to it by the CTLCacheFilesPath environment
variable. The alias defined by the CTLCacheFilesAlias
environment variable should also point to this directory. A remarked entry named MGLOCAL, which points to the
Korean support library mglocal.kor, exists in the mgenv
file. This file is required for proper functioning of browser-based
applications when using Korean/Hangul characters. ·
Connectivity to messaging servers via JMS is not
supported using the provided messaging component in this release. ·
The current version does not support the Rich Client
connectivity. The license procedure and the server license mechanism have not been changed since the previous version. The valid license names for this version are:
You need to update the
Host Library License file by using the EASYREG command on the system i command line and the LicenseName
entry in the MAGIC400.INI file for an appropriate license name when you get
evaluation or permanent License PAKs. Please check QSYSOPR message queue for license related error
messages. In case of license problem,
you will see an error message in QSYSOPR message queue for each Un iPaas server job. ·
Back up all uniPaaS configuration files, such as
MAGIC400.INI, MGRB.INI, MGREQ.INI before modifying them. |
|
|
Thank
you, The
uniPaaS system i Team |