Developing ZIETrans Applications
  HCL Z and I Emulator for Transformation V1.0
  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
  HCL Z and I Emulator for Transformation V1.0
  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