This section describes how to install and configure the Cleo LexiCom software to run natively on the AS/400. If you are installing on a Windows PC and mapping to the AS/400 through a networked drive, see AS/400 PC network access setup.
Unlike typical AS/400 installations performed natively using the optical drive on the AS/400, this installation process is done from your PC via a network share that has been mapped to a directory created on the AS/400's Integrated File System (IFS).
AS/400 Process map
The following is a checklist of tasks for you to perform to successfully install LexiCom for the AS/400 and begin exchanging messages with your trading partner. Following this checklist are the detailed steps required to accomplish each of the tasks below.
Determine if your system meets the minimum hardware requirements
Determine if your operating system meets the minimum software requirements
Obtain and install any missing software products
Obtain and install all required cumulative and group PTFs
Install LexiCom : Follow this step-by-step procedure to map a shared IFS drive and install LexiCom on the AS/400.
Configure and Test : This section describes how to configure hosts for sending and receiving files via a LexiCom AS/400 server. It also gives information on configuring the LexiCom Scheduler for sending and receiving files.
Starting and Stopping the LexiCom Server : This section describes the commands used to start and stop the LexiCom server on the AS/400.
AS/400 Getting Started
AS/400 System Requirements
Please Note: Cleo LexiCom 5.5 requires the use of Java 8 that is only available on IBM i7.1, IBM i7.2 and IBM i7.3. Therefore, IBM i6.1 is no longer supported.
Visit www.cleo.com/support/byproduct/lexicom/sysreqs-AS400.asp for current system requirements.
Determining Your Currently Licensed AS/400 Products
To display an inventory of the software that is installed on your system, type the command: DSPSFWRSC
Verify that Java SE 8 64 bit (Option 17, Feature 5117) is installed on the AS/400. If it is not present, it must be downloaded from the IBM web site and installed before proceeding any further. Refer to http://www-01.ibm.com/support/docview.wss?uid=nas8N1020692 for further information.
To determine the Java Group PTF level on your system, type the following command:
- For IBM i 7.1 V7R1:
-
WRKPTFGRP SF99572
- For IBM i 7.2 V7R2:
-
WRKPTFGRP SF99716
- For IBM i 7.3 V7R3:
-
WRKPTFGRP SF99725
Obtaining Program Temporary Fixes (PTFs) for Your AS/400
IBM recommends that you regularly apply updated PTFs to your system to maintain optimal system performance. To find information on downloading and ordering Program Temporary Fixes (PTFs), Group PTFs and a wealth of other information to help you manage your AS/400, visit the IBM Web site: https://www.ibm.com/developerworks/community/wikis/home?lang=en#!/wiki/Power+Systems/page/IBM+i
Installation and Operation Pre-requisites
Before you can successfully install and run LexiCom on the AS/400, you must verify that the following additional requirements are met:
- TCP/IP must be properly configured on the AS/400 and connectivity between a client PC and the AS/400 must be established and working correctly.
- The host and domain name must be correctly defined on the AS/400. To verify or configure the AS/400's host and domain name, type GO CFGTCP and choose option 12. Enter your AS/400's values in the Host name and Domain name fields.
- The DNS (Domain Name System) must be properly configured to successfully resolve host names. Without DNS configured properly, LexiCom will only be able to send messages to IP addresses. To configure DNS, type GO CFGTCP and choose option 12 and enter the IP address of your Domain Name Server.
- Add a host table entry for the AS/400's IP address and host name by typing GO CFGTCP and choosing option 10 (Work with TCP/IP host table entries). You should also have a LOOPBACK entry that points to the LOCALHOST at 127.0.0.1.
- The IBM i Net Server must be properly configured on the AS/400. Net Server allows support for Windows Network Neighborhood and allows you to map directories in the AS/400 file system to shared drives accessible through your Windows environment. If the NetServer has not already been started, the command STRTCPSVR *NETSVR should be entered to start this server.
- Client Access Express for Windows (or its equivalent) and the latest Service Pack must be installed and configured on at least one PC in your Local Area Network. Once LexiCom is properly installed, any PC in the network (with the appropriate privileges and object authority) will be able to access the shared IFS drive and view the LexiCom UI.
- The System i Navigator (or its equivalent) must be installed on at least one PC in your Local Area Network, and preferably on the PC where LexiCom will be installed. System i Navigator is only required for creating file shares (using IBM i Net Server) but is also useful for viewing System i functions with a graphical user interface. The examples in the following sections use System i Navigator for its illustrations; however you are under no obligation to use it if you prefer using comparable AS/400 native commands.
- The QUTCOFFSET system value must be properly set for your time zone. This value is the offset from Greenwich Mean Time and is used to correctly display and log the local time of your AS/400. If not properly set, the times displayed in the LexiCom log will not reflect your current system time. To view this offset, type DSPSYSVAL QUTCOFFSET on the AS/400. If it is incorrect, verify the QTIMZON system value is set appropriately for your local time zone.
Obtaining Additional Information from IBM
Use the IBM i Support Portal as your starting point for looking up AS/400 technical information: https://www.ibm.com/support/home/
With your hardware order, you may have received digital media on a DVD labelled System i Access for Windows that contains the IBM i Access for Windows licensed program.
Use the Client Access Web site as a general source of information on Client Access: http://www-03.ibm.com/systems/power/software/i/access/windows/os.html
Use the IBM i Net Server web site for general information as well as links to installation and configuration information: http://www-01.ibm.com/support/docview.wss?uid=isg3T1026870
Installing Cleo LexiCom on AS/400
To install and run the AS/400 version of Cleo LexiCom software, a portion of the software will be installed using a Windows PC mapped to the Integrated File System (IFS) and then another portion will be installed in the AS/400 Native File System through command prompts. After all the requirements described in the previous section have been satisfied, use the following two sections to complete the installation to the Integrated and Native File Systems.
The following procedure should only be completed in its entirety the first time you install Cleo LexiCom. If you are upgrading to a new version of Cleo LexiCom software, first verify the product is not running on the AS/400 by either typing the ENDLEXSVR CL command at the command prompt or by selecting the Stop AS/400 option from within the Cleo LexiCom software. Verify the QJVACMDSRV and STRLEXSVR processes are not running in the QSYSWRK subsystem by issuing a WRKACTJOB command at the command prompt.
- A link for the current release core version of Cleo LexiCom. This file is named install.exe and can be saved to the local file system.
- If applicable, a link for the latest patch for Cleo LexiCom. This file is named [#].zip, where [#] is the patch number, and can be saved to the local file system.
- A link for the current AS400 service module. The file is named AS400.zip and can be saved to the local file system.
- If unable to access the UI to use the Export function, manually backup the following directories and files:
- .../LexiCom/hosts/ (.xml files only, no subdirectories)
- .../LexiCom/conf/ (.xml files only)
Installing on an Integrated File System
This section will guide you through the procedure required to complete the first-time installation of Cleo LexiCom in the AS/400 Integrated File System.
Installing the Native File System portion
If this is the first time you have installed on the AS/400 or you are installing a release and not a patch, follow this procedure to complete the Cleo LexiCom NFS installation on the AS/400. If you are not installing a major release, you can skip this step.
Comments
0 comments
Please sign in to leave a comment.