Green Screen to Web Options

These options allow you to adjust the way RPGsp will convert your programs. You can open the Green-Screen to Web options dialog by selecting Tools->Options from the menus, then selecting Green-Screen to Web from the navigation tree. 

Use Internal Copy Books for Clarity

When this option is selected, RPGsp will place all new code generated by the conversion process into iCopy sections. The new code primarily deals with displaying HTML screens, processing form input, and simulating subfiles in a Web browser. Rather than inserting large sections of new code into the original code, RPGsp can insert a reference to an iCopy section which is placed at the bottom of the source, after all of the original code.

The iCopy is then referenced by name, much like a subroutine.  Using iCopys results in clear code which closely resembles the original.  

The following example shows code that was converted without using iCopy:  

Here, the code inside of the Do Until loop has been generated by the wizard. The code was inserted directly into the original loop.

If iCopys were used, the resulting code would be much clearer:   

Here, the conversion process inserts a reference to an iCopy section, rather than inserting an entire section of code. You can jump to the actual iCopy section by right-clicking the iCopy name in the editor and selecting "Jump to iCopy Start".  

Generate New Code in Free Format Where Possible

When this option is selected, new code created by the conversion process will be generated in the free format syntax.

Show all Subfile Records at Once

By default, the conversion process will generate code to handle subfile paging for load-all subfiles. The conversion process will create Next Page and Previous Page buttons for navigating through the data.

When this option is checked, all records in the subfile will be displayed in the browser at one time, and the user will have a scrollbar to navigate through the records. This option is best used for subfiles that display a limited number of records. In this case, the scrollbar may be the most intuitive interface.  

For subfiles that will load many records, it is best to allow the wizard to generate paging code by leaving this option unchecked. You can always change the number of records to load on a subfile page by changing the SFLPAGx_ constant.

Combine Subfile and Subfile Control Records into One View

When this option is selected, the subfile and subfile control record formats will be combined in one set of HTML code and displayed in one designer tab so that both can be worked on at the same time without having to switch views.  

When this option is unchecked the subfile and subfile control records will be separated into two sections of HTML code. 

Add Hover Code to Subfile Rows

When this option is selected, RPGsp will generate code to highlight a subfile row when the user hovers the mouse cursor over the row.

Compile File Specifications as User Open Files

When this option is selected, RPGsp will define all files in use by the program as User Open. This is the default method for RPG Smart Pages. This allows the RPG Smart Page to set the library list before opening files. The library list that is set is the Runtime Library List, as specified in the Library Lists section of the Options dialog.  

You would uncheck this option if you wanted to control the library list on your own from CL programs. In this case, a starting CL program would set the library list, which would be maintained for the duration of the job, unless changed by another CL program.

This option should be used in conjunction with setting the runtime library list to *SAME. This will prevent the RPGsp page from attempting to set the library list after the files are open.

Silent Conversion

By default, the conversion process will try to determine if CALL operations within your converted program are calls to display file programs. This is done so that the conversion process can insert code necessary for handling HTML screen output.  

If unable to make the determination, the wizard will ask you for the answer. If this option is selected, the wizard will assume that all CALLs in the program are to display file programs, and will not ask the user for input.  

RPGsp’s automated mass conversion process is capable of analyzing your source code to make these determinations, and convert all necessary programs at once.

Allow Converted Programs to Run in Both the Browser and the Green-Screen

Choosing this option will enable your converted program to run both in the Web browser and in the Green-Screen. At runtime, the program will determine whether it’s running in a browser or in an interactive 5250 session. When running in a browser, HTML screens will be output. When running in an interactive 5250 session, the original WRITE, READ, and EXFMT processing will be performed on the display file.  

This allows you to run the program in both modes with one object and with only one set of source code to maintain.  

Open Converted Application in Code View

By default, RPGsp will open a converted application in Design View. When this option is selected, the initial view will be Code View.

Use CSS for Display Attributes and Colors

When this option is selected, the conversion process will use Cascading Style Sheet (CSS) classes to control all formatting of the screens. CSS classes are used to control things such as font type, colors, sizes, and other effects. The advantage of using CSS is that you can make changes to the presentation of your application by simply modifying a CSS class, rather than by working with the HTML code. When a CSS is updated, all programs that use the CSS are affected. This allows you to control formatting from one location.  

The CSS class names used will match the appropriate DDS keywords. For example, the RI class will be used to display a field or constant in reverse image.  

If this option is not selected, all formatting will be done in the HTML code using HTML tags and attributes.

Use Monospace to Preserve Alignment

When this option is selected, all text in the converted screen is displayed in a monospace font. A monospace font is one where all characters are exactly the same size. Using this option will help preserve the original text alignment in the converted screens.

HTML Encode Character Fields

Using this option will cause RPGsp to use RPGspHTMLEncode() on any character fields in the converted screen. This will ensure that data containing characters such as the ‘<’ and ‘>’ characters will display properly.  

A typical use of this option is for output fields that use multiple leading spaces. The browser would normally interpret this as one space, but encoding the field will cause all spaces to display.

Convert Subfiles To

The Green-Screen to Web conversion process allows you to choose between 3 methods of converting subfiles:  

• Simple Arrays: Subfiles will be converted to simple arrays. This method is compatible with all OS/400 (i5/OS) releases V4R4 or higher.  

• Multiple Occurrence Data Structures: Multiple Occurrence data structures will be used when converting subfiles. This method requires OS/400 (i5/OS) release V5R1 or higher.  

• Qualified Data Structure Arrays: This method produces the clearest code by using qualified data structure arrays. This is the recommended method for converting subfiles, but requires OS/400 (i5/OS) release V5R2 or higher.

Profound Logic Software, Inc.
www.ProfoundLogic.com
(937) 439-7925