HCL ZIE for Transformation
  Release Notes
    README
      Version 1.0
  Product Documentation
    Getting Started
      Introducing Z and I Emulator for Transformation
        What is ZIETrans?
        A ZIETrans 3270 example
        A ZIETrans 5250 example
        Roles and skills
          Casual Web developer
          Advanced Web developer
          User
          ZIETrans administrator
          WebSphere administrator
          Independent software vendors
        Where can I find information about ZIETrans?
      Installing ZIETrans
        Prerequisites
          HCL ZIETrans
          Other prerequisites
        Installing ZIETrans Toolkit
        Updating the ZIETrans Toolkit installation
        Modifying the ZIETrans Toolkit installation
        Adding the ZIETrans installation repository to IBM Installation Manager
        Uninstalling ZIETrans Toolkit
        Using silent install and uninstall
        Log files
      Flexera Licensing integration for ZIETrans Projects
        Secure License Server Configuration
        Enable Runtime Licensing in ZIETrans
        License terms and troubleshooting
        How does Licensing work in ZIETrans?
      Creating a basic ZIETrans project
        Introducing the Rational SDP environment
        Starting ZIETrans Toolkit and perspective
        Introducing the ZIETrans Welcome page
        Starting ZIETrans functions
          Using ZIETrans icons
          ZIETrans tips
        Developing a ZIETrans project
          Creating a ZIETrans project
          Testing your project
            Testing modes for Web projects
            Testing your Web project
            While testing your project
      Customizing your ZIETrans project
        Understanding how a ZIETrans application works
          Understanding ZIETrans resources
        Using the host terminal screen as you work
          Host screen preview
          Working with screen captures
        Updating your project's template
        Editing default rendering
        Creating global rules
        Working with screen events
          Creating a new screen customization
          Creating a new screen combination
          Ordering and enabling your screen events
        Working with transformations
          Understanding host components and widgets
          How ZIETrans uses transformations
          Creating a new transformation
            Editing a transformation
        Performing other customization tasks
          Auto advance
          Displaying function keys (PF keys)
          Replacing text strings from the host screen
          Using macros
          Using Host Publisher artifacts
          Creating background connections
          Defining global variables
          Applying business logic
          Using keyboard support
          Specifying a workstation ID
          Using print support
          Subfile support
          Using Extended Field Attributes
          Enabling Enhanced Non-Programmable Terminal User Interface (ENPTUI)
          5250 HTML DDS keyword support (Web-only)
      Preparing your ZIETrans project for use as an application
        Deploying ZIETrans Web applications
          Exporting your project as an application
          Installing your application in a runtime environment
      Glossary
    User's and Administrator's Guide
      Using Z and I Emulator for Transformation (ZIETrans)
        Understanding ZIETrans key concepts and objects
        Understanding ZIETrans application processing
        Understanding ZIETrans application development
        How do I know what version of ZIETrans I have?
        Gathering problem determination information
        Where can I find information about ZIETrans?
      Developing and deploying ZIETrans Web applications
        Organizing ZIETrans Web applications
          Moving ZIETrans Web projects to a different .ear file
        Backing up your ZIETrans projects
        Exporting and importing ZIETrans Web projects
          Exporting a Web project
            Archive file
          Importing a Web project
        Deploying ZIETrans Web applications
          Enabling the ZIETrans runtime
          Exporting your project as a Java EE application
          Installing your application in a runtime environment
          Changes necessary in the runtime environment
            Configuring class loader policy
            Configuring ZIETrans applications in a clustered environment
            Configuring ZIETrans applications to use a proxy server
        Developing ZIETrans applications for the Apache Geronimo Server
          Installing and configuring for Geronimo servers
          Considerations and limitations for Geronimo servers
        Developing ZIETrans applications for Oracle WebLogic Server
          Installing and configuring for WebLogic servers
          Considerations and limitations for WebLogic servers
        Developing ZIETrans applications for IBM Bluemix Server
          Configuring Rational SDP for IBM Bluemix server
          Considerations and limitations for IBM Bluemix Server
        Developing ZIETrans applications for Web Sphere Application Server Liberty Porfile
          Considerations and limitations for WebSphere Application Server Liberty Profile
        Developing ZIETrans applications for mobile devices
          Considerations and limitations for mobile devices
          Considerations and limitations for iPad devices
          Considerations and limitations for Android devices
      Modifying a ZIETrans project
        Overview
        Connections
        Template
        Rendering
          Default rendering
            Multiple rendering set example
            Advanced rendering
              Alternate rendering
              HTML tables
            How to make default rendering customizations available in new ZIETrans projects
          Global rules
          Text replacement
          Components and widgets
            Components
            Widgets
          Toolbar (RCP-only)
          Application keypad
          Host keypad
          Operator information area
          DBCS
        Events
          Screen event priority
          Application events
        Other
          Keyboard support
          Client locale
          Connection parameter overrides
            Selecting the type of connection to use when overriding parameters
            The disconnectOnClose parameter
          Asynchronous Update (RCP-only)
          Automatic Disconnect and Refresh (Web-only)
            Using the client pull (AJAX) method
              Client pull (AJAX) settings
            Using the server push (applet) method
              Server push (applet) settings
          Global variable overrides
          Client settings
          Macro Content Assistance
        Source
        Using ZIETrans preferences
        Use of other Rational SDP preferences
      Managing connections
        Creating a connection
        Connection editor
          Overview
          Basic
          Advanced
          Printing
            Print settings for 3270E connections
            Print settings for 5250 and 5250W connections
          Screen Handling
          Security
          Pooling
          Macros
          User List
            Clustering and user lists
          Source
      Working with screen events
        Create a Screen Customization wizard
        Create a Screen Combination wizard
        Editing screen events
          Overview
          Screen Recognition Criteria or Begin Screen
            Associated screen capture
            Fields criteria
            Cursor position criteria
            Optional versus non-optional screen recognition criteria
            Inverted match of screen recognition criteria
            Additional criteria
              String criterion
              Global variable criterion
              Color criterion
              Compare region to value criterion
              Compare region to region criterion
              Condition criterion
              Custom criterion
          Rendering (screen combination only)
          Navigation (screen combination only)
          End Screen (screen combination only)
            Select ending criteria
            Number of iterations
            Associated screen capture
            Screen descriptor settings
          Actions
            Apply transformation action
            Execute business logic action
            Extract global variable action
            Insert data action
            Set global variable action
            Remove global variable action
            Send global variable action
              Common considerations:
            Show URL or SWT composite action (RCP-only)
            Show URL action (Web-only)
            Forward to URL action (Web-only)
            Play macro
            Perform macro transaction
            Send key
            Disconnect
            Pause
          Global Rules
          Text Replacement
          Next Screen
          Source
        Inhibited screens
          Recognition criteria
          Automated handling of inhibited screens
          Handling multiple inhibited screens
        Importing BMS map sets
      Working with transformations
        Create a Transformation wizard
        Editing transformations
          Editing transformations for Web projects
            Design
            Source
            Split
            Preview
        Transformation wizards
          Insert Host Component
          Edit Host Component (Web-only)
          Insert Default Rendering
          Edit Default Rendering (Web-only)
          Insert Tabbed Folder (Web-only)
          Insert Macro Key
          Insert Global Variable
          Insert Operator Information Area (Web-only)
          Insert Host Keypad
            Default Keypad (Web-only)
            Custom Keypad (Web-only)
             Individual Key
          Insert Application Keypad
            Default Keypad (Web-only)
            Custom Keypad (Web-only)
            Individual Key
          Insert All Host Components (Web-only)
          Insert Stored Screen (Web-only)
        Previewing transformations
        Host keypad
      Component and widget descriptions and settings
        Component and widget settings
        Host component settings
          Command line
          Dialog
          ENPTUI
             Scrollbar field (ENPTUI)
             Selection field (ENPTUI)
          Field
          Function key
          HTML DDS keyword (Web-only)
          Input field
          Input field with hints
          Item selection
          Light pen (attention)
          Light pen (selection)
          Selection list
          Subfile
            Action
            Header
            Data
            Marker
          Table
          Table (field)
          Table (visual)
          Text
          URL
        Widget settings
          Button
          Button table
          Calendar (Web-only)
          Check box
          Combo (RCP-only)
          Dialog
          Drop-down (data entry)
          Drop-down (selection)
          Field
          Graph (horizontal bar, line, vertical bar)
          Label
          Link
          Link (item selection)
          List
          Popup
          Radio button (data entry)
          Radio button (item selection)
          Radio button (selection)
          Scrollbar (ENPTUI)
          Subfile (check box)
          Subfile (drop-down)
          Subfile (popup)
          Table
          Text input
          Toolbar (RCP-only)
        Component and widget mapping
      Using templates
        Template examples
        Create a Template wizard
        Editing templates
          Editing templates for Web projects
            Design
              Using style sheets
                Modifying style sheets
                Determining which styles to edit
              ZIETrans style sheets
              Design tab considerations and limitations
            Source
            Split
            Preview
            Making customized templates, style sheets, and images available
        Application keypad
      Macros and host terminal
        Macro Editor
          Overview
            Open Host Terminal
              Host Terminal
                Macro related icons
              Host Screen Preview
            Advanced Editor
          Prompts and Extracts
          Source
        Working with macro errors
        Importing a macro
        Exporting a macro
        Macro hints and tips
          Preventing an infinite loop
          Handling transient screens
      Interacting with global variables
        Renaming global variables
        Differences between global variables and macro variables
          Global variables
          Macro variables
      Using Integration Objects
        Creating an Integration Object
        Integration Object chaining
          Deciding when to use Integration Object chaining
          Using Integration Object chaining
          Debugging applications that use Integration Object chaining
        Building Web pages from an Integration Object
          Create Model 1 Web pages
          Create Struts Web pages
          Create JSF Web pages
        BasicIOErrorPage.jsp and AdvancedIOErrorPage.jsp
        Working with Integration Objects on JSPs
          Insert Integration Object Properties
            Input
            Output
          Insert Forward to ZIETrans Application
      Combining screens
        Combining contiguous output data
        Combining noncontiguous output data
        Combining output from multiple applications
        Combining input for multiple screens
      Enabling print support
        Configuring the host print session on 3270 hosts
        Defining print support for your project
          For 3270E connections
            Using the Host On-Demand PDT compiler
          For 5250 connections
        Providing documentation for users
      Enabling keyboard support
        Defining keyboard support
        Changing the appearance of the keypads
        Providing documentation for users
          Special 5250 field key support
            Default field keypress combinations
            Quick Field Exit
            Quick Field Minus
            Alternate way to input negative numbers
            Field Exit Emulation
        Remapping the keyboard in a ZIETrans application
          Concepts to understand before remapping ZIETrans keys
            Mnemonic keywords
            Determining keycode values
          Remapping keys for ZIETrans Web applications
            Example
          Adding additional keypad buttons to a transformation
      Using host simulation
        Host simulation wizard
        Host simulation editor
          Overview tab
            General Information section
            Playback Settings section
          Source tab
        Recording in the runtime environment
        Playback options
        Importing and exporting trace files
      Using ZIETrans administrative console
        ZIETrans administrative console and WebSphere security
        ZIETrans administrative console roles
        Starting ZIETrans administrative console
          Starting the administrative console while in ZIETrans Toolkit
        Using the functions in ZIETrans administrative console
          Selecting management scope
          Managing licenses
          Monitoring connections
          Monitoring connection pools
          Monitoring pool definitions
          Monitoring user lists and user list members
          Administering problem determination components
            Log and trace file names
            View Log
            Set Log Options
            Set Trace Options
        Display terminal functions
          Using display terminal for testing and debugging
      Security and Web Express Logon
        Enabling SSL security
        Enabling SSH security
        Using Web Express Logon (WEL)
          Overview
          Architecture
          Planning for implementation
          Implementation
          How to create a WEL logon macro
          Network Security plug-in
          Credential Mapper plug-ins
            Credential Mapper selection
          Initialization parameters
            DCAS parameters for DCAS/RACF/JDBC Credential Mapper plug-in
            DCAS parameters for Certificate-based DCAS/RACF Credential Mapper plug-in
            Vault parameters for JDBC Vault Credential Mapper plug-in
            Vault parameters for the WebSphere Portal Credential Vault Credential mapper
          Create SSL keystore file (DCAS only)
        Using Kerberos service tickets
        Java 2 security
          Policy file
        Using IBM Certificate Management for ZIETrans applications
          Creating a key database file
          Requesting and storing certificates from Certificate Authorities
            Creating the certificate request
            Sending the certificate request
            Storing the certificate
          Using a self-signed certificate
          Exchanging certificates
          Certificate Management tool considerations
            DOS window
            Run as administrator
            Using IBM CMS keystore files
      Language support
        Language codes
        Code pages
        Encoding settings
        5250 Unicode support
        Using accented characters for code page 937
        Using code page 1388 (GB18030)
        Host code mapping for code pages 1390 and 1399
          JIS2004 support
            JIS2004 support considerations and limitations
            JIS2004 support for PDT printing and Print-to-File for 3270E sessions
            Disabling JIS2004 support for code pages 1390 and 1399
        Remapping keyboard and display characters
          Priority of character replacement
      Double-byte character set support
        DBCS and SBCS field support
        Data type checking
        Field length checking
        Copy-and-paste prevention
        Input Method Editor (IME)
        AutoIME switching
        Shift Out/Shift In considerations
        Other considerations
          Project theme settings
            DBCS eliminate maximum length
          Project settings editor
            Rendering tab
              DBCS
            Other tab
              Enable automatic field advance
              Overwrite mode (initial)
              Select all text on focus
          Screen event editor
            Screen recognition criteria / Begin screen
          Host components
            Selection list
            Subfile
            Table
          Widgets
            SBCS eliminate maximum length
          Macro support
            Recording a macro
            Exporting a macro
          Creating an Integration Object
          Working with mobile device applications
          Remapping keyboard and display characters
          Working with user-defined characters
            Display support
            Print support
            Printing UDCs in Adobe PDF mode
            Printing UDCs in PDT mode
            Limitations
      Appendix A. Runtime properties files
        Tracing options
        Host On-Demand tracing
        Host simulation tracing
      Appendix B. ZIETrans screen-settling reference
        Screen-settling overview
        Screen-settling procedure
        Analyzing outbound data
        Waiting for OIA flags
        Changing customization settings
        Determining which strategy ZIETrans is using
        Contention resolution (TN3270E only)
          Contention resolution using z/OS Communications Server
          Contention resolution using other Communications Servers
          Performance impact of using contention resolution
          Determining contention resolution status
        Automatic refresh
        Transient screen handling
        Initial blank screen handling settings
        Related ZIETrans settings
        Tuning ZIETrans screen-settling
        References
          Contention resolution information
          Advanced Macro Guide
      Glossary
    Web Application Programmer's Guide
      Introduction
        Code examples
        Using the API documentation (Javadoc)
      Adding business logic
        Incorporating Java code from other applications
        Using global variables in business logic
        Business logic examples
          Example: Date conversion
          Example: Adding values that are contained in an indexed global variable
          Example: Reading a list of strings from a file into an indexed global variable
          Example: Calling an Integration Object
        Using custom screen recognition
          Example of custom screen recognition
          Custom screen recognition using global variables
        Accessing javax.servlet classes
      Creating custom components and widgets
        ZIETrans component tag and attributes
        Creating a custom host component
        Extending component classes
        Creating a custom HTML widget
          Extending widget classes
          Widgets and global rules
        Registering your component or widget
        ZIETrans Toolkit support for custom component and widget settings
      Programming with Integration Objects
        A common class for accessing Integration Object information
        Java class hierarchy of Integration Objects
        Integration Object methods
          Common methods
          Host Access Integration Object methods
          Database Access Integration Object methods
        Specifying Connection Overrides
        Integration Object chaining
        Applying XML style sheet processing to Integration Object output
          DTD of XML data that is returned by getHPubXMLProperties() method
            XML data using the getHPubXMLProperties() method
          DTD of XML data that is returned by getHPubXMLProperties (HPubConvertToTableFormat.xsl) method
            XML data with HPubConvertToTableFormat style sheet applied
      Developing Web services
        Creating traditional (WSDL-based) Web services
          Creating a Bottom-up Web service from Integration Objects
          Testing your Web service with Web Services Explorer
          Creating a Web service client
          Creating a Top-down Web service that includes Integration Objects
          Programming with Web Services Integration Objects
            Integration Object chaining with Web Services
            Special considerations with chaining Web Services
          Updating Web services
          Web services for JAX-WS runtime considerations and limitations
        Creating RESTful Web services
          Creating RESTful service JAX-RS resources
          Updating RESTful service JAX-RS resources
          Customizing RESTful service JAX-RS resource methods
          Handling content
            Content type examples
          Customizing the response header
          HTTP status codes
          JAX-RS RESTful services considerations and limitations
      Integration Objects - advanced topics
        Customizing Integration Object Java code
        Choosing Integration Object templates
          Choosing Integration Object templates for a bidirectional project
        Modifying Java coding templates
          Sample modified Integration Object template
            Extracting data from non-text planes
        Using Integration Objects in a WebSphere Java EE application
          Using an Integration Object in a Web container (custom servlet or JSP)
        Connection management API
          acquireExistingTransformationConnection
          releaseExistingTransformationConnection
      Creating plug-ins for Web Express Logon
        Creating custom plug-ins for Web Express Logon
          Web Express Logon plug-in interface
            com.ibm.eNetwork.security.sso.cms.CMInterface
            com.ibm.eNetwork.security.sso.CMRequest
            com.ibm.eNetwork.security.sso.CMResponse
          Writing a Network Security plug-in
          Writing a Credential Mapper plug-in
          Sample Web Express Logon plug-in
          Encrypting and decrypting plug-in parameter strings
          The DCAS API object
      Appendix A. ZIETrans Toolkit files
        Application file (.hap)
          <application> tag
          <connections> tag
          <connection> tag
          <eventPriority> tag
          <event> tag
          <classSettings> tag
          <class> tag
          <setting> tag
            com.ibm.hats.common.AppletSettings
            com.ibm.hats.common.ApplicationKeypadTag
            com.ibm.hats.common.ClientLocale
            com.ibm.hats.common.DBCSSettings
            com.ibm.hats.common.DefaultConnectionOverrides
            com.ibm.hats.common.DefaultGVOverrides
            com.ibm.hats.common.HostKeypadTag
            com.ibm.hats.common.KeyboardSupport
            com.ibm.hats.common.OIA
            com.ibm.hats.common.RuntimeSettings
            com.ibm.hats.transform
            com.ibm.hats.transform.components.name
            com.ibm.hats.transform.DefaultRendering
            com.ibm.hats.transform.widgets.name
          <textReplacement> tag
          <replace> tag
          <defaultRendering> tag
          <renderingSet> tag
          <renderingItem> tag
          <globalRules> tag
          <rule> tag
        Connection files (.hco)
          <hodconnection> tag
          <otherParameters> tag
          <classSettings> tag
          <class> tag
          <setting> tag
          <poolsettings> tag
          <webexpresslogon> tag
          <userconfig> tag
        Template and transformation files (.jsp)
        Screen combination files (.evnt)
          <combinations> tag
          <enddescription> tag
          <navigation> tag
          <screenUp> tag
          <screenDown> tag
          <keyPress> tag
          <setCursor> tag
          <sendText>
        Screen customization files (.evnt)
          <event> tag
          <actions> tag
          <apply> tag
          <insert> tag
          <extract> tag
          <set> tag
          <execute> tag
          <show> tag
          <forwardtoURL> tag
          <disconnect> tag
          <play> tag
          <perform> tag
          <pause> tag
          <sendkey> tag
          <globalRules> tag
          <rule> tag
          <associatedScreens> tag
          <screen> tag
          <description> tag
          <oia> tag
          <string> tag
          <nextEvents> tag
          <event> tag
          <remove> tag
        Macro files (.hma)
          <macro> tag
          <associatedConnections> tag
          <connection> tag
          <extracts> tag
          <extract> tag
          <prompts> tag
          <prompt> tag
          <HAScript> tag
        Screen capture files (.hsc)
        BMS Map files (.bms and .bmc)
        Image files (.gif, .jpg, or .png)
        Stylesheet files (.css)
        Spreadsheet files (.csv or .xls)
        Host simulation trace files (.hhs)
        ComponentWidget.xml
        Web Express Logon configuration file (ZIETranswelcfg.xml)
          <credentialmapper> tag
          <networksecurity> tag
          <cmplugins> tag
          <plugin> tag
          <param> tag
      Appendix B. Sample Web Express Logon plug-in
      Appendix C. Sample modified Integration Object template
      Glossary
    Messages Guide
      Messages
    Advanced Macro Guide
      Developing macros
        Introducing advanced macros
          Adapting Host On-Demand macros for use in ZIETrans
          Working with macros in ZIETrans
          Definitions of terms
          Samples
        Macro structure
          Macro script
            XML elements
            Conceptual view of a macro script
          The macro screen and its subcomponents
            Application screen
            Macro screen
            Conceptual view of a macro screen
        Data types, operators, and expressions
          Basic and advanced macro format
            Representation of strings and non-alphanumeric characters
              Basic macro format rules
              Advanced macro format rules
            Converting your macro to a different format
              Converting your basic format macro to the advanced format
              Converting your advanced format macro to the basic format
          Standard data types
            Boolean data
              Boolean values are not strings
            Integers
              Integer constants
            Doubles
            Strings
          Fields
          The value null
          Arithmetic operators and expressions
            Using arithmetic expressions
          String concatenation operator (+)
          Conditional and logical operators and expressions
          Automatic data type conversion
            Effect of context
            Conversion to boolean
            Conversion to integer
            Conversion to double
            Conversion to string
            Conversion errors
          Equivalents
          Significance of a negative value for a row or column
        How the macro runtime processes a macro screen
          Overview of macro runtime processing
            Scenario used as an example
            Stages in processing a macro screen
            Stage 1
            Overview of all 3 stages of the entire process
          Stage 1: Determining the next macro screen to be processed
            Step 1(a): Adding macro screen names to the list of valid next screens
              Valid next screens
              How the macro runtime selects the names of candidate macro screens
                First macro screen
                Subsequent macro screens
                Transient screens
            Step 1(b): Screen recognition
              Overview of evaluation
              Repeated screen evaluations
              Determining whether a macro screen matches the application screen
              Defining when to terminate recognition
                Timeout setting for screen recognition
                Recognition limit
            Step 1(c): Removing the names of candidate macro screens from the list of valid next screens
          Stage 2: Making the successful candidate the new current macro screen
          Stage 3: Performing the actions in the new current macro screen
            Inserting a delay after an action
          Repeating the processing cycle
          Terminating the macro
        Screen description
          Definition of terms
          Recorded descriptions
            Why the recorded descriptions work
            Recorded descriptors provide a framework
          Evaluation of descriptors
            Overview of the process
            Evaluation of individual descriptors
            Default combining method
              When to use the default combining method
              Invertmatch attribute
              Optional attribute
              Default combining rule
            The uselogic attribute
          The descriptors
            OIA descriptor (<oia> element)
            Number of Fields descriptor (<numfields> element)
            Number of Input Fields descriptor (<numinputfields> element)
            String descriptor (<string> element)
              Specifying the rectangular area
              How the macro runtime searches the rectangular area (Wrap attribute)
                Using an extracted string in a String descriptor
              Multiple String descriptors in the same <description> element
            Cursor descriptor (<cursor> element)
            Attribute descriptor (<attrib> element)
            Condition descriptor (<condition> element)
            Custom descriptor (<customreco> element)
          Variable update action (<varupdate> element)
            Processing a Variable update action in a description
            Variable update with the uselogic attribute
        Screen recognition
          Recognizing valid next screens
          Entry screens, exit screens, and transient screens
            Entry screens
              Macro with several entry screens
              Entry screen as a normal screen
            Exit screens
            Transient screens
              Example of handling of transient screen
          Timeout settings for screen recognition
            Screen recognition
            Timeout attribute on the <HAScript> element
            Timeout attribute on the <nextscreens> element
          Recognition limit
            Determining when the recognition limit is reached
            Action when the Recognition limit is reached
        Macro actions
          Actions by function
          How actions are performed
            The runtime context
            The macro screen context
            Specifying parameters for actions
          The actions
            Comm wait action (<commwait> element)
              How the action works
              Specify a communication status that is persistent
              Examples
            Conditional action (<if> element and <else> element)
              Conditional action not allowed within a Conditional action
              Example
            Extract action (<extract> element)
              Treatment of nulls and other characters that do not display
              Capturing a rectangular area of the host terminal
              Capturing a sequence of text from the host terminal
              Unwrap attribute
                When unwrap is true and continuous is false
                When unwrap is true and continuous is true
            Input action (<input> element)
              Location at which typing begins
              Input errors
              Translate host action keys (xlatehostkeys attribute)
              Move cursor to end of input (movecursor attribute)
              Encrypted attribute
                Automatic encryption during macro recording
                Using the Encrypt string (VME) or Password (AME) check box
                Using the source view
                Encrypting a variable name
            Mouse click action (<mouseclick> element)
            Pause action (<pause> element)
            Perform action (<perform> element)
              Examples
            PlayMacro action (<playmacro> element)
              Adding a PlayMacro action
              Using target macros with prompts
              Transferring variables
                Requirements for transferring variables
                Restriction
                Additional information
                When the target macro needs to import a type
            Prompt action (<prompt> element)
              The promptall attributes
            SQLQuery action (<sqlquery> element)
            Trace action (<trace> element)
              Example
            Variable update action (<varupdate> element)
              Variable update action with a field variable
                Reading part of a field
        Timing issues
          Macro timing and delay characteristics
            What each element and attribute is for
            How the ZIETrans macro processing engine uses these timing elements and attributes
            What happens after a screen's actions have completed
            High-level, textual flow of macro engine processing
          Pause after an action
            Speed of processing actions
            The pausetime attribute
            The pause attribute
            Adding a pause after a particular action
          Screen completion
            Recognizing the next macro screen too soon
              The cause: Unenhanced TN3270 protocol
              Solutions to early macro screen recognition
                Add more descriptors
                Insert a delay after the input action
                Use the contention-resolution feature of TN3270E
            Attributes that deal with screen completion
              ignorepauseforenhancedtn=true/false
              ignorepauseoverrideforenhancedtn=true/false
              delayifnotenhancedtn=(milliseconds)
        Variables and imported Java classes
          ZIETrans variables
            Global variables
            Macro variables
          Introduction to macro variables and imported types
            Advanced macro format required
            Scope of variables
            Creating a variable
            Creating an imported type for a Java class
          Common issues
            Deploying Java libraries or classes
            Variable names and type names
            Transferring variables from one macro to another
            Field variables
          Using variables
            Using variables belonging to a standard type
              Using the value that the variable holds
              Writing a value into a variable belonging to a standard type
                Restrictions
                Writing a Java object into a variable of standard type
            Using variables belonging to an imported type
              Using the value that the variable holds
              Restrictions
              Writing into the variable belonging to an imported type
            Comparing variables of the same imported type
          Calling Java methods
            Where method calls can be used
            Syntax of a method call
            How the macro runtime searches for a called method
          The Macro Utility Libraries (HML libraries)
            Invoking a method belonging to an HML library
            Variable names beginning with HML are reserved
            $HMLFormatUtil$
              Converting numbers to and from the format of the current locale
              Method details
                numberToString()
                stringToNumber()
            $HMLPSUtil$
              Presentation space
              Method details
                convertPosToCol()
                convertPosToRow()
                enableRoundTrip()
                getCursorCol()
                getCursorPos()
                getCursorRow()
                getSize()
                getSizeCols()
                getSizeRows()
                getString()
                searchString()
            $HMLSessionUtil$
              Method details
                getHost()
                getLabel()
                getName()
            $HMLSQLUtil$
              Format of the stored data
              Method details
                getColumnSize()
                getDataByIndex()
                getDataByName()
                getRowSize()
            FormatNumberToString() and FormatStringToNumber()
        Visual Macro Editor
          Creating a new macro
          Using the editor
            Design tab
              Macro menu
              Screen menu
              Action menu
              Next screen connection menu
            Palette view
            Integrated terminal
            Source tab
          Working with macros
            Editing macro properties
              General tab
              Variables and Types tab
            Playing the macro
          Working with screens
            Editing macro screen properties
              General tab
              Screen Recognition tab
              Actions tab
            Adding macro screens
              Adding a screen by dragging a screen capture
              Adding a screen from the integrated terminal
              Adding a screen from the palette
            Associating a macro screen with a screen capture
            Screen preview
            Default screen recognition criteria
            Cut, delete, copy, and paste screens
          Working with actions
            Adding and editing actions
              Adding and editing actions from the macro screen properties
              Adding an action to a screen from the palette
            Hiding and showing actions
            Actions
            Custom action
            Evaluate (If) action
            Extract action
            Extract All action
            Input action
            Pause action
            Perform action
            Play macro action
            Prompt action
            Prompt All action
            Set cursor position action
            Trace action
              Trace specification
            Update macro variable action
          Working with next screen connections
            Adding a next screen connection from the palette
            Reordering and changing next screen connections
          Working with VME preferences
        Advanced Macro Editor
          Using the editor
            Macro tab
            Screens tab
              Description tab
                Creating a new descriptor
                Field Counts and OIA descriptor
                How three separate and independent descriptors are presented as one
                Wait for OIA to Become Uninhibited descriptor
                Counting fields in the host terminal during macro development
                Treatment during screen recognition
                The '*' string in a new String descriptor
              Actions tab
                Creating a new action
            Links tab
            Variables tab
              Creating a new variable
              Creating an imported type for a Java class
          Working with actions
            Comm wait action
              Communication states
            Conditional action
              Specifying the condition
              Condition is True (<if> element)
              Condition is False (<else> element)
            Extract action
              Capturing text
                Set the Continuous Extract option
                Specify the area of the host terminal
                Specify an extraction name
                Specify TEXT_PLANE as the data plane
                Specify the variable in which you want the text to be stored
            Input action
              Input string
            Mouse click action
              Specifying row and column
            Pause action
            Perform action
              Invoking the method
            Playmacro action
              Target macro file name and starting screen
            Prompt action
              Displaying the prompt window
                Parts of the prompt window
                Default Response
                Password Response
                Require Response
              Processing the contents of the input field
                Response Length
                Action keys and Translate Host Action Keys
              Handling the input sequence in the host terminal
              Assigning the input sequence to a variable
            SQLQuery action
              The statement and results section
              Using the SQL Wizard
              Using the fields in the statement section
                Database URL
                Driver Identifier and Driver Class
                User ID and Password
                Statement
              Using the result section
                Storing the data into a macro variable ($HMLSQLUtil$)
              Using the SQLQuery action with bidirectional languages
            Trace action
              Trace specification
            Variable update action
      The Host On-Demand macro language
        Macro language features
          Syntax and editing
            XML syntax in the Host On-Demand macro language
            Source view editing
          Hierarchy of the elements
          Inserting comments into a macro script
            Comment errors
            Examples of comments
          Debugging macro scripts with the <trace> element
        Macro language elements
          Specifying the attributes
            XML requirements
            Advanced format in attribute values
            Typed data
          <actions> element
            Attributes
            XML samples
          <attrib> element
            Attributes
            XML samples
          <comment> element
            Attributes
            XML samples
            Alternate method for inserting comments
          <commwait> element
            Attributes
            XML samples
          <condition> element
            Attributes
            XML samples
          <create> element
            Attributes
            XML samples
          <cursor> element
            Attributes
            XML samples
          <custom> element
            Attributes
            XML samples
          <customreco> element
            Attributes
            XML samples
          <description> element
            Attributes
            XML samples
          <else> element
            Attributes
            XML samples
          <extract> element
            Attributes
            XML samples
          <HAScript> element
            Attributes
            XML samples
          <if> element
            Attributes
            XML samples
          <import> element
            Attributes
            XML samples
          <input> element
            Attributes
            XML samples
          <mouseclick> element
            Attributes
            XML samples
          <nextscreen> element
            Attributes
            XML samples
          <nextscreens> element
            Attributes
            XML samples
          <numfields> element
            Attributes
            XML samples
          <numinputfields> element
            Attributes
            XML samples
          <oia> element
            Attributes
            XML samples
          <pause> element
            Attributes
            XML samples
          <perform> element
            Attributes
            XML samples
          <playmacro> element
            Attributes
            XML samples
          <prompt> element
            Attributes
            XML samples
          <recolimit> element
            Attributes
            XML samples
          <screen> element
            Attributes
            XML samples
          <sqlquery> element
            Attributes
            XML samples
          <string> element
            Attributes
            XML samples
          <trace> element
            Attributes
            XML samples
          <type> element
            Attributes
            XML samples
          <vars> element
            Attributes
            XML samples
          <varupdate> element
            Attributes
            XML samples
      Appendix A. Additional information
        Default rule for combining multiple descriptors in one macro screen
        Mnemonic keywords for the Input action
    Troubleshooting
      Troubleshooting and support
      Troubleshooting overview
        Recording the symptoms of the problem
        Recreating the problem
        Eliminating possible causes
      Searching for information
        Search the HCL Infocenter
        Search the Internet
      Getting fixes
    ZIETrans API Reference
      Web
  Release Notes
    README
      Version 1.0
  Product Documentation
    Getting Started
      Introducing Z and I Emulator for Transformation
        What is ZIETrans?
        A ZIETrans 3270 example
        A ZIETrans 5250 example
        Roles and skills
          Casual Web developer
          Advanced Web developer
          User
          ZIETrans administrator
          WebSphere administrator
          Independent software vendors
        Where can I find information about ZIETrans?
      Installing ZIETrans
        Prerequisites
          HCL ZIETrans
          Other prerequisites
        Installing ZIETrans Toolkit
        Updating the ZIETrans Toolkit installation
        Modifying the ZIETrans Toolkit installation
        Adding the ZIETrans installation repository to IBM Installation Manager
        Uninstalling ZIETrans Toolkit
        Using silent install and uninstall
        Log files
      Flexera Licensing integration for ZIETrans Projects
        Secure License Server Configuration
        Enable Runtime Licensing in ZIETrans
        License terms and troubleshooting
        How does Licensing work in ZIETrans?
      Creating a basic ZIETrans project
        Introducing the Rational SDP environment
        Starting ZIETrans Toolkit and perspective
        Introducing the ZIETrans Welcome page
        Starting ZIETrans functions
          Using ZIETrans icons
          ZIETrans tips
        Developing a ZIETrans project
          Creating a ZIETrans project
          Testing your project
            Testing modes for Web projects
            Testing your Web project
            While testing your project
      Customizing your ZIETrans project
        Understanding how a ZIETrans application works
          Understanding ZIETrans resources
        Using the host terminal screen as you work
          Host screen preview
          Working with screen captures
        Updating your project's template
        Editing default rendering
        Creating global rules
        Working with screen events
          Creating a new screen customization
          Creating a new screen combination
          Ordering and enabling your screen events
        Working with transformations
          Understanding host components and widgets
          How ZIETrans uses transformations
          Creating a new transformation
            Editing a transformation
        Performing other customization tasks
          Auto advance
          Displaying function keys (PF keys)
          Replacing text strings from the host screen
          Using macros
          Using Host Publisher artifacts
          Creating background connections
          Defining global variables
          Applying business logic
          Using keyboard support
          Specifying a workstation ID
          Using print support
          Subfile support
          Using Extended Field Attributes
          Enabling Enhanced Non-Programmable Terminal User Interface (ENPTUI)
          5250 HTML DDS keyword support (Web-only)
      Preparing your ZIETrans project for use as an application
        Deploying ZIETrans Web applications
          Exporting your project as an application
          Installing your application in a runtime environment
      Glossary
    User's and Administrator's Guide
      Using Z and I Emulator for Transformation (ZIETrans)
        Understanding ZIETrans key concepts and objects
        Understanding ZIETrans application processing
        Understanding ZIETrans application development
        How do I know what version of ZIETrans I have?
        Gathering problem determination information
        Where can I find information about ZIETrans?
      Developing and deploying ZIETrans Web applications
        Organizing ZIETrans Web applications
          Moving ZIETrans Web projects to a different .ear file
        Backing up your ZIETrans projects
        Exporting and importing ZIETrans Web projects
          Exporting a Web project
            Archive file
          Importing a Web project
        Deploying ZIETrans Web applications
          Enabling the ZIETrans runtime
          Exporting your project as a Java EE application
          Installing your application in a runtime environment
          Changes necessary in the runtime environment
            Configuring class loader policy
            Configuring ZIETrans applications in a clustered environment
            Configuring ZIETrans applications to use a proxy server
        Developing ZIETrans applications for the Apache Geronimo Server
          Installing and configuring for Geronimo servers
          Considerations and limitations for Geronimo servers
        Developing ZIETrans applications for Oracle WebLogic Server
          Installing and configuring for WebLogic servers
          Considerations and limitations for WebLogic servers
        Developing ZIETrans applications for IBM Bluemix Server
          Configuring Rational SDP for IBM Bluemix server
          Considerations and limitations for IBM Bluemix Server
        Developing ZIETrans applications for Web Sphere Application Server Liberty Porfile
          Considerations and limitations for WebSphere Application Server Liberty Profile
        Developing ZIETrans applications for mobile devices
          Considerations and limitations for mobile devices
          Considerations and limitations for iPad devices
          Considerations and limitations for Android devices
      Modifying a ZIETrans project
        Overview
        Connections
        Template
        Rendering
          Default rendering
            Multiple rendering set example
            Advanced rendering
              Alternate rendering
              HTML tables
            How to make default rendering customizations available in new ZIETrans projects
          Global rules
          Text replacement
          Components and widgets
            Components
            Widgets
          Toolbar (RCP-only)
          Application keypad
          Host keypad
          Operator information area
          DBCS
        Events
          Screen event priority
          Application events
        Other
          Keyboard support
          Client locale
          Connection parameter overrides
            Selecting the type of connection to use when overriding parameters
            The disconnectOnClose parameter
          Asynchronous Update (RCP-only)
          Automatic Disconnect and Refresh (Web-only)
            Using the client pull (AJAX) method
              Client pull (AJAX) settings
            Using the server push (applet) method
              Server push (applet) settings
          Global variable overrides
          Client settings
          Macro Content Assistance
        Source
        Using ZIETrans preferences
        Use of other Rational SDP preferences
      Managing connections
        Creating a connection
        Connection editor
          Overview
          Basic
          Advanced
          Printing
            Print settings for 3270E connections
            Print settings for 5250 and 5250W connections
          Screen Handling
          Security
          Pooling
          Macros
          User List
            Clustering and user lists
          Source
      Working with screen events
        Create a Screen Customization wizard
        Create a Screen Combination wizard
        Editing screen events
          Overview
          Screen Recognition Criteria or Begin Screen
            Associated screen capture
            Fields criteria
            Cursor position criteria
            Optional versus non-optional screen recognition criteria
            Inverted match of screen recognition criteria
            Additional criteria
              String criterion
              Global variable criterion
              Color criterion
              Compare region to value criterion
              Compare region to region criterion
              Condition criterion
              Custom criterion
          Rendering (screen combination only)
          Navigation (screen combination only)
          End Screen (screen combination only)
            Select ending criteria
            Number of iterations
            Associated screen capture
            Screen descriptor settings
          Actions
            Apply transformation action
            Execute business logic action
            Extract global variable action
            Insert data action
            Set global variable action
            Remove global variable action
            Send global variable action
              Common considerations:
            Show URL or SWT composite action (RCP-only)
            Show URL action (Web-only)
            Forward to URL action (Web-only)
            Play macro
            Perform macro transaction
            Send key
            Disconnect
            Pause
          Global Rules
          Text Replacement
          Next Screen
          Source
        Inhibited screens
          Recognition criteria
          Automated handling of inhibited screens
          Handling multiple inhibited screens
        Importing BMS map sets
      Working with transformations
        Create a Transformation wizard
        Editing transformations
          Editing transformations for Web projects
            Design
            Source
            Split
            Preview
        Transformation wizards
          Insert Host Component
          Edit Host Component (Web-only)
          Insert Default Rendering
          Edit Default Rendering (Web-only)
          Insert Tabbed Folder (Web-only)
          Insert Macro Key
          Insert Global Variable
          Insert Operator Information Area (Web-only)
          Insert Host Keypad
            Default Keypad (Web-only)
            Custom Keypad (Web-only)
             Individual Key
          Insert Application Keypad
            Default Keypad (Web-only)
            Custom Keypad (Web-only)
            Individual Key
          Insert All Host Components (Web-only)
          Insert Stored Screen (Web-only)
        Previewing transformations
        Host keypad
      Component and widget descriptions and settings
        Component and widget settings
        Host component settings
          Command line
          Dialog
          ENPTUI
             Scrollbar field (ENPTUI)
             Selection field (ENPTUI)
          Field
          Function key
          HTML DDS keyword (Web-only)
          Input field
          Input field with hints
          Item selection
          Light pen (attention)
          Light pen (selection)
          Selection list
          Subfile
            Action
            Header
            Data
            Marker
          Table
          Table (field)
          Table (visual)
          Text
          URL
        Widget settings
          Button
          Button table
          Calendar (Web-only)
          Check box
          Combo (RCP-only)
          Dialog
          Drop-down (data entry)
          Drop-down (selection)
          Field
          Graph (horizontal bar, line, vertical bar)
          Label
          Link
          Link (item selection)
          List
          Popup
          Radio button (data entry)
          Radio button (item selection)
          Radio button (selection)
          Scrollbar (ENPTUI)
          Subfile (check box)
          Subfile (drop-down)
          Subfile (popup)
          Table
          Text input
          Toolbar (RCP-only)
        Component and widget mapping
      Using templates
        Template examples
        Create a Template wizard
        Editing templates
          Editing templates for Web projects
            Design
              Using style sheets
                Modifying style sheets
                Determining which styles to edit
              ZIETrans style sheets
              Design tab considerations and limitations
            Source
            Split
            Preview
            Making customized templates, style sheets, and images available
        Application keypad
      Macros and host terminal
        Macro Editor
          Overview
            Open Host Terminal
              Host Terminal
                Macro related icons
              Host Screen Preview
            Advanced Editor
          Prompts and Extracts
          Source
        Working with macro errors
        Importing a macro
        Exporting a macro
        Macro hints and tips
          Preventing an infinite loop
          Handling transient screens
      Interacting with global variables
        Renaming global variables
        Differences between global variables and macro variables
          Global variables
          Macro variables
      Using Integration Objects
        Creating an Integration Object
        Integration Object chaining
          Deciding when to use Integration Object chaining
          Using Integration Object chaining
          Debugging applications that use Integration Object chaining
        Building Web pages from an Integration Object
          Create Model 1 Web pages
          Create Struts Web pages
          Create JSF Web pages
        BasicIOErrorPage.jsp and AdvancedIOErrorPage.jsp
        Working with Integration Objects on JSPs
          Insert Integration Object Properties
            Input
            Output
          Insert Forward to ZIETrans Application
      Combining screens
        Combining contiguous output data
        Combining noncontiguous output data
        Combining output from multiple applications
        Combining input for multiple screens
      Enabling print support
        Configuring the host print session on 3270 hosts
        Defining print support for your project
          For 3270E connections
            Using the Host On-Demand PDT compiler
          For 5250 connections
        Providing documentation for users
      Enabling keyboard support
        Defining keyboard support
        Changing the appearance of the keypads
        Providing documentation for users
          Special 5250 field key support
            Default field keypress combinations
            Quick Field Exit
            Quick Field Minus
            Alternate way to input negative numbers
            Field Exit Emulation
        Remapping the keyboard in a ZIETrans application
          Concepts to understand before remapping ZIETrans keys
            Mnemonic keywords
            Determining keycode values
          Remapping keys for ZIETrans Web applications
            Example
          Adding additional keypad buttons to a transformation
      Using host simulation
        Host simulation wizard
        Host simulation editor
          Overview tab
            General Information section
            Playback Settings section
          Source tab
        Recording in the runtime environment
        Playback options
        Importing and exporting trace files
      Using ZIETrans administrative console
        ZIETrans administrative console and WebSphere security
        ZIETrans administrative console roles
        Starting ZIETrans administrative console
          Starting the administrative console while in ZIETrans Toolkit
        Using the functions in ZIETrans administrative console
          Selecting management scope
          Managing licenses
          Monitoring connections
          Monitoring connection pools
          Monitoring pool definitions
          Monitoring user lists and user list members
          Administering problem determination components
            Log and trace file names
            View Log
            Set Log Options
            Set Trace Options
        Display terminal functions
          Using display terminal for testing and debugging
      Security and Web Express Logon
        Enabling SSL security
        Enabling SSH security
        Using Web Express Logon (WEL)
          Overview
          Architecture
          Planning for implementation
          Implementation
          How to create a WEL logon macro
          Network Security plug-in
          Credential Mapper plug-ins
            Credential Mapper selection
          Initialization parameters
            DCAS parameters for DCAS/RACF/JDBC Credential Mapper plug-in
            DCAS parameters for Certificate-based DCAS/RACF Credential Mapper plug-in
            Vault parameters for JDBC Vault Credential Mapper plug-in
            Vault parameters for the WebSphere Portal Credential Vault Credential mapper
          Create SSL keystore file (DCAS only)
        Using Kerberos service tickets
        Java 2 security
          Policy file
        Using IBM Certificate Management for ZIETrans applications
          Creating a key database file
          Requesting and storing certificates from Certificate Authorities
            Creating the certificate request
            Sending the certificate request
            Storing the certificate
          Using a self-signed certificate
          Exchanging certificates
          Certificate Management tool considerations
            DOS window
            Run as administrator
            Using IBM CMS keystore files
      Language support
        Language codes
        Code pages
        Encoding settings
        5250 Unicode support
        Using accented characters for code page 937
        Using code page 1388 (GB18030)
        Host code mapping for code pages 1390 and 1399
          JIS2004 support
            JIS2004 support considerations and limitations
            JIS2004 support for PDT printing and Print-to-File for 3270E sessions
            Disabling JIS2004 support for code pages 1390 and 1399
        Remapping keyboard and display characters
          Priority of character replacement
      Double-byte character set support
        DBCS and SBCS field support
        Data type checking
        Field length checking
        Copy-and-paste prevention
        Input Method Editor (IME)
        AutoIME switching
        Shift Out/Shift In considerations
        Other considerations
          Project theme settings
            DBCS eliminate maximum length
          Project settings editor
            Rendering tab
              DBCS
            Other tab
              Enable automatic field advance
              Overwrite mode (initial)
              Select all text on focus
          Screen event editor
            Screen recognition criteria / Begin screen
          Host components
            Selection list
            Subfile
            Table
          Widgets
            SBCS eliminate maximum length
          Macro support
            Recording a macro
            Exporting a macro
          Creating an Integration Object
          Working with mobile device applications
          Remapping keyboard and display characters
          Working with user-defined characters
            Display support
            Print support
            Printing UDCs in Adobe PDF mode
            Printing UDCs in PDT mode
            Limitations
      Appendix A. Runtime properties files
        Tracing options
        Host On-Demand tracing
        Host simulation tracing
      Appendix B. ZIETrans screen-settling reference
        Screen-settling overview
        Screen-settling procedure
        Analyzing outbound data
        Waiting for OIA flags
        Changing customization settings
        Determining which strategy ZIETrans is using
        Contention resolution (TN3270E only)
          Contention resolution using z/OS Communications Server
          Contention resolution using other Communications Servers
          Performance impact of using contention resolution
          Determining contention resolution status
        Automatic refresh
        Transient screen handling
        Initial blank screen handling settings
        Related ZIETrans settings
        Tuning ZIETrans screen-settling
        References
          Contention resolution information
          Advanced Macro Guide
      Glossary
    Web Application Programmer's Guide
      Introduction
        Code examples
        Using the API documentation (Javadoc)
      Adding business logic
        Incorporating Java code from other applications
        Using global variables in business logic
        Business logic examples
          Example: Date conversion
          Example: Adding values that are contained in an indexed global variable
          Example: Reading a list of strings from a file into an indexed global variable
          Example: Calling an Integration Object
        Using custom screen recognition
          Example of custom screen recognition
          Custom screen recognition using global variables
        Accessing javax.servlet classes
      Creating custom components and widgets
        ZIETrans component tag and attributes
        Creating a custom host component
        Extending component classes
        Creating a custom HTML widget
          Extending widget classes
          Widgets and global rules
        Registering your component or widget
        ZIETrans Toolkit support for custom component and widget settings
      Programming with Integration Objects
        A common class for accessing Integration Object information
        Java class hierarchy of Integration Objects
        Integration Object methods
          Common methods
          Host Access Integration Object methods
          Database Access Integration Object methods
        Specifying Connection Overrides
        Integration Object chaining
        Applying XML style sheet processing to Integration Object output
          DTD of XML data that is returned by getHPubXMLProperties() method
            XML data using the getHPubXMLProperties() method
          DTD of XML data that is returned by getHPubXMLProperties (HPubConvertToTableFormat.xsl) method
            XML data with HPubConvertToTableFormat style sheet applied
      Developing Web services
        Creating traditional (WSDL-based) Web services
          Creating a Bottom-up Web service from Integration Objects
          Testing your Web service with Web Services Explorer
          Creating a Web service client
          Creating a Top-down Web service that includes Integration Objects
          Programming with Web Services Integration Objects
            Integration Object chaining with Web Services
            Special considerations with chaining Web Services
          Updating Web services
          Web services for JAX-WS runtime considerations and limitations
        Creating RESTful Web services
          Creating RESTful service JAX-RS resources
          Updating RESTful service JAX-RS resources
          Customizing RESTful service JAX-RS resource methods
          Handling content
            Content type examples
          Customizing the response header
          HTTP status codes
          JAX-RS RESTful services considerations and limitations
      Integration Objects - advanced topics
        Customizing Integration Object Java code
        Choosing Integration Object templates
          Choosing Integration Object templates for a bidirectional project
        Modifying Java coding templates
          Sample modified Integration Object template
            Extracting data from non-text planes
        Using Integration Objects in a WebSphere Java EE application
          Using an Integration Object in a Web container (custom servlet or JSP)
        Connection management API
          acquireExistingTransformationConnection
          releaseExistingTransformationConnection
      Creating plug-ins for Web Express Logon
        Creating custom plug-ins for Web Express Logon
          Web Express Logon plug-in interface
            com.ibm.eNetwork.security.sso.cms.CMInterface
            com.ibm.eNetwork.security.sso.CMRequest
            com.ibm.eNetwork.security.sso.CMResponse
          Writing a Network Security plug-in
          Writing a Credential Mapper plug-in
          Sample Web Express Logon plug-in
          Encrypting and decrypting plug-in parameter strings
          The DCAS API object
      Appendix A. ZIETrans Toolkit files
        Application file (.hap)
          <application> tag
          <connections> tag
          <connection> tag
          <eventPriority> tag
          <event> tag
          <classSettings> tag
          <class> tag
          <setting> tag
            com.ibm.hats.common.AppletSettings
            com.ibm.hats.common.ApplicationKeypadTag
            com.ibm.hats.common.ClientLocale
            com.ibm.hats.common.DBCSSettings
            com.ibm.hats.common.DefaultConnectionOverrides
            com.ibm.hats.common.DefaultGVOverrides
            com.ibm.hats.common.HostKeypadTag
            com.ibm.hats.common.KeyboardSupport
            com.ibm.hats.common.OIA
            com.ibm.hats.common.RuntimeSettings
            com.ibm.hats.transform
            com.ibm.hats.transform.components.name
            com.ibm.hats.transform.DefaultRendering
            com.ibm.hats.transform.widgets.name
          <textReplacement> tag
          <replace> tag
          <defaultRendering> tag
          <renderingSet> tag
          <renderingItem> tag
          <globalRules> tag
          <rule> tag
        Connection files (.hco)
          <hodconnection> tag
          <otherParameters> tag
          <classSettings> tag
          <class> tag
          <setting> tag
          <poolsettings> tag
          <webexpresslogon> tag
          <userconfig> tag
        Template and transformation files (.jsp)
        Screen combination files (.evnt)
          <combinations> tag
          <enddescription> tag
          <navigation> tag
          <screenUp> tag
          <screenDown> tag
          <keyPress> tag
          <setCursor> tag
          <sendText>
        Screen customization files (.evnt)
          <event> tag
          <actions> tag
          <apply> tag
          <insert> tag
          <extract> tag
          <set> tag
          <execute> tag
          <show> tag
          <forwardtoURL> tag
          <disconnect> tag
          <play> tag
          <perform> tag
          <pause> tag
          <sendkey> tag
          <globalRules> tag
          <rule> tag
          <associatedScreens> tag
          <screen> tag
          <description> tag
          <oia> tag
          <string> tag
          <nextEvents> tag
          <event> tag
          <remove> tag
        Macro files (.hma)
          <macro> tag
          <associatedConnections> tag
          <connection> tag
          <extracts> tag
          <extract> tag
          <prompts> tag
          <prompt> tag
          <HAScript> tag
        Screen capture files (.hsc)
        BMS Map files (.bms and .bmc)
        Image files (.gif, .jpg, or .png)
        Stylesheet files (.css)
        Spreadsheet files (.csv or .xls)
        Host simulation trace files (.hhs)
        ComponentWidget.xml
        Web Express Logon configuration file (ZIETranswelcfg.xml)
          <credentialmapper> tag
          <networksecurity> tag
          <cmplugins> tag
          <plugin> tag
          <param> tag
      Appendix B. Sample Web Express Logon plug-in
      Appendix C. Sample modified Integration Object template
      Glossary
    Messages Guide
      Messages
    Advanced Macro Guide
      Developing macros
        Introducing advanced macros
          Adapting Host On-Demand macros for use in ZIETrans
          Working with macros in ZIETrans
          Definitions of terms
          Samples
        Macro structure
          Macro script
            XML elements
            Conceptual view of a macro script
          The macro screen and its subcomponents
            Application screen
            Macro screen
            Conceptual view of a macro screen
        Data types, operators, and expressions
          Basic and advanced macro format
            Representation of strings and non-alphanumeric characters
              Basic macro format rules
              Advanced macro format rules
            Converting your macro to a different format
              Converting your basic format macro to the advanced format
              Converting your advanced format macro to the basic format
          Standard data types
            Boolean data
              Boolean values are not strings
            Integers
              Integer constants
            Doubles
            Strings
          Fields
          The value null
          Arithmetic operators and expressions
            Using arithmetic expressions
          String concatenation operator (+)
          Conditional and logical operators and expressions
          Automatic data type conversion
            Effect of context
            Conversion to boolean
            Conversion to integer
            Conversion to double
            Conversion to string
            Conversion errors
          Equivalents
          Significance of a negative value for a row or column
        How the macro runtime processes a macro screen
          Overview of macro runtime processing
            Scenario used as an example
            Stages in processing a macro screen
            Stage 1
            Overview of all 3 stages of the entire process
          Stage 1: Determining the next macro screen to be processed
            Step 1(a): Adding macro screen names to the list of valid next screens
              Valid next screens
              How the macro runtime selects the names of candidate macro screens
                First macro screen
                Subsequent macro screens
                Transient screens
            Step 1(b): Screen recognition
              Overview of evaluation
              Repeated screen evaluations
              Determining whether a macro screen matches the application screen
              Defining when to terminate recognition
                Timeout setting for screen recognition
                Recognition limit
            Step 1(c): Removing the names of candidate macro screens from the list of valid next screens
          Stage 2: Making the successful candidate the new current macro screen
          Stage 3: Performing the actions in the new current macro screen
            Inserting a delay after an action
          Repeating the processing cycle
          Terminating the macro
        Screen description
          Definition of terms
          Recorded descriptions
            Why the recorded descriptions work
            Recorded descriptors provide a framework
          Evaluation of descriptors
            Overview of the process
            Evaluation of individual descriptors
            Default combining method
              When to use the default combining method
              Invertmatch attribute
              Optional attribute
              Default combining rule
            The uselogic attribute
          The descriptors
            OIA descriptor (<oia> element)
            Number of Fields descriptor (<numfields> element)
            Number of Input Fields descriptor (<numinputfields> element)
            String descriptor (<string> element)
              Specifying the rectangular area
              How the macro runtime searches the rectangular area (Wrap attribute)
                Using an extracted string in a String descriptor
              Multiple String descriptors in the same <description> element
            Cursor descriptor (<cursor> element)
            Attribute descriptor (<attrib> element)
            Condition descriptor (<condition> element)
            Custom descriptor (<customreco> element)
          Variable update action (<varupdate> element)
            Processing a Variable update action in a description
            Variable update with the uselogic attribute
        Screen recognition
          Recognizing valid next screens
          Entry screens, exit screens, and transient screens
            Entry screens
              Macro with several entry screens
              Entry screen as a normal screen
            Exit screens
            Transient screens
              Example of handling of transient screen
          Timeout settings for screen recognition
            Screen recognition
            Timeout attribute on the <HAScript> element
            Timeout attribute on the <nextscreens> element
          Recognition limit
            Determining when the recognition limit is reached
            Action when the Recognition limit is reached
        Macro actions
          Actions by function
          How actions are performed
            The runtime context
            The macro screen context
            Specifying parameters for actions
          The actions
            Comm wait action (<commwait> element)
              How the action works
              Specify a communication status that is persistent
              Examples
            Conditional action (<if> element and <else> element)
              Conditional action not allowed within a Conditional action
              Example
            Extract action (<extract> element)
              Treatment of nulls and other characters that do not display
              Capturing a rectangular area of the host terminal
              Capturing a sequence of text from the host terminal
              Unwrap attribute
                When unwrap is true and continuous is false
                When unwrap is true and continuous is true
            Input action (<input> element)
              Location at which typing begins
              Input errors
              Translate host action keys (xlatehostkeys attribute)
              Move cursor to end of input (movecursor attribute)
              Encrypted attribute
                Automatic encryption during macro recording
                Using the Encrypt string (VME) or Password (AME) check box
                Using the source view
                Encrypting a variable name
            Mouse click action (<mouseclick> element)
            Pause action (<pause> element)
            Perform action (<perform> element)
              Examples
            PlayMacro action (<playmacro> element)
              Adding a PlayMacro action
              Using target macros with prompts
              Transferring variables
                Requirements for transferring variables
                Restriction
                Additional information
                When the target macro needs to import a type
            Prompt action (<prompt> element)
              The promptall attributes
            SQLQuery action (<sqlquery> element)
            Trace action (<trace> element)
              Example
            Variable update action (<varupdate> element)
              Variable update action with a field variable
                Reading part of a field
        Timing issues
          Macro timing and delay characteristics
            What each element and attribute is for
            How the ZIETrans macro processing engine uses these timing elements and attributes
            What happens after a screen's actions have completed
            High-level, textual flow of macro engine processing
          Pause after an action
            Speed of processing actions
            The pausetime attribute
            The pause attribute
            Adding a pause after a particular action
          Screen completion
            Recognizing the next macro screen too soon
              The cause: Unenhanced TN3270 protocol
              Solutions to early macro screen recognition
                Add more descriptors
                Insert a delay after the input action
                Use the contention-resolution feature of TN3270E
            Attributes that deal with screen completion
              ignorepauseforenhancedtn=true/false
              ignorepauseoverrideforenhancedtn=true/false
              delayifnotenhancedtn=(milliseconds)
        Variables and imported Java classes
          ZIETrans variables
            Global variables
            Macro variables
          Introduction to macro variables and imported types
            Advanced macro format required
            Scope of variables
            Creating a variable
            Creating an imported type for a Java class
          Common issues
            Deploying Java libraries or classes
            Variable names and type names
            Transferring variables from one macro to another
            Field variables
          Using variables
            Using variables belonging to a standard type
              Using the value that the variable holds
              Writing a value into a variable belonging to a standard type
                Restrictions
                Writing a Java object into a variable of standard type
            Using variables belonging to an imported type
              Using the value that the variable holds
              Restrictions
              Writing into the variable belonging to an imported type
            Comparing variables of the same imported type
          Calling Java methods
            Where method calls can be used
            Syntax of a method call
            How the macro runtime searches for a called method
          The Macro Utility Libraries (HML libraries)
            Invoking a method belonging to an HML library
            Variable names beginning with HML are reserved
            $HMLFormatUtil$
              Converting numbers to and from the format of the current locale
              Method details
                numberToString()
                stringToNumber()
            $HMLPSUtil$
              Presentation space
              Method details
                convertPosToCol()
                convertPosToRow()
                enableRoundTrip()
                getCursorCol()
                getCursorPos()
                getCursorRow()
                getSize()
                getSizeCols()
                getSizeRows()
                getString()
                searchString()
            $HMLSessionUtil$
              Method details
                getHost()
                getLabel()
                getName()
            $HMLSQLUtil$
              Format of the stored data
              Method details
                getColumnSize()
                getDataByIndex()
                getDataByName()
                getRowSize()
            FormatNumberToString() and FormatStringToNumber()
        Visual Macro Editor
          Creating a new macro
          Using the editor
            Design tab
              Macro menu
              Screen menu
              Action menu
              Next screen connection menu
            Palette view
            Integrated terminal
            Source tab
          Working with macros
            Editing macro properties
              General tab
              Variables and Types tab
            Playing the macro
          Working with screens
            Editing macro screen properties
              General tab
              Screen Recognition tab
              Actions tab
            Adding macro screens
              Adding a screen by dragging a screen capture
              Adding a screen from the integrated terminal
              Adding a screen from the palette
            Associating a macro screen with a screen capture
            Screen preview
            Default screen recognition criteria
            Cut, delete, copy, and paste screens
          Working with actions
            Adding and editing actions
              Adding and editing actions from the macro screen properties
              Adding an action to a screen from the palette
            Hiding and showing actions
            Actions
            Custom action
            Evaluate (If) action
            Extract action
            Extract All action
            Input action
            Pause action
            Perform action
            Play macro action
            Prompt action
            Prompt All action
            Set cursor position action
            Trace action
              Trace specification
            Update macro variable action
          Working with next screen connections
            Adding a next screen connection from the palette
            Reordering and changing next screen connections
          Working with VME preferences
        Advanced Macro Editor
          Using the editor
            Macro tab
            Screens tab
              Description tab
                Creating a new descriptor
                Field Counts and OIA descriptor
                How three separate and independent descriptors are presented as one
                Wait for OIA to Become Uninhibited descriptor
                Counting fields in the host terminal during macro development
                Treatment during screen recognition
                The '*' string in a new String descriptor
              Actions tab
                Creating a new action
            Links tab
            Variables tab
              Creating a new variable
              Creating an imported type for a Java class
          Working with actions
            Comm wait action
              Communication states
            Conditional action
              Specifying the condition
              Condition is True (<if> element)
              Condition is False (<else> element)
            Extract action
              Capturing text
                Set the Continuous Extract option
                Specify the area of the host terminal
                Specify an extraction name
                Specify TEXT_PLANE as the data plane
                Specify the variable in which you want the text to be stored
            Input action
              Input string
            Mouse click action
              Specifying row and column
            Pause action
            Perform action
              Invoking the method
            Playmacro action
              Target macro file name and starting screen
            Prompt action
              Displaying the prompt window
                Parts of the prompt window
                Default Response
                Password Response
                Require Response
              Processing the contents of the input field
                Response Length
                Action keys and Translate Host Action Keys
              Handling the input sequence in the host terminal
              Assigning the input sequence to a variable
            SQLQuery action
              The statement and results section
              Using the SQL Wizard
              Using the fields in the statement section
                Database URL
                Driver Identifier and Driver Class
                User ID and Password
                Statement
              Using the result section
                Storing the data into a macro variable ($HMLSQLUtil$)
              Using the SQLQuery action with bidirectional languages
            Trace action
              Trace specification
            Variable update action
      The Host On-Demand macro language
        Macro language features
          Syntax and editing
            XML syntax in the Host On-Demand macro language
            Source view editing
          Hierarchy of the elements
          Inserting comments into a macro script
            Comment errors
            Examples of comments
          Debugging macro scripts with the <trace> element
        Macro language elements
          Specifying the attributes
            XML requirements
            Advanced format in attribute values
            Typed data
          <actions> element
            Attributes
            XML samples
          <attrib> element
            Attributes
            XML samples
          <comment> element
            Attributes
            XML samples
            Alternate method for inserting comments
          <commwait> element
            Attributes
            XML samples
          <condition> element
            Attributes
            XML samples
          <create> element
            Attributes
            XML samples
          <cursor> element
            Attributes
            XML samples
          <custom> element
            Attributes
            XML samples
          <customreco> element
            Attributes
            XML samples
          <description> element
            Attributes
            XML samples
          <else> element
            Attributes
            XML samples
          <extract> element
            Attributes
            XML samples
          <HAScript> element
            Attributes
            XML samples
          <if> element
            Attributes
            XML samples
          <import> element
            Attributes
            XML samples
          <input> element
            Attributes
            XML samples
          <mouseclick> element
            Attributes
            XML samples
          <nextscreen> element
            Attributes
            XML samples
          <nextscreens> element
            Attributes
            XML samples
          <numfields> element
            Attributes
            XML samples
          <numinputfields> element
            Attributes
            XML samples
          <oia> element
            Attributes
            XML samples
          <pause> element
            Attributes
            XML samples
          <perform> element
            Attributes
            XML samples
          <playmacro> element
            Attributes
            XML samples
          <prompt> element
            Attributes
            XML samples
          <recolimit> element
            Attributes
            XML samples
          <screen> element
            Attributes
            XML samples
          <sqlquery> element
            Attributes
            XML samples
          <string> element
            Attributes
            XML samples
          <trace> element
            Attributes
            XML samples
          <type> element
            Attributes
            XML samples
          <vars> element
            Attributes
            XML samples
          <varupdate> element
            Attributes
            XML samples
      Appendix A. Additional information
        Default rule for combining multiple descriptors in one macro screen
        Mnemonic keywords for the Input action
    Troubleshooting
      Troubleshooting and support
      Troubleshooting overview
        Recording the symptoms of the problem
        Recreating the problem
        Eliminating possible causes
      Searching for information
        Search the HCL Infocenter
        Search the Internet
      Getting fixes
    ZIETrans API Reference
      Web