M-PS 7.2 Installation Guide for IBM i

REQUIREMENTS

This guide explains the installation and update procedures for M-Processing Server on an IBM i system. As a reminder, it is recommended to also update the other Mapping Suite software components at the same time to prevent errors due to version conflicts.

SYSTEM

Minimum requirements:

• OS/400 V7R1 or higher
• 40 Mb of free disk space
• FTP connection

If you are updating M-Processing Server:

• An interruption of the print service should be planned
• Make sure you back up the production library

Note: On OS/400 V7R1 and higher, the versions of M-Processing Server older than 7.1 are not compatible.

SECURITY

An IBM i administrator profile of type QSECOFR is required to install the software.

UPDATE OR INSTALLATION PROCEDURE

UPDATE INFORMATION

The installation program updates all the binaries used by the application.

The M-Processing Server configuration files and objects declared (robots, queues, rules, actions, etc.) are not modified.

PREPARATION

The software installation program can be downloaded from the Mapping Suite technical server at https://server.mappingsuite.com. It is called Mxxxxx.SAVF.zip.

After downloading and uncompressing it, it can safely be renamed to MSETUP.SAVF.

BEFORE UPDATING OR INSTALLING

1. Stop the MAPPING sub-system

2. Stop printing

3. Exit the menus

4. Run this command to check that the library is not in use:

WRKOBJLCK QSYS/MAP400 *LIB 

5. Run the following commands to check who’s the owner of the Mapping library. The name of the Mapping library is MAP400 by default:

DSPOBJD OBJ(MAP400/*ALL) OBJTYPE(*ALL) OUTPUT(*OUTFILE) OUTFILE(QTEMP/CHECKOWN)
STRSQL
SELECT * FROM QTEMP/CHECKOWN WHERE ODOBOW <> 'QSECOFR'

If there are objects that are not owned by QSECOFR, you will need to change that, or they will not be restored. Run the CHGOBJOWN command to change the owner.

Example:

CHGOBJOWN OBJ(MAPOBJ) OBJTYPE(*FILE) NEWOWN(QSECOFR) CUROWNAUT(*SAME)

To change the owner of all objects in a library:

CHGOWN OBJ('/qsys.lib/map400_sd.lib/*.*') NEWOWN(QSECOFR)

INSTALLING OR UPDATING BY FTP

CREATING THE RESTORE SAVF

Run this command:

CRTSAVF FILE(QGPL/MSETUP)

TRANSFERRING THE MSETUP.SAVF FILE TO THE ISERIES

Under Windows in Start/Programs, choose MS-DOS Command Prompt:

Go to the folder where the file you have just downloaded is saved.

Enter ftp "AS400 IP address" (no quotes) e.g. ftp 9.5.5.3

And then sign in on the AS400:

user :

pwd :

Enter binary

Enter cd qgpl (or the library of the savf file you have created)

Enter put msetup.savf

… (the file is being transferred and then you regain control)

Enter close

Then quit

And then exit

RESTORING THE SAVF

Run this command:

RSTOBJ OBJ(*ALL) SAVLIB(QTEMP) DEV(*SAVF) SAVF(QGPL/MSETUP)

LAUNCH THE INSTALLATION SCRIPT

Run this command:

CALL PGM(QTEMP/RUNSETUP)

Enter the name of the library you want to install or update.

If you are installing the product, you will need to specify the following:

• Sub-system name (the sub-system is created in the library where the product is restored)
• System LANGID and code page (the code page must always be 4 digits e.g. 0037 or 0500)
• Installation folders

After that if you are installing the product, you will need to enter the software activation codes called software keys. If you do not do it now, you can do it later by running the MAPKEY command. See Software Activation.

If you are updating the product or do not have the software activation keys now, press F3 to skip.

Note: After installing and before using the product, you will need to end the session and sign back in.

AFTER UPDATING

1.Run non-regression tests

2.Activate the MAPPING sub-system: STRRBT (*NO)

3.Checks for any errors:

Run this command to see installation messages: DSPJOBLOG OUTPUT(*PRINT)

Other points you might want to check: Read the DSPJOBLOG at the end of the process. If you sign off, do a SIGNOFF *LIST to retrieve installation errors or warnings

To check for any restore errors (object locked, wrong owner, etc.), run this command in STRSQL: SELECT * FROM qtemp/RSTMAP400 WHERE RSOSTA = '0'

You should have two backups: The first one in the MAP$$400 library. If there’s a problem, you can rename it to MAP400. The second one in the MAP$$400SF library contains all SAVFs of all installations on this system. You can free up disk space by deleting both libraries.

LANGUAGE

SELECTING THE LANGUAGE IN THE MAPPING MENU

The screens of the Mapping menu can be displayed in the following languages:

• English: MAPMSGENU
• French: MAPMSGFRA
• German: MAPMSGDEU
• Italian: MAPMSGITA
• Spanish: MAPMSGESP

The language is specified in the environment settings (Language File + Language ID).

SOFTWARE ACTIVATION

After installing the software, you will need to enter activation codes called license keys. The license keys are hardware-dependent. To obtain the license keys for your system, you will need to:

• Retrieve the system id
• Contact Technical Support, or log on to https://server.mappingsuite.com

Note: If the license keys are not entered, some screens in the Mapping menu cannot be accessed.

SERVER ID

Run the MAPKEY command to retrieve the information needed to generate your license keys.

Write down the information displayed and then press F3 to exit.

ENTERING THE LICENSE KEYS

The number of license keys required depends on the options purchased.

For each key, run the MAPKEY command and enter the product number associated with the key, and then press Enter to save.

Note: If the key you have entered is correct, nothing happens. If not, the key is highlighted and you need to enter it again.

PAGE REFILLS

This section relates to ON-DEMAND licenses only, with a limited number of pages purchased.

Volume based pricing (On-Demand) is for customers who want to purchase a limited number of pages that they are allowed to process with M-Processing Server. In this case, a second license key called a “page refill” must be entered to specify the number of pages that M-Processing Server can process in a year. Page refills are also hardware-dependent.

ON DEMAND INITIALIZATION

To initialize the On-Demand codes and retrieve the information needed to generate the page refill, you will need to run the MAPADDPTS command at least once for the first time:

ENTERING THE PAGE REFILL

Each M-Processing Server page refill key has a number or type (1) and a value (38 hex characters).

Each page refill sent by Mapping Suite comes with an additional Security Key (type = 1) that gives you an additional 10% in case you run out of pages. This key should not be entered.

Note: If the key you have entered is correct, nothing happens. If not, the key is highlighted and you need to enter it again.

At any time, you can know how many pages there are left. Run the MAPADDPTS command and then press F3 to exit.

POST-INSTALLATION CONTROL STEPS

This section is designed to help you check that the installation process was successful, and that the Mapping environment is configured correctly. Just follow each step as explained. All checkpoints are listed to ensure that you can use the software as intended.

ACTIVATING THE MAPPING USER ACCOUNT

The first thing you want to do is to activate the MAPPING user account on the system. By default during the installation process, the MAPPING user account is created with a blank password. Run the CHGUSRPRF command to set a password for the MAPPING user account. If you do not do that, you will not be able to use this user account for test purposes. The MAPPING user account has all the permissions needed to use the MAPPING software. It’s an account of type *PGMR that can be used as you see fit, if necessary.

CHECKING THE MAPPING ENVIRONMENT

On the command line,

• Type GO MAPPING to open the main menu
• Select option 14 (Operations Menu)
• Choose option 1 (Set Mapping Environment)

The paths are displayed in the lower end of the screen and the values depend on the system language. The values may vary with the system on which the software is installed.

CHECKING THE IFS

It is also recommended that you check the IFS. The easiest way to do this is to run the WRKLNK command.

In any case, the following folders should be found in the IFS:

• mapout
• mapping
• mapreport
• mapsend

SYSTEM OBJECTS REQUIRED BY MAPPING SOFTWARE

Another thing you might want to do is check the Job Queues and Job Descriptions required for use with Mapping.

Run the WRKOBJ command to list MAP* objects.

The following Job Queues are required:

• MAPQFIND
• MAPQMIDDLE
• MAPQROBOT
• MAPQSLOW
• MAPQSMTP
• MAPQSMTP2
• MAPQSPEED
• MAPQTCPIP

The following Job Descriptions are required:

• MAPDFIND
• MAPDMIDDLE
• MAPDROBOT
• MAPDSLOW
• MAPDSMTP
• MAPDSMTP2
• MAPDSPEED
• MAPDTCPIP

STARTING THE ROBOT

Run the STRRBT command to start the robot, and then run the WRKSBS command to show the sub-system.