How to Add a Hyperlink to a Screen Format and How to Make That Link Executable

Troubleshooting

Problem

This is a document describing how to add a hyperlink to a green screen application and how to make it executable.

Resolving The Problem

The hyperlink can be added to any green screen display just as any other constant string can be. This can be done in DDS or through the Screen Design Aid.
The DDS for this simple screen HYPER1:

     A          R HYPERLINK
     A                                  3  5'DOUBLE CLICK TO GO TO OUR SITE'
     A
     A                                  5 10'HTTP://WWW.IBM.COM'
     A                                      DSPATR(UL)

The RPG IV source name HYPERLNK

**free
   DCL-F HYPER1  WORKSTN;
 exfmt HYPERLINK;
 *inlr = *on;

Compile using CRTBNDRPG PGM(<yourlib>/HYPERLNK) SRCFILE(<yourlib>/QRPGLESRC) SRCMBR(HYPERLNK)

CALL <yourlib>/HYPERLNK

The method to making the hyperlink executable lies within the preferences of the IBM Access Client Solutions (ACS 5250 session). On the menu bar of a session, select Edit -> Preferences -> Hotspots. Then, in the Hotspots window, make sure the Execute URL box is checked.

Note: This must be done by any user who wishes to be able to execute hyperlinks from the green screen.
image-20241115120724-2

To execute the hyperlink, double click it. The hyperlink will run in your default browser. If your browser is not already open, it will be opened first and then the hyperlink will be executed.

Notes:
1. The hotspot seems to only recognize fully-qualified hyperlinks (those that begin with http:// or ftp:// ).
2. You cannot execute "www.ibm.com". It must be "http://www.ibm.com".
3. This is only tested for IBM Access Client Solutions (ACS 5250 sessions).
4. Other 5250 clients (Rumba, Mocha, and so on) may or may not be able to support this functionality.

[{"Type":"MASTER","Line of Business":{"code":"LOB68","label":"Power HW"},"Business Unit":{"code":"BU070","label":"IBM Infrastructure"},"Product":{"code":"SWG60","label":"IBM i"},"ARM Category":[{"code":"a8m0z0000000CHtAAM","label":"Programming ILE Languages"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions"}]

Historical Number

518010819

Was this topic helpful?

Document Information

More support for:
IBM i

Component:
Programming ILE Languages

Software version:
All Versions

Operating system(s):
IBM i

Document number:
634817

Modified date:
15 November 2024

UID

nas8N1013101

IBM Support

Tips