Generating HTML Skeletons › Overview

Overview

The YGENMLS command executes a data-driven generator program that analyzes the DDS for a function and uses the following Web Option data sources to generate the HTML skeleton for the panel:

• Markup Language Skeleton Syntax file (YMLSSYNRFP)

  This file contains the core of the Web Option Markup Language Syntax generator. For every element (input field, output field, text, and record format definition) that appears in a single screen, there is a corresponding entry (or entries) in this file, which define how that element is generated.

• Web Option control values (held in YW2EVALRFP)

  This file contains a number of control values that define how certain elements of the MLS are generated.

You can modify the data in all the above files to customize the look and feel of your generated HTML pages.

The YGENMLS command allows you to identify a function by object surrogate or by the name of the generated DDS source member.

                  Generate Markup Language Skeleton (YGENMLS)

Type choices, press Enter.

DDS source member  . . . . . . .                 Name, *OBJSGT              
DDS file . . . . . . . . . . . .   QDDSSRC       Name                       
  Library name . . . . . . . . .     *GENLIB     Name, *GENLIB, *LIBL       
MLS file . . . . . . . . . . . .   YMLSSRC       Name                       
  Library name . . . . . . . . .     *W2ELIB     Name, *W2ELIB              
Model library  . . . . . . . . .   *MDLLIB       Character value, *MDLLIB...
Model object surrogate . . . . .   *FRMDDS       Number, *FRMDDS            
                           Additional Parameters                          
                                                                          
Web Option library . . . . . . .   *MDLVAL       Character value          
Existing skeleton option . . . .   *WARNMSG      *SAVE, *REPLACE, *WARNMSG

The parameters are as follows:

DDS Source Member (MBR)

Specifies the DDS source member that contains the generated DDS of the function you want to generate a markup language skeleton for.

Note: This is a required parameter.

*OBJSGT

The DDS source member name is retrieved by analyzing the function specified by the OBJSGT parameter

member-name

Specify the DDS source member name. The source member should exist in the file and library specified by the DDSFIL parameter.

Note: You cannot specify MBR(*OBJSGT) if OBJSGT(*FRMDDS) is also specified.

DDS Source file (DDSFIL)

Specifies the name and library of the DDS source file that contains the DDS source member for the generated function. This file defaults to QDDSSRC.

The possible library values are:

*GENLIB

The library is assumed to be the generation library for the model specified in the MDLLIB parameter.

*LIBL

All libraries are checked until a match is found.

library-name

Specify the name of the library to be searched.

MLS Source file (MLSFIL)

Specifies the name and library of the MLS source file that is the target for the generated MLS source. This file defaults to YMLSSRC.

The possible library values are:

*W2ELIB

This command uses the Web Option library specified in the YW2ELIB model value for the CA 2E model specified in the MDLLIB parameter.

library-name

Specify the name of the library to be searched.

MDLLIB (Model library name)

Specifies the model name used to generate the function for the required generated MLS source.

The possible library values are:

*MDLLIB

The model library is the first one in the current library list.

model-library-name

The name of the CA 2E model can be entered explicitly.

OBJSGT (Function Surrogate)

Specifies the object surrogate for the function that requires MLS generation.

*FRMDDS

The object surrogate is retrieved by analyzing the DDS source in the member specified by the MBR parameter

object-surrogate

Specify the object surrogate for the generated MLS function. The function must exist in the model library, specified by the MDLLIB parameter.

Note: You cannot specify OBJSGT(*FRMDDS) if MBR(*OBJSGT) is also specified.

W2ELIB (Web Option library)

Specifies the name of the Web Option product library.

The possible values are:

*MDLVAL

The command uses the Web Option library specified in the YW2ELIB model value for the CA 2E model specified in the MDLLIB parameter.

library-name

The name of the Web Option product library can be entered explicitly.

MBROPT (Existing skeleton option)

Specifies the action to take if the skeleton being generated already exists in the specified MLS file.

The possible values are:

*WARNMSG

If the YGENMLS command is being run within an interactive job, an inquiry warning message (Y2I1019) is sent. Depending on the response to this message, the existing skeleton is either saved or replaced. If the YGENMLS command is being run within a batch job, the existing skeleton is saved before the new skeleton is copied into the specified MLS file.

*SAVE

The existing skeleton is saved before the new skeleton is copied into the specified MLS file. The existing skeleton has the same name as the newly generated skeleton, but with the first character changed to Y. So, if a skeleton called H0001745 is being generated and a previously generated version of H0001745 already exists in the specified MLS file, the existing version is renamed Y0001745 before the new version is copied into the specified MLS file. If a saved skeleton called Y0001745 already exists in the specified MLS file, it is deleted.

*REPLACE

The existing skeleton is replaced with the new skeleton.