Markup Language Skeleton Customization › Specific Customization › Editing an HTML Skeleton After Generation

Editing an HTML Skeleton After Generation

When an HTML skeleton has been generated, it exists as a source member in YMLSSRC in Y2WEB. While it is possible to edit the skeleton in that form using SEU, it is easier to edit it as an HTML document on a PC. To do this, you must convert the skeleton source member into a document in the WEBOPT directory in the IFS, using the YPRCSKL command.

Once the skeleton is available as an HTML file on the PC, you can edit it using a graphical HTML editor or a text editor. You can make almost any changes to a generated skeleton, but there are particular sections of generated HTML that you should leave in the skeleton:

• The message display line on row 24; the HTML for this is shipped as:

  <FONT COLOR=RED SIZE=3>(_v1842)</FONT>
  

  This line shows any error messages, it is generated from the *ERRORLINE section in the YMLSSYNRFP Markup Language Skeleton syntax file. If you change the *ERRORLINE record in YMLSSYNRFP, you must ensure that the (_v1842) tag remains.

• Web Option data tags

  The CA 2E data tags in the skeleton correspond to runtime data, which is only available from the 5250 data stream when the application is running. Some of these tags are for text such as the Program Name and time, which appear on a standard CA 2E generated panel; this type of text does not need to remain on the HTML page for the underlying program to function correctly. However, a lot of the tags correspond to field data that is retrieved from the underlying green-screen at runtime; these tags should be left in the skeleton.

  To identify which tags correspond to file data:

  1. Take a screen print of the function running in the browser and convert the HTML skeleton into an HTML file (which you can copy onto your PC).
  2. Open the HTML file and take a screen print so that you can see where all the 2E tags are.
  3. Compare the two views to determine what tags you need to keep.
• The CONFIRM prompt

  Leave in the CONFIRM prompt; it is usually required in an Update function, if confirmation is required when records are added, changed, or deleted. This is normally defined on line 24 and the HTML is generated from the *CONFIRMPROMPT section in the YMLSSYNRFP Markup Language Skeleton syntax file.

After making your necessary changes to the skeleton, use the YPRCSKL command with option *CVTTOSKL, to copy it over to the HTML source file on the IBM i.

Note: If you customize a function skeleton and copy it to YMLSSRC, then you regenerate the skeleton for that function using the YGENMLS command, any changes you added are lost. At that point, you are back to your basic skeleton.