Creating Customized Strategi Error Messages

Product: Strategi
Modified Date:

The Resources area of a Strategi website is unique from other areas of your website. Resources is updated with every Strategi upgrade, whereas other areas of your website will remain untouched by the upgrade. Since the Resources area will be overwritten whenever an upgrade is performed, it is important not to modify any documents, web pages, etc. in the Resources website.

It is quite reasonable, however, to wish to customize the Strategi error pages served out of the Resources website.

When an error page is about to be served, Strategi will look in the current zone for the error page. If it doesn't find it (i.e., no '/messages' subdirectory exists), Strategi will move up to the website level and look for a zone with a subdirectory of '/messages'. If the message it's looking for is not found within that website, it will serve the unmodified error page out of the Resources website.

Note: If you create a '/messages' directory within a zone, but do not copy all the messages to that zone, the missing error message will be served out of the Resources website regardless of whether a zone with subdirectory '/messages' exists within the website.

For purpose of this document, we will assume that DEFAULT refers to the website that you wish to copy these files into.

The instructions below detail how to make a copy of the Resources website MESSAGES zone.
1. Sign on to the iSeries 400.
2. Go to the Strategi Main Menu and select Work With Websites.
3. Go to the RESOURCES website
4. Temporarily change RESOURCES status to *ACTIVE
5. Grant *READWRITE Zone Authority to the MESSAGES zone for the user carrying out these instructions.
6. Go to the DEFAULT website
7. Select Work With Zones
8. Create a new zone (i.e., MESSAGES) by pressing F6
Zone Code = “messages” (do not include quotes in name)
Subdirectory = “/messages”
Text Description = “enter your custom description”
User Authentication = *NONE
Default User Authority = *READ
9. Grant *READWRITE Zone Authority to the new MESSAGES zone for the user carrying out these instructions.
10. Start Webmaster on your PC.
11. CHECK OUT your new MESSAGES zone.
12. Obtain a copy of the MESSAGES zone from the RESOURCES website using GET ZONE (GET ZONE will check-out and check-in the files).
13. On your PC, copy the RESOURCES files to the new MESSAGES zone folder.
14. CHECK IN your MESSAGES zone.
15. Go back to the Strategi Main Menu. Change the RESOURCES website status to *SUSPENDED and remove the user (from the zone) that was granted *READWRITE Authority from step #3 above.
16. Verify the files copied successfully to your iSeries 400 by going to your new MESSAGES zone and Work With Directory.

To begin customizing your copies of the RESOURCES website MESSAGES documents, go back to Webmaster and CHECK OUT your new “/messages” zone in your DEFAULT website.

If you decide to create a "messages" directory within an individual zone, you will need to do the following:

  1. On your PC, CHECK OUT the zone you wish to copy the messages into
  2. In Windows Explorer, create a folder called "messages" under the zone folder
  3. Copy over ALL the error message pages to your new "messages" folder
  4. CHECK IN the zone
  5. You will now see a new directory created within the zone, called MESSAGES

** End of Technical Support Bulletin **