HTML (Hypertext Markup Language) keyword for display files

Use this field-level keyword on an unnamed constant field to have Hypertext Markup Language tags sent along with the 5250 data stream.

If the data stream is sent to a 5250 Workstation Gateway device, the HTML tags will be processed on the HTML browser. If the data stream is not sent to a 5250 Workstation Gateway device, the HTML keyword is ignored.

The format of this keyword is:

HTML('value')

HTML(&program-to-system-field);

A parameter is required for the HTML keyword. The parameter must be a valid HTML tag enclosed in single quotation marks, or in a program-to-system field. The program-to-system field can be any legal length and must be alphanumeric (A in position 35). The DDS compiler will not check the HTML syntax of the specified parameter. The browser that receives the HTML at run time will check the syntax.

The following keywords are not allowed with the HTML keyword:

COLOR
DATE
DFT
DSPATR
EDTCDE
EDTWRD
HLPID
MSGCON
NOCCSID
OVRATR
PUTRETAIN
SYSNAME
TIME
USER

Option indicators are not valid for this keyword. However, option indicators are allowed on the constant field.

The HTML keyword is not allowed in a field of a subfile record.

Example

The following example shows how to specify the HTML keyword:

|...+....1....+....2....+....3....+....4....+....5....+....6....+....7....+....8

     A
     A          R RECORD
     A                                  7 20HTML('<TITLE>')
     A                                  7 20HTML(&TAG);
     A                                  7 21HTML('</TITLE>')
     A            TAG           20A  P

HTML is a tag language where the order of the tags determines when they are processed. Row and column have no meaning in an HTML document. In this case, the row and column determine the order in which the HTML tags are sent to the browser. If the constant fields that contain the HTML keyword have the same row and column value, they will be processed in the order that they appear in the DDS source. For information about how to resolve HTML field overlap, see Chapter 6 of the Application Display Programming book Link to PDF .

If the ENHDSP (Enhanced Display) parameter on the CRTDSPF is set to *NO, the HTML keyword will be ignored. This will give users the ability to turn off the HTML keywords without recompiling.