Add or change the “config” parameter in the menu item link to “&config=advanced”. Then IceCap will use the “advanced” part of the icecap_config.xml file.

<advanced>

    <!-- Config for advanced (saa). Override default tags and new tags -->

    <defaults

      trace="yes"

      tracePath="trace/"

      logClientActions="no"

      showTitle="no"

      showOptionText="no"

      showOptionField="no"showKeysText="no"

      keysAsButtons="yes"

      contentLocation="east"

      moreOptionsKey="F23"

      moreKeysKey="F24"

      messageLine="24"

      defaultGenerelTheme="xtheme-slate.css"

      defaultIceCapTheme="Slate"

    />

    <emulator

      program="/menu/icecap.aspx"

      useHints="yes"

      hintsXMLhive="menu"

      hintsXMLpath="advanced.xml"

      numberOfSubfilePagesToStack="2"

      method="advanced"

    />

    <panelSelectionPosition/>

    <optionText>

      <itemtext="TYPE OPTION" startPosition="1" endPosition="20"/>

      <itemtext="INDTAST VALG" startPosition="1" endPosition="20"/>

      <itemtext="ANGIV VALG" startPosition="1" endPosition="20"/>

    </optionText>

    <optionField>

      <itemtext="OPT"startPosition="1" endPosition="8"/>

      <itemtext="VLG"startPosition="1" endPosition="8"/>

      <itemtext="VAL"startPosition="1" endPosition="8"/>

      <itemtext="VALG"startPosition="1" endPosition="8"/>

      <itemtext="FNC"startPosition="1" endPosition="8"/>

    </optionField>

    <subfileEndText>

      <itemtext="MORE"startPosition="60" endPosition="132" moreIndicator="yes"/>

      <itemtext="BOTTOM"startPosition="60" endPosition="132"/>

      <itemtext="MERE"startPosition="60" endPosition="132" moreIndicator="yes"/>

      <itemtext="SLUT"startPosition="60" endPosition="132"/>

      <itemtext="+"startPosition="60" endPosition="132" moreIndicator="yes"/>

    </subfileEndText>

  < /advanced> 

IceCap try to recognize the 5250 subfile, and convert it to a grid using in “optionText”, “optionField” and “subfileEndText” tags from the “advanced” part, and saved the recognition into the xml file specified in the “hintsXMLhive” and “hintsXMLpath” tag. It is the “method” tag, which tells IceCap to emulate with “advanced” functions and layout.

It is the same with the "icecaped" method as “advanced”, but use the “icecaped” part of the icecap_config.xml file. The difference between “advanced” and “icecaped” method, is primarily, that the “icecaped” method, insert option field in the grid and you get a “gear” icon in the upper right corner (described later).

You can create as many “group” tag in the icecap_config.xml file as you like, just like “advanced” and “icecaped”, and use different break out programs for each “group”.

This example is for one of own products “IceQuery”:

<iceQuery>

    <breakOut

      NavigatorProgram="ICEQUERY/USERNAVI"

      emulatorProgram="ICEQUERY/USEREMUL"

      pcoProgram="*LIBL/USERPCO"

      deviceNameProgram="*LIBL/MYDEVICES"

      varyoffExitProgram="*LIBL/VOFEXTPGM"

      clientXtypesPath="/icequery/scripts/xtypes.js"

      clientScriptPath="/icequery/scripts/breakouts.js"

    />

</iceQuery> 

Use this “group” by specify it, in the menu item link: “&config=iceQuery”. 

Currently, just the examples in the source file QSAMPLE in library ICECAP, and the documentation of the “IceCap emulator APIs” under “Administration”.