ASNA WingsRPG™ Reference Manual

Importing Message File Process

When an imported DDS file contains MSGID, ERRMSGID, SFLMSGID or MSGCON keywords, you must import the Message Files referenced by these keywords from the IBM i into the Wings Website. The message files must be present in the Wings WebSite to be able to render messages requested by the ASPX pages at runtime.

You do not need to import any other Message Files that are not referenced in the "MSG" keywords noted above.

Initiating the Import Process

Note that the IBM i server requested in the Dialog box requires the ASNA Monarch Collector, which has a program that opens the Message File, extracts all messages and writes a temporary file with the necessary information for this process to read and convert it to a new file in the PC local folder. The local folder must be indicated in the Web.config for the application to use the imported Message File, unless the default is used. See Locating Message File at runtime for a full explanation.

  1. With your Visual Studio Website project open, select the "MessageFiles" folder on the Solution Explorer panel.
    (If no such folder exists, create one using the Visual Studio "New Folder" command at the website project).

  2. Once the "MessageFiles" folder is selected using your mouse, click the right button.
  3. From the list of options select "Import iSeries Message File".
  4. Enter the location of the iSeries Message file by completing the entries presented in the Dialog box. Upon clicking the Ok button, information similar to the following will be displayed: 
    ------ Import started: Database: '*Public/ELM', Message File: 'NUTSNBOLTS/CUSTMSGF', Output location: C:\Projects\WingsWebsite\MessageFiles\' ------
Calling Collector to extract messages...
Collector completed extracting messages.
Creating output C:\Projects\WingsWebsite\MessageFiles\CUSTMSGF.amfx
A total of 10 messages written to Xml file
========== Import: succeeded. Elapsed time: 7,249 ms ==========

The format of new the file is described in detail in Imported Message File Format.