Previous Topic: Parameters

Next Topic: YINZW2E - Initialize Web Option

Usage Details

If you specify FORCE(*NO) and one or more client jobs are running, an error message displays. To end the Web Option server, you would then need to execute the command a second time, specifying FORCE(*YES).

YGENMLS – Generate Markup Language Skeleton

The YGENMLS command allows the user to generate one or more Markup Language Skeletons (MLS) for use with CA 2E Web Option for a specified display file. This command allows the user to identify display file by CA 2E function surrogate or by the name of the display file DDS source member. It works with a CA 2E-generated DDS, with a manually-created DDS, or a third-party tool generated DDS.

Parameters

MBR (DDS source member)

Specifies the source member that contains the DDS for the display file where you want to create a markup language skeleton.

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

*OBJSGT

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

member-name

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

DDSFIL (DDS source file)

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

The possible library values are:

*GENLIB

The library is the generation library for the CA 2E model specified in the MDLLIB parameter.

*LIBL

All libraries in the user and system portions of the job's library list are searched until the first match is found.

library-name

Specify the name of the library to be searched.

MLSFIL (MLS file)

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

The possible library values are:

*W2EENV

The Web Option environment specified in the W2EENV parameter is used.

library-name

Specify the name of the target library for the generated MLS source.

MDLLIB (CA 2E model library)

Specifies the name of the CA 2E model that contains the function to generate a markup language skeleton.

*MDLLIB

Special value indicating the CA 2E model library is the first one in the current library list.

*NONE

Special value indicating that the display file was not generated from a CA 2E model or that the CA 2E model is not available on this system. In this case, you must enter a CA 2E function type in the FUNTYP parameter.

library-name

Specify the name of the CA 2E model library.

OBJSGT (Model object surrogate)

Specifies the object surrogate for the CA 2E function to create a markup language skeleton.

Note: You can not specify OBJSGT(*FRMDDS) if MBR(*OBJSGT) is already specified.

*FRMDDS

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

object-surrogate

Specifies the object surrogate of the function to generate a markup language skeleton. The function must exist in the model library, specified by the MDLLIB parameter.

FUNTYP (Function type)

Specifies the type of function for which the DDS source member contains the display file specifications. This is used by the HTML generator to determine which record formats within the display file should be processed by this command.

This value is valid only if MDLLIB(*NONE) is specified.

CA 2E-function-type (*DSPFIL, *DSPRCD...)

Special value indicating that the function type is one of the 12 CA 2E function types for which a display file is generated.

The function types are:

  • *DSPFIL Display file
  • *DSPRCD Display record
  • *DSPRCD2 Display record 2
  • *DSPRCD3 Display record 2
  • *DSPTRN Display transaction
  • *EDTFIL Edit file
  • *EDTRCD Edit record
  • *EDTRCD2 Edit record 2
  • *EDTRCD3 Edit record 2
  • *EDTTRN Edit transaction
  • *PMTRCD Prompt record
  • *SELRCD Select record

One of these values should only be selected when the function was generated from a CA 2E model but the model is not available (for instance, when the model is on a different IBM i).

*AUTO

Special value indicating that the display file source contains special CA 2E Web Option Key Instructions which define the record formats to be processed.

function-type-name

Specifies a function type name which has previously been defined in the YMLSFMTRFP file.

W2EENV (Web Option environment)

Specifies the name of the Web Option environment.

*MDLVAL

The library is specified as the YW2ELIB model value in the CA 2E model specified by the MDLLIB parameter.

library-name

Specifies the name of the Web Option environment.

MBROPT (Existing skeleton option)

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

*WARNMSG

If the YGENMLS command is being run within an interactive job, an inquiry warning message (W2G1019) is sent. Depending on the response to this message, the existing skeleton will either be saved (see below) or replaced. If the YGENMLS command is being run within a batch job, the existing skeleton is saved (see below) 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. Therefore, if a skeleton called H0001745 is generated and a skeleton with that name already exists in the specified MLS file, the existing version is renamed to Y0001745 before the new version is copied to the specified MLS file. If a saved skeleton named Y0001745 already exists in the specified MLS file, it is deleted.

*REPLACE

The existing skeleton is replaced with the new skeleton.

*PRV

The value that was used with the previous generation request is used. You can determine this value by checking the contents of the YMLSGENOPT data area that is created in QTEMP when the YGENMLS command is first run within a job. If you specify MBROPT(*PRV) on the first execution of YGENMLS within a job, *WARNMSG processing is used.

Usage Details

The YGENMLS command can be run from a command line or from the Work with Screen Cross-references (YWRKSCRXRF) screen. The command is also available as an option from within a CA 2E model, and is available in the following areas within the CA 2E model: