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).
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.
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.
The DDS source member name is retrieved by analyzing the function specified by the OBJSGT parameter.
Specifies the DDS source member name. The source member must exist in the file and library specified by the DDSFIL parameter.
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:
The library is the generation library for the CA 2E model specified in the MDLLIB parameter.
All libraries in the user and system portions of the job's library list are searched until the first match is found.
Specify the name of the library to be searched.
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:
The Web Option environment specified in the W2EENV parameter is used.
Specify the name of the target library for the generated MLS source.
Specifies the name of the CA 2E model that contains the function to generate a markup language skeleton.
Special value indicating the CA 2E model library is the first one in the current library list.
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.
Specify the name of the CA 2E model library.
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.
The object surrogate is retrieved by analyzing the DDS source in the member specified by the MBR parameter.
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.
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.
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:
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).
Special value indicating that the display file source contains special CA 2E Web Option Key Instructions which define the record formats to be processed.
Specifies a function type name which has previously been defined in the YMLSFMTRFP file.
Specifies the name of the Web Option environment.
The library is specified as the YW2ELIB model value in the CA 2E model specified by the MDLLIB parameter.
Specifies the name of the Web Option environment.
Specifies the action to take if the skeleton being generated already exists in the specified MLS file.
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.
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.
The existing skeleton is replaced with the new skeleton.
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.
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:
| Copyright © 2011 CA. All rights reserved. | Tell Technical Publications how we can improve this information |