Installation

Installing Merchant/400

Important Pre-Installation Instructions

Version 1.0 or greater of Commerce Server/400 must be installed on the system before installing Merchant/400 Version 1.0, 1.1 or 1.2. In addition, the following PTFs must also be installed:

Commerce Server/400 version 1.0C, or PTF number COM100002 (or greater) for Commerce Server/400 version 1.0, 1.0A, or 1.0B
PTF number WWW130012 for Web Server/400 version 1.3

If Merchant/400 version 1.1 was used in conjunction with Net.Commerce, special care should be taken to migrate existing data to the new format for the MCNINFP file. Since the file has changed (to include the DataCash order reference number and credit card start date / issue code fields) it is important to re-duplicate the file using the instructions on the Using Net.Commerce page. Do not forget to retain your historical data by renaming the original files (using RNMOBJ) and copying the data (using CPYF FMTOPT(*MAP *DROP)) to the newly installed and duplicated files.

Installing Merchant/400 requires the following steps:

Sign on to your AS/400 as QSECOFR or another user profile with a user class of *SECOFR. Special authorities are required to successfully install Merchant/400 objects.
End all currently running Web servers with the ENDWWW command. Ensure that no product commands or menus are running. Also ensure that the Merchant/400 API is not currently being called by another job (this applies to product re-install only). Use the WRKACTJOB command to verify that there are no servers, commands, or other jobs running that may be executing the API.
Run the system command LODRUN to install Merchant/400 from the supplied product tape.
Note: Prompt the command to change the tape device if the default is not appropriate.
The install should take approximately 2 to 15 minutes, depending on the tape device and AS/400 model (NOTE: RISC AS/400s may take longer if not using a RISC installation tape due to the extra time it takes to convert IMPI programs to RISC programs). The install program displays a message when it is finished that the install was successful.
If any problems occur during the install:
1. Check the joblog to determine the cause of the error.
2. Correct the problem, if possible.
3. Re-run the installation command.
4. If problems persist, please contact support.

Objects Installed

The following objects were created/restored on the AS/400 by the installation program:

Merchant/400 objects were restored to the Web server's product library (WWWSERVER).
A directory named WWWServ was restored into the root of the IFS file system when Commerce Server/400 was installed. WWWServ contains many other directories and stream files that are used by Web Server/400 or Commerce Server/400. Merchant/400 publications were restored into the WWWServ/WebDocs/Shipped/Pubs/Merch400 directory.
Documents for the sample I/NET store application were restored into the /WWWServ/WebDocs/Shipped/Merchant directory.
The library WWWMRCH was restored. WWWMRCH contains the sample I/NET Store application that is used to demonstrate how the API functions. Don't forget to add this library to the list of Script Libraries (with the ADDWWWSCPL command) before attempting to run the sample application.
Important note: Merchant/400's sample content and publications will always be shipped in the Shipped directory. Users should not place content in this directory for it may be deleted or over-written in the future. In addition, the sample I/NET Store application will always be installed into the WWWMRCH library and the /WWWServ/WebDocs/Shipped/Merchant directory. The contents of these areas should be duplicated by the user to another library and directory for actual use, as they may be deleted or over-written in the future.