Work with URL Mappings Tool

Owned by Emily Seage
Last updated: Aug 16, 2023 by Jessica Tomkins
3 min read



This tool is specific to the IBM i platform.

Starting with Profound UI Version 5, Fix Pack 10.0, we provide a tool to maintain URL mappings used for Universal Display Files. This utility can be used with the Rich Display or Genie module of Profound UI. This tool makes it easier for users to add, change and delete URL mappings without having to use a separate database editing utility. You can find more information on URL mappings here. 

The name of the command used to call this tool is PUIWRKMAP. 

Using PUIWRKMAP in Genie

The PUIWRKMAP command is a standard command that can be run from the command line in Genie. You also have the option to use PUIWRKMAP in a CL program in order to call it from your applications. 

Using PUIWRKMAP in a Rich Display Session

In order to use PUIWRKMAP from your Rich Display program, we suggest placing the command in a CL program. The purpose of creating a CL program for this would be to control the library list for your Rich Display File application. You could then set up your CL program as the 'initial program' in the Visual Designer, or call it as a Rich Display from Atrium. 

The PUIWRKMAP Screen

The image above is the main screen for PUIWRKMAP. Here you can see the multiple components of a URL mapping (URI Mapping, Library, Program, and Signon). This tool offers the ability to sort (ascending or descending) on any of the four columns as well as the ability to find or filter the data in the columns – you can find these options by right-clicking on a column header. PUIWRKMAP will also use the web browser's "local storage" to remember the sort that you place on any of the columns. There is a reset option available for the grid if you want to reset the sort order at any time, you can find this option by right-clicking on a column header. 

The following options are available for PUIWRKMAP: 

  • Add – allows you to add a URL mapping to the PUIMAPP file. On the 'Add Record' screen, there is no need to type capital letters for the library and program name, as the program will automatically change these to uppercase when you add the record. You will also use the slider to choose whether or not the record will require HTTP authentication. This defaults to 'No' but you simply need to click on the slider to change it to 'Yes'. 

  • Change – allows you to change an existing record from the PUIMAPP file. You can select multiple records to change by holding the 'Ctrl' key when selecting rows. After you've selected your records, you can press the 'Change' button to bring up the 'Change Record' screen. Similar to the 'Add Record' screen, it's not necessary to capitalize the library name or the program name as this will be done for you upon clicking the 'Change' button. Once you click the 'Change' button, it will either show you the next record you've chosen to make changes to or it will return you back to the main screen where you should see the changes you've made. 

  • Delete – allows you to delete a record from the PUIMAPP file. You can choose multiple records to delete at the same time by holding the 'Ctrl' key when selecting rows. After you've chosen the record(s) you wish to delete, you can press the 'Delete' button to bring up the 'Delete Record' screen. This screen will ask you to confirm that you want to delete the selected record(s). If you choose 'Yes', the record(s) will be deleted and you will return to the main screen. 

  • Exit – exits the PUIWRKMAP application.