GENML, SGENML

GENML generates an English listing in the same way as LIST. However, the result is embedded in a web page template specified by the user and saved to a file item.

SGENML is similar, but its output is in item-id order unless sort criteria specify otherwise.

Syntax

GENML file-specifier {item-list} {selection-criteria} {USING file-specifier} {sort-criteria} {output-specification} {format-specification} {macro-call} {(options}

SGENML file-specifier {item-list} {selection-criteria} {USING file-specifier} {sort-criteria} {output-specification} {format-specification} {macro-call} {(options}

Refer to Sentence Structure for descriptions of these parameters.

Operation

When executed, the GENML and SGENML commands prompt for the file and item into which to save the generated HTML, and for the file and item containing the HTML template into which the Reality data will be embedded. For example:

:GENML EMP ID-SUPP TITLE EMPNO WITH EMPNO = "02]"
Template file name or <RETURN> for default:HTML
Template item name:EMPTEMPLATE
Output file name:MYDIRVIEW
Output item name:emp.htm

This selects data from the file EMP and outputs the attributes identified by TITLE and EMPNO, suppressing the item-id (the TITLE and EMPNO data definition items use the XT conversion code). The output is embedded in the template item EMPTEMPLATE in the file HTML and saved in item emp.htm in the file MYDIRVIEW.

Note that if you press RETURN at the Template file name  prompt, you are not prompted for a template item. Instead a simple default template is used.

The P and T options respectively send the generated output to the printer and terminal. If you specify either of these options, you are not prompted for an output file or item.

Comments

Refer to HTML from English for details of how to write an HTML template and use the XT conversion code.

The specified files and template must exist – if they cannot be found, an error message is displayed and no output is produced.

See Also

LIST, SORT.