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:
- For IBM i 7.2 V7R2:
- For IBM i 7.3 V7R3:
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.
- Create the IFS folder.
On a client PC within your Local Area Network that has the Client Access Express for Windows installed and running, use the System i Navigator to create a new folder named LexiCom under the AS/400's Root ('/ ') directory.Warning: You will not be able to run Cleo LexiCom software on the AS/400 if you name this folder anything other than LexiCom!
- Define the Authorization List for accessing the IFS Folder.
To allow multiple users to successfully run Cleo LexiCom and share access to all log and host files (even to those who did not originally create the files) without needing to give "All Object" access to any of these users, an Authorization List is used to assign Read, Write and Execute privilege to the /LexiCom folder and all of its subfolders. To do this, choose the Security icon in the System i Navigator, select Authorization Lists and choose New Authorization List.
- Create a LexiCom Authorization List and select All under Public authority.
A screen similar to the following will be displayed. Verify that the All privilege is selected.
- Add the users who will be running Cleo LexiCom to the Authorization List and assign them the same All privilege.
Note: The previous steps may also be performed using the CRTAUTL and ADDAUTLE (green screen) commands, if preferred.
- Next the /LexiCom folder and all its subfolders must be linked with the newly created Authorization List. Since the System i Navigator can only link the /LexiComfolder and none of its subfolders, it is necessary to open an AS/400 (iSeries/i) green screen as the owner of the /LexiCom folder or a user with either *ALLOBJ or *ALL access and enter the CHGAUT command as follows:
CHGAUT OBJ(‘/LexiCom’) DTAAUT(*RWX) AUTL(LEXICOM) SUBTREE(*ALL)
If desired, the System i Navigator may be used to verify that the Cleo LexiCom Authorization List has been properly assigned to the /LexiCom Object.
To do this, open the File Systems tree and expand the Integrated File System entry. Under the Root entry, right-click the /LexiCom folder and choosePermissions.
For additional information refer to the following IBM resources:
- Authorization lists concepts:
- Authorization list security:
- Authorization lists concepts:
- Create a LexiCom Authorization List and select All under Public authority.
- Create the Cleo LexiCom File Share.
Open IBM i Net Server and create a file share for the Cleo LexiCom folder that you created above. Make sure that the file share has Read/Write access.
- Map the File Share to a Network Drive.
Using Windows Explorer, map the new Cleo LexiCom file share to any available network drive.The contents of the shared IFS drive (which will be empty) should appear.Note: Due to IBM i compatibility issues, Cleo does not guarantee a desirable user experience while using Windows 10 mapped drives to display the LexiCom UI and therefore does not support mapping file shares on Windows 10 network drives.
- Install Cleo LexiCom to the Network Drive.
Click on the install.exe file that you downloaded from the Cleo website.Warning: As you are installing Cleo LexiCom, when prompted to Choose Install Folder, do not accept the default value of C:\Program Files\LexiCom. You must either use the network drive (for example, L:\) or the network share (for example, \\cleo400\LexiCom) that you mapped in the previous step as the install target.
- At the Install As A Service prompt, make sure the Start service automatically at system startup checkbox is not selected and then click Next. Optionally you can remove the Service name, blanking it out, so that a Windows service will not be created.
- Register Cleo LexiCom.
Start Cleo LexiCom (from either the Start menu or by double-clicking the LexiCom.exe application in the /LexiCom IFS folder through Windows Explorer) from your PC and register your serial number. See Registering your serial number.Note: Once you have Cleo LexiCom installed into its final production destination, and before the end of your 30-day trial period, request your Permanent License. See Requesting a permanent license.
- When the software registration has completed, verify that the LexiCom.savf file has been copied to the /LexiCom folder on the IFS, then continue to the next section.
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.
- Verify that the LexiCom.savf file has been copied (or unzipped from the AS400.zip file) to the /LexiCom folder in the IFS.
- Sign on to the AS/400 Command Prompt as QSECOFR and type the following command:
CPYFRMSTMF FROMSTMF('/LexiCom/LEXICOM.savf') TOMBR('/QSYS.LIB/QGPL.LIB/LEXICOM.file') CVTDTA(*NONE)
The message Stream file copied to object is displayed.
- Restore all the objects required to complete the installation:
RSTOBJ OBJ(*ALL) SAVLIB(QGPL) DEV(*SAVF) SAVF(QGPL/LEXICOM)
The message 7 objects restored from QGPL to QGPL is displayed.
- Type the following command to install all the necessary Cleo LexiCom commands and objects on the AS/400:
The message LexiCom AS/400 Installation Complete is displayed.
- The installation is now complete. Run STRLEXSVR to begin operating Cleo LexiCom on the AS/400. To interact with the software, connect the Native UI to the service by running LexiCom.exe in the IFS installation path.
Please sign in to leave a comment.