HCL Z and I Emulator for Web
  Release Notes
    README
      Version 1.0
  Product Documentation
    Install Guide
      Planning, Installing, and Configuring Z and I Emulator for Web
        About this book
          About the other Z and I Emulator for Web documentation
          Conventions used in this book
          Terminology
            Terms relating to Java
        Planning for Z and I Emulator for Web
          Introducing HCL Z and I Emulator for Web
            What is Z and I Emulator for Web?
            How does Z and I Emulator for Web work?
            Why use Z and I Emulator for Web?
              A cost-effective approach to connectivity
              Centralized management of configuration data
              Connect directly to any Telnet server
              Supports many different platforms and network environments
              Support for Java
              Support for Internet Protocol Version 6
              Supports many national languages
              Secure connections
              Custom HTML files
              Toolkit for creating new e-business applications
              Support for WebSphere Portal
              Connections to DB2 databases on IBM System i servers
            What's new?
              Getting the latest information on Z and I Emulator for Web
          Planning for deployment
            Understanding the HTML-based model
            Understanding the configuration server-based model
            Understanding the combined model
            Client deployment considerations
          Planning for Java on the client
            Improvements to the client for Java
              Limits of support
            Downloading a client with Java
              Cannot download a component not in the preload list
              HTML files do not contain some components
            Mac OS X with Java
              Mac OS X limitations
              Slightly slower startup times with Java clients
              Limitations of specific Java plug-ins
              Limitations with customer-supplied applets and Java
              Limitations with restricted users and Java
            Browsers and Java plug-ins
              Java-enabled browsers
              Microsoft Internet Explorer with a Java plug-in
              Firefox with a Java plug-in
          Planning for security
            Transport Layer Security (TLS)
              How TLS security works
                Certificates
              TLS for Z and I Emulator for Web
                Session security
                Basic TLS enablement for Z and I Emulator for Web clients
                Examples of when to use session security
              Web server security
              Configuration security
            The Redirector
              Why use the Redirector?
              How the Redirector works
              Redirector load capacity
              Operating systems supported by the Redirector
                Operating systems that support IPv4
                Redirector support for IPv6
            Using Z and I Emulator for Web with a firewall
              Configuring firewall ports
              Connecting to a host system through a proxy server
                Connecting through a Socks proxy server
                Connecting through an HTTP proxy server
            User ID security
              Web Express Logon
              Native Authentication
              Windows Domain logon
            FIPS environments
          Planning for national language support
            Supported languages
            Supported host code pages
              3270 and 5250 code pages
              VT code pages
              CICS Gateway code pages
            Japanese JIS2004 Unicode support
            User-defined character mapping
            Unicode Support for i/OS and OS/400
        Installing, upgrading, and uninstalling Z and I Emulator for Web
          Installing the Z and I Emulator for Web server and related software
            Installing Z and I Emulator for Web using Installation Manager
              Important links
            Before the ZIEWeb Installation
              Preparing to Install
            Installing Z and I Emulator for Web
              Using the Installation Manager GUI to install
            Deployment Wizard
              Installing the Deployment Wizard
              Downloading the Deployment Wizard installation image from a Z and I Emulator for Web server
            ZIE Host Access Toolkit
              Installing the ZIE Host Access Toolkit
            Installing in the Console Mode
              About installing in the Console Mode
              Before installing ZIEWeb on IBM iSeries
              Installation procedure
              Installing Deployment wizard in Console mode
              Installing ZIE Host Access Toolkit in console mode
            Installing in Silent Mode
              Installation procedure
            Installing the configuration servlet
              Deploying the servlet on WebSphere Application Server
          Uninstalling the Z and I Emulator for Web server
            Uninstalling Z and I Emulator for Web using Installation Manager Console mode
        Configuring Z and I Emulator for Web
          Configuring Z and I Emulator for Web emulator clients
            Creating Z and I Emulator for Web HTML files
            Configuring Z and I Emulator for Web sessions
            Using the Deployment Wizard
              Distributing the Deployment Wizard output to your Z and I Emulator for Web server
          Using Z and I Emulator for Web administration and new user clients
            Loading administration and new user clients
            Administration clients
              Directory Utility
            New user clients
          Using Z and I Emulator for Web emulator clients
            Loading emulator clients
            Selecting the appropriate client
            Web Start client
              Installing the Web Start client
                Installing the Web Start client from the Z and I Emulator for Web server
                  Using a Web browser
                  Without using a Web browser
                Installing the Web Start client from a LAN or DVD
              Configuring your Web server for Web Start
                Apache HTTP Server or IBM HTTP Server
                Microsoft IIS 7.0
              Upgrading the Web Start client
              Adding Web Start components after the initial install
              Bookmarking sessions with Web Start
              Using Web Start with HTTPS
              Removing the Web Start client
            Deploying customer-supplied Java archives and classes
              Using the AdditionalArchives HTML parameter
              Deploying from the Publish directory
              Hints and tips for archive files
          Using Database On-Demand clients
            Database functions in Display Emulation clients and in macros
            Starting a Database On-Demand client
            Database On-Demand predefined clients
            Configuring Database On-Demand for users
            Obtaining and installing a JDBC driver
            File formats for database access
            Using multiple code pages with Database On-Demand
              Supported Database On-Demand code pages
          Creating and deploying server macro libraries
            Deploying a server macro library to a Web server
              Deploying a server macro library to a shared drive
          Modifying session properties dynamically
            Setting up the initial HTML file
            Setting the Code base
            Add the ConfigBase Parameter
            Overriding HTML parameters
            Specific session properties that can be overridden
            Example #1: Overriding the LU name based on the client's IP address
            Example #2: Allowing the user to specify the host to connect to using an HTML form
          Configuring Z and I Emulator for Web on zSeries
            Setting up separate read/write private and publish directories
              Set up a separate File System for the Z and I Emulator for Web private directory
              Set up a separate user publish directory
            Installing the Development Wizard from the z/OS server
          Configuring Z and I Emulator for Web on IBM System i
            Configuring, starting, and stopping the Z and I Emulator for Web Service Manager on IBM System i
              Configure
              Start
              Stop
              Work with ZIE Server status
              Start Information Bundler
              Create ZIEWeb Printer Definition Table
            Using the Deployment Wizard with IBM System i
            Configuring IBM System i servers for secure connection
              Installing and configuring Z and I Emulator for Web with TLS on i/OS and OS/400
              Configuring a Telnet server for secure connection
              Configuring the Z and I Emulator for Web CustomizedCAs keyring
              Client authentication
              Configuring the Z and I Emulator for Web OS/400 proxy for secure connections
                Set up TLS user authorizations
              Secure Web serving
            Unicode Support for i/OS and OS/400
              General information
              Host programming information
            Eclipse-Plugin support
              Creating Z and I Emulator for Web plug-ins
              Setting Session Properties Dynamically
              Using a separate user publishing directory
              View IDs used in Z and I Emulator for Web plugin
              Limitations on using Z and I Emulator for Web in a Eclipse-Plugin environment
            Configuring Z and I Emulator for Web Server to use LDAP
              Setting up LDAP support
              Installing the schema extensions
              Configuring the Z and I Emulator for Web server to use LDAP as a data store
        Notices
        Trademarks
    Web Express Logon Reference
      About this book
        About this book
          Conventions used in this book
      Overview of Web Express Logon
        Introduction
          What is the difference between Web Express Logon, Certificate Express Logon and Reuse Active Credentials?
            Using client certificates with Web Express Logon
          Can I migrate from Certificate Express Logon to Certificate-based Web Express Logon?
          How does Web Express Logon work?
            Macro-based automation
              Supported environments
                z/OS and DCAS host authentication
                z/OS with vault-style credential mapping
                Authentication via Portal Server's Credential Vault Service
            Connection-based automation
              Supported environments
                IBM i5/OS or OS/400 host with Kerberos passticket authentication
                FTP login
      Planning
        Planning for implementation
          Step 1: Choose your style of logon automation.
          Step 2: Identify areas of credential challenges.
          Step 3: Take an inventory of your environment.
            Macro-based automation
            Connection-based automation
          Step 4: Develop your deployment strategy.
          Step 5: Establish an HCM database.
      Implementing macro-based automation
        Configuring macro-based automation in a z/OS and DCAS environment
          Step 1: Configure the Credential Mapper Servlet (CMS).
            A. Locate the WAR files on the Z and I Emulator for Web DVD
            B. Become familiar with the INIT parameters in the web.xml file.
            C. Edit the CMS-related parameters.
            D. Add optional CMS-related debugging parameters.
            E. Add the required DCAS client parameters for the CMPIDCASPlugin.
            F. Add the optional DCAS client parameters (if desired).
          Step 2: Save the WAR file and deploy the CMS.
          Step 3: Create the SSL key database.
          Step 4: Add the Web server's certificate to the Java keyring (Java 2 clients only).
          Step 5: Begin creating your HTML file.
          Step 6: Configure the Z and I Emulator for Web session to use Web Express Logon.
          Step 7: Record the Web Express Logon macro.
          Step 8: Finish creating your HTML file.
        Configuring macro-based automation in a vault-style environment
          Step 1: Configure the Credential Mapper Servlet (CMS).
            A. Locate the WAR files on the Z and I Emulator for Web DVD
            B. Become familiar with the INIT parameters in the web.xml file.
            C. Edit the CMS-related parameters.
            D. Add optional CMS-related debugging parameters.
            E. Add the required Vault parameters for the CMPIVaultPlugin.
            F. Add the optional Vault parameters (if desired).
          Step 2: Save the WAR file and deploy the CMS.
          Step 3: Begin creating your HTML file.
          Step 4: Configure the Z and I Emulator for Web session to use Web Express Logon.
          Step 5: Record the Web Express Logon macro.
          Step 6: Finish creating your HTML file.
        Configuring macro-based automation in a Portal Server environment
          Step 1: Begin creating your Z and I Emulator for Web portlet.
          Step 2: Configure the Z and I Emulator for Web session to use Web Express Logon.
          Step 3: Record the Web Express Logon macro.
          Step 4: Finish creating your Z and I Emulator for Web portlet.
          Step 5: Using a custom portlet to manage user credentials
      Implementing connection-based automation
        Configuring connection-based automation in an i5/OS or OS/400 and Kerberos environment
          Step 1: Use the Deployment Wizard to create your HTML file.
          Step 2: Configure your Z and I Emulator for Web session to use Web Express Logon.
        Configuring connection-based automation in an FTP environment
          Step 1: Configure the Credential Mapper Servlet (CMS).
            A. Locate the WAR files on the Z and I Emulator for Web DVD
            B. Become familiar with the INIT parameters in the web.xml file.
            C. Edit the CMS-related parameters.
            D. Add optional CMS-related debugging parameters.
            E. Add the required Vault parameters for the CMPIVaultPlugin.
            F. Add the optional Vault parameters (if desired).
          Step 2: Save the WAR file and deploy the CMS.
          Step 3: Begin creating your HTML file.
          Step 4: Configure the Z and I Emulator for Web session to use Web Express Logon.
          Step 5: Finish creating your HTML file.
      API programming guide
        Customizing Web Express Logon
          Approach 1: Replace the entire CMS with your own custom version of the servlet
            HTTP request parameters
            XML data response object
          Approach 2: Customize the existing CMS provided with Z and I Emulator for Web
            com.ibm.eNetwork.security.SSO.CMS.CMInterface
            com.ibm.eNetwork.security.sso.CMRequest
            com.ibm.eNetwork.security.sso.CMResponse
          Writing your own plug-ins
      Troubleshooting error messages
        Troubleshooting Web Express Logon
          Web Express Logon client-side messages
          Web Express Logon server-side messages
          DCAS error messages
      Recording the Web Express Logon macro
      Web Express Logon using the Configuration server-based model
      Password encryption tool
        Windows platforms
        Unix platforms
      Sample HCM plug-in
        Write the HCM plug-in.
        Update the web.xml file.
      Glossary of terms
        authentication type
        client certificate
        connection-based automation
        credential challenges
        Credential Mapper Servlet (CMS)
        Digital Certificate Access Server (DCAS)
        Enterprise Identity Mapping (EIM)
        full class path name
        Host Credential Mapper (HCM)
        host ID
        host mask
        Kerberos
        macro-based automation
        network ID
        Network Security plug-in
        Portal Server Credential Vault
        Resource Access Control Facility (RACF)
      Sources for more information
      Notices
      Trademarks
    Macro Programming Guide
      About this book
        About the other Z and I Emulator for Web documentation
        Conventions used in this book
      Macro basics
        Introduction
          Z and I Emulator for Web macros
            Definition of a macro
            Advantages of macros
            Unsophisticated users
            Sophisticated users
            Programming features
            Samples
          Deploying macros
          Using macros to integrate your enterprise applications
          ZIE Host Access Toolkit
          Macros and security
          This book focuses on 3270 applications
        Macro components
          Overview
          Macro Manager
            Macro Manager toolbar
            Macro Editor
            Code Editor
          Macro runtime
          Macro object
          Definitions of other terms
        Recording and playing back a simple macro
          Recording a simple macro
          Playing back a simple macro
          Assigning the macro to a key combination
        Macro structure
          Macro script
            XML elements
            Conceptual view of a macro script
            Introduction to the Macro tab
          The macro screen and its subcomponents
            Application screen
            Macro screen
            Conceptual view of a macro screen
            Introduction to the Screens tab
      Developing macros
        Data types, operators, and expressions
          Choosing a macro format
            The basic macro format versus the advanced macro format
            Representation of strings and special characters, treatment of operator characters
              In the basic macro format, rules for representation of strings, etc.
              In the advanced macro format, rules for representation of strings, etc.
            Converting your macro to a different format
              Converting your macro to the advanced macro format
              Converting your macro to the basic macro format
          Standard data types
            Boolean data
              Boolean values are not strings
            Integers
              Integer constants
            Doubles
            Strings
          Fields
          The value null
          Arithmetic operators and expressions
            Operators and expressions
            Where arithmetic expressions can be used
          String concatenation operator (+)
            Operators and expressions
          Conditional and logical operators and expressions
            Conditional expression can include complex terms
            Where conditional expressions can be used
          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
            Scenario used as an example
            Stages in processing a macro screen
            Closer look at stage 1
            Overview of the entire process (all 3 stages)
            Conclusion of the overview
          Stage 1: Determining the next macro screen to be processed
            Adding macro screen names to the list of valid next screens (step 1(a))
              Valid next screens
              How the macro runtime selects the names of candidate macro screens
                First macro screen
                Subsequent macro screens
                Transient screens
            Screen recognition (step 1(b))
              Overview of evaluation
              Re-doing the evaluation
              Determining whether a macro screen matches the application screen
              Two recognition features
                Timeout setting for screen recognition
                Recognition limit
            Removing the names of candidate macro screens from the list of valid next screens (step 1(c))
          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 and recognition
          Terms defined
          Introduction to the Description tab
            Sample Description tab
              Creating a new descriptor
          Recorded descriptions
            What information is recorded
            Why the recorded descriptions work
            Recorded descriptors provide a framework
          Evaluation of descriptors
            Practical information
            Overview of the process
            Evaluation of individual descriptors
            Default combining method
              When to use the default combining method
              Inverse Descriptor
              Optional
              Default combining rule
            The uselogic attribute
          The descriptors
            Overview
            Field Counts and OIA descriptor
              Required
              Presents three separate and independent descriptors as if one
              Treatment during screen recognition
              Wait for OIA to Become Uninhibited descriptor (<oia> element)
                Specifying a session
              Number of Fields descriptor (<numfields> element)
                Specifying a session
              Number of Input Fields descriptor (<numinputfields> element)
                Specifying a session
              Counting fields in the session window during macro development
            String descriptor (<string> element)
              Specifying the rectangular area
              How the macro runtime searches the rectangular area (Wrap option)
                Using an extracted string in a String descriptor
              The '*' string in a new String descriptor
              Easy method for filling in the parameters
              Multiple String descriptors in the same <description> element
              Specifying a session
            Cursor descriptor (<cursor> element)
              Specifying a session
            Attribute descriptor (<attrib> element)
              Specifying an attribute
              Specifying a session
            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
        Macro actions
          In general
            The actions by function
            How actions are performed
              The runtime context
              The macro screen context
            Specifying parameters for actions
          Introduction to the Actions tab
            Sample Actions tab
            Creating a new action
          The actions
            Box selection action (<boxselection> element)
              Specifying row and column values
              Erasing the marking rectangle
              Specifying a session
              Example
            Comm wait action (<commwait> element)
              How the action works
              Specify a communication status that is persistent
              Communication states
              Specifying a session
              Examples
            Conditional action (<if> element and <else> element)
              Specifying the condition
              Condition is True (<if> element)
              Condition is false (<else> element)
              Condition action not allowed within a Condition action
              Example
            Extract action (<extract> element)
              Capturing text
                Set the Continuous Extract option
                Specify the area of the session window
                Specify an extraction name
                Specify TEXT_PLANE as the data plane
                Specify the variable in which you want the text to be stored
              Treatment of nulls and other undisplayable characters
              Capturing a rectangular area of the session window
              Capturing a sequence of text from the session window
              Unwrap Text option
                When Unwrap Text is true and Continuous Extract is false
                When Unwrap Text is true and Continuous Extract is true
              Using the Toolkit to capture data from any data plane
              Specifying a session
            FileUpload action (<fileupload> element)
              Connecting with the database server
                Database URL
                Driver Identifier and Driver Class
                User ID and Password
              Specifying information for the file upload
                File Name and File Type
                Table Name
                Create
                Replace
                Append
                Update
              Preloading the database components for the Z and I Emulator for Web client
            Input action (<input> element)
              Location at which typing begins
              Input errors
              Input string
              Translate Host Action Keys
              Move Cursor to End of Input
              Password
                Automatic encryption during macro recording
                Using the Password checkbox
                Using the Code Editor
                Encrypting a variable name
              Specifying a session
              Example
            Message action (<message> element)
              Displaying the message caption and message text
            Mouse click action (<mouseclick> element)
              Specifying row and column
              Specifying a session
              Copy and paste example
            Pause action (<pause> element)
            Perform action (<perform> element)
              Invoking the method
              Examples
            PlayMacro action (<playmacro> element)
              Adding a PlayMacro action
              Target macro file name and starting screen
              Transferring variables
                Requirements for transferring variables
                Restriction
                Additional information
                When the target macro needs to import a type
              Examples
            Print actions (<print> element)
              Print Start
                Printer Setup and Page Setup
                Assign Return Code to a Variable
              Print Extract
                Specifying the area to be printed
                Assign Return Code to a Variable
                Specifying a session
              Print End
                Assign Return Code to a Variable
            Prompt action (<prompt> element)
              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 session window
              Assigning the input sequence to a variable
              The promptall attributes
              Specifying a session
            Run program action (<runprogram> element)
              Launching the native application
              Waiting for the native application to terminate
              Capturing the return code
              Example of launching a native application
            SQLQuery action (<sqlquery> element)
              Two sections: statement and results
              Using the SQL Wizard
              Importing an SQL statement
              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 global variable ($HMLSQLUtil$)
                Writing the data into a file
                Displaying the data
              Preloading the database components for the Z and I Emulator for Web client
            Trace action (<trace> element)
              Example
              User trace event
            Variable update action (<varupdate> element)
              Variable update action with a field variable
                Reading part of a field
            Xfer action (<filexfer> element)
              Basic parameters
              Advanced parameters
              Parameters for BIDI sessions (Arabic or Hebrew)
              Specifying a session
              Examples
        Screen Recognition, Part 2
          Valid next screens
          Entry screens, exit screens, and transient screens
            Entry screens
              Macro with several entry screens
              Entry screen can also be a normal screen
            Exit screens
            Transient screens
              Example of handling of transient screen
          Timeout settings for screen recognition
            Screen recognition
            Timeout Between Screens (Macro tab)
            Timeout (Links tab)
          Recognition limit (General tab of the Screens tab)
            Determining when the recognition limit is reached
            Action when the Recognition limit is reached
        Actions, Part 2: Timing issues
          Pause after an action
            Speed of processing actions
            Pause Between Actions (Macro tab)
            Set Pause Time (General tab of the Screens tab)
            Adding a pause after a particular action
          Screen completion
            Recognizing the next macro screen too soon
            The ordinary TN3270 protocol
            Solutions
              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
              ignorepauseoverride=true/false
              delayifnotenhancedtn=(milliseconds)
        Variables and imported Java classes
          Introduction to variables and imported types
            Advanced macro format required
            Scope of variables
            Introduction to the Variables tab
              Creating a new variable
              Creating an imported type for a Java class
          Issues you should be aware of
            Deploying Java libraries or classes
            Variable names and type names
            Transferring variables from one macro to another
            Field variables
          Using variables
            When variables are initialized
            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
          Passing a parameter list to a macro
            How the Z and I Emulator for Web processes a parameter list
            Specifying the parameter list
              Where to specify a parameter list
              Format of a parameter list
              Checking the parameter list for errors
              Specifying the parameter list from a program
            Considerations for the macro writer
            A parameter list does not initialize variables in a chained-to macro
          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 an method belonging to an HML library
            Variables 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()
            $HMLSystemUtil$
              Method details
                getHTMLParameter()
                getenv()
                  Limitations
                getSystemProperty()
                General Limitations
            FormatNumberToString() and FormatStringToNumber()
        Other security options
          Record password
            When Record Password is enabled
            When Record Password is disabled
        Other advanced features
          Interacting with more than one session
            Basics
            Implementation
            Two techniques for building macro screens
            Runtime processing
              Descriptors
                All descriptors apply to the same active session
                Some descriptors apply to a different active session
              Actions
            Run-time requirements
            Specifying a Host ID
              Using automatic editing features with other sessions
            Recording a macro that interacts with more than one session
              Storing the macro script
              One recorded macro screen refers to one session window
              Starting, stopping, and switching sessions
              The currently selected session
              Other active sessions
              More than one active recording
            Referring to different sessions in the same macro screen
            Disabling macro recording
        The graphical user interface
          Updating fields in the Macro Editor
            Using the session window
            Using the marking rectangle
            Using the session window's text cursor
            Error in specifying a string
          Using the Code Editor
            Copy and paste a script from this guide into the Code Editor
      The macro language
        Features of the macro language
          Use of XML
            XML syntax in the Z and I Emulator for Web macro language
            Code Editor
          Hierarchy of the elements
          Inserting comments into a macro script
            Format of comments
            Comment errors
            Examples of comments
          Debugging macro scripts with the <trace> element
          Using the ZIE Host Access Toolkit product with macros
        Macro language elements
          Specifying the attributes
            XML requirements
            Advanced format in attribute values
            Typed data
          <actions> element
            General
            Attributes
            XML samples
          <attrib> element
            General
            Attributes
            XML samples
          <boxselection> element
            General
            Attributes
            XML samples
          <comment> element
            General
              A better method for inserting comments
            Attributes
            XML samples
          <commwait> element
            General
            Attributes
            XML samples
          <condition> element
            General
            Attributes
            XML samples
          <create> element
            General
            Attributes
            XML samples
          <cursor> element
            General
            Attributes
            XML samples
          <custom> element
            General
            Attributes
            XML samples
          <customreco> element
            General
            Attributes
            XML samples
          <description> element
            General
            Attributes
            XML samples
          <else> element
            General
            Attributes
            XML samples
          <extract> element
            General
            Attributes
            XML samples
          <fileupload> element
            General
            Attributes
            XML samples
          <filexfer> element
            General
            Attributes
            XML samples
          <HAScript> element
            General
            Attributes
            XML samples
          <if> element
            General
            Attributes
            XML samples
          <import> element
            General
            Attributes
            XML samples
          <input> element
            General
            Attributes
            XML samples
          <message> element
            General
            Attributes
            XML samples
          <mouseclick> element
            General
            Attributes
            XML samples
          <nextscreen> element
            General
            Attributes
            XML samples
          <nextscreens> element
            General
            Attributes
            XML samples
          <numfields> element
            General
            Attributes
            XML samples
          <numinputfields> element
            General
            Attributes
            XML samples
          <oia> element
            General
            Attributes
            XML samples
          <pause> element
            General
            Attributes
            XML samples
          <perform> element
            General
            Attributes
            XML samples
          <playmacro> element
            General
            Attributes
            XML samples
          <print> element
            General
            Attributes
            XML samples
          <prompt> element
            General
            Attributes
            XML samples
          <recolimit> element
            General
            Attributes
            XML samples
          <runprogram> element
            General
            Attributes
            XML samples
          <screen> element
            General
            Attributes
            XML samples
          <sqlquery> element
            General
            Attributes
            XML samples
          <string> element
            General
            Attributes
            XML samples
          <trace> element
            General
            Attributes
            XML samples
          <type> element
            General
            Attributes
            XML samples
          <vars> element
            General
            Attributes
            XML samples
          <varupdate> element
            General
            Attributes
            XML samples
        Sample macro code
          Copy CICS transaction records into Excel spreadsheet or DB2 database
            Introduction
            Steps for running Excel sample (Windows only)
            Steps for running DB2 sample
      Additional information
        The default combining rule for multiple descriptors in one macro screen
          Statement of the rule
        Mnemonic keywords for the Input action
      Notices
      Trademarks
    Host Access Toolkit
      About this book
      Introducing the ZIE Host Access Toolkit
        Components of the ZIE Host Access Toolkit
        What's new in Z and I Emulator for Web Version 1.0
          New functions in Z and I Emulator for Web Version 1.0
        Where to go for more information
          Web sites
      Planning for the ZIE Host Access Toolkit
        Supported operating systems
        Disk space requirement
        Supported browsers
        Java Support
      Installing the ZIE Host Access Toolkit
      Introducing the ZIE Host Access Toolkit Application Programming Interfaces
        Introducing the Host Access Class Library
        Introducing the Host Access Beans
          Descriptions
          Events
          Accessibility Features
        Introducing Z and I Emulator for Web J2EE Connector
      Installing the iSeries Toolbox for Java
      Notices
        Trademarks
    Host Printing Reference
      About this book
      Conventions used in this book
      Introduction to Host Printing (3270)
      Creating a Printer Definition Table (3270)
      Understanding the Format of Printer Definition Files (3270)
      Introduction to Host Printing (5250)
      Introduction to Host Printing (VT)
      Printer Data Stream Information (3270)
      National Language Support
      Advanced Configuration Options (3270)
      Troubleshooting
      Associated Printer Sessions (3270)
      Printer Definition File Example (3270)
    Tutorials
      Customizing HTML templates
      Configuring the SSH client
      ZIE for Web on iSeries
    Troubleshooting and support
      Troubleshooting overview
      Troubleshooting checklist
      Troubleshooting tips for users
      Searching knowledge bases
        Web search
      Getting fixes
      Preparing to call HCL support
      Contacting support
    Online Help
      For Administrators
        ZIE License Manager
          Installing and Configuring the HCL ZIE License Manager
        Overview
          Planning for deployment
          Configuring ZIE for Web sessions
        Deployment Wizard
          Deployment Wizard welcome
          Configuration model
          Choose ZIE for Web Java Level
          Browser Independent ZIE for Web Clients
            ZIEWeb Launcher
          Client Settings
          Web Start Settings
          Preload Options
          Advanced Options
            HTML parameters
            Code base
            HTML templates
          File Name and Output Format
        HTML model
          Understanding the HTML model
          Benefits of the HTML-based model
          Configuring and managing sessions using the Deployment Wizard
            Configuring host sessions
            Disable Functions
            Sharing and reusing macros, keyboard and toolbar definitions (administrators)
        Configuration server model
          Understanding the configuration server model
          Configuration server-based model
          Managing users and groups
            Adding a group
            Enabling users to create accounts
            Adding a user
            Deleting a user or group
            Using the Directory Utility
          Configuring and managing sessions using the Administration Utility
            Configuring host sessions
            Disable Functions
            Sharing and reusing macros, keyboard and toolbar definitions
          LDAP
            Understanding directories
            Setting up and using LDAP
            Specifying the LDAP directory information
            Migrating to an LDAP directory
            Implications of migrating to LDAP
        Combined model
          Understanding the combined model
          Combined model
        Printing
          Printing from a host to a workstation (3270)
          Printing from a host to a workstation (5250)
          Compiling a printer definition table
          Printer Setup
        Transferring files
          Using FTP
          Using sftp (SSH File Transfer Protocol)
          Using host file transfer
        Java 1 and Java 2
          Planning for Java on the client
          Java 1
          Java 2
        Security and certificate management
          Server authentication
          Obtaining a server certificate
          Making server certificates available to clients
          Configuring clients to use SSH
          Configuring clients to use SSL
        Working with macros
          Using the Macro Editor
          Using the Macro Manager
          Creating and deploying server macro libraries for users
          Editing macro screen definitions
        Service manager
          Configuring the service manager
          Using the Redirector
            Introducing the Redirector
            Defining a host in the Redirector
            Changing a host defined to the Redirector
            Deleting a host from the Redirector
      Using sessions
        Starting a session
        Adding a session
        Copying a session
        Deleting a session
        Bookmarking a session
        Jumping between sessions
        Cut, Copy, Paste, and Entry Assist in a session
        Using Start PC Command (STRPCCMD) in a 5250 host session
      Configuring user sessions
        Sharing and reusing macros, keyboard and toolbar definitions
        Remapping the keyboard
        Specifying a key as repeating or non-repeating
        Changing host session colors
        Customize Toolbar
        Configuring clients to use SSH
        Configuring clients to use SSL
        Configuring to connect to the Redirector
        History file setup
        Configuring the Popup Keypad
        Configuring the Mouse Wheel
      Java 1 and Java 2
        Using Java 1
        Using Java 2
      Printing
        Printing a screen
        Changing margins, page orientation, and paper source
        Adding headers and footers
        Print Screen
        Print Screen Collection
        Printing from a 3270 host session
        Printing from a 5250 host session
        ZipPrint
      Transferring files
        Using FTP
        Using sftp (SSH File Transfer Protocol)
        Using host file transfer
        Changing transfer options
      Security and certificate management
        Client authentication
        Obtaining client certificates
        Changing a certificate password
        Viewing security information for an SSH session
        Viewing server certificate information
        Viewing or saving certificate information
      Managing macros
        Managing a macro
        Recording a macro
        Saving a macro to a personal macro library
        Playing a macro
        Changing a macro
        Editing a macro
        Deleting a macro
      National language support
        General national language support
          Adobe PDF file created by a 3270 printer session
          Definitions of some national language support terms
          Displaying national language characters correctly
          DBCS languages
          European languages
          Greek
          Turkish
          Unicode support for OS/400
          User-defined characters (UDCs)
        Bidirectional language support
        Hindi language support
        Thai language support
  Release Notes
    README
      Version 1.0
  Product Documentation
    Install Guide
      Planning, Installing, and Configuring Z and I Emulator for Web
        About this book
          About the other Z and I Emulator for Web documentation
          Conventions used in this book
          Terminology
            Terms relating to Java
        Planning for Z and I Emulator for Web
          Introducing HCL Z and I Emulator for Web
            What is Z and I Emulator for Web?
            How does Z and I Emulator for Web work?
            Why use Z and I Emulator for Web?
              A cost-effective approach to connectivity
              Centralized management of configuration data
              Connect directly to any Telnet server
              Supports many different platforms and network environments
              Support for Java
              Support for Internet Protocol Version 6
              Supports many national languages
              Secure connections
              Custom HTML files
              Toolkit for creating new e-business applications
              Support for WebSphere Portal
              Connections to DB2 databases on IBM System i servers
            What's new?
              Getting the latest information on Z and I Emulator for Web
          Planning for deployment
            Understanding the HTML-based model
            Understanding the configuration server-based model
            Understanding the combined model
            Client deployment considerations
          Planning for Java on the client
            Improvements to the client for Java
              Limits of support
            Downloading a client with Java
              Cannot download a component not in the preload list
              HTML files do not contain some components
            Mac OS X with Java
              Mac OS X limitations
              Slightly slower startup times with Java clients
              Limitations of specific Java plug-ins
              Limitations with customer-supplied applets and Java
              Limitations with restricted users and Java
            Browsers and Java plug-ins
              Java-enabled browsers
              Microsoft Internet Explorer with a Java plug-in
              Firefox with a Java plug-in
          Planning for security
            Transport Layer Security (TLS)
              How TLS security works
                Certificates
              TLS for Z and I Emulator for Web
                Session security
                Basic TLS enablement for Z and I Emulator for Web clients
                Examples of when to use session security
              Web server security
              Configuration security
            The Redirector
              Why use the Redirector?
              How the Redirector works
              Redirector load capacity
              Operating systems supported by the Redirector
                Operating systems that support IPv4
                Redirector support for IPv6
            Using Z and I Emulator for Web with a firewall
              Configuring firewall ports
              Connecting to a host system through a proxy server
                Connecting through a Socks proxy server
                Connecting through an HTTP proxy server
            User ID security
              Web Express Logon
              Native Authentication
              Windows Domain logon
            FIPS environments
          Planning for national language support
            Supported languages
            Supported host code pages
              3270 and 5250 code pages
              VT code pages
              CICS Gateway code pages
            Japanese JIS2004 Unicode support
            User-defined character mapping
            Unicode Support for i/OS and OS/400
        Installing, upgrading, and uninstalling Z and I Emulator for Web
          Installing the Z and I Emulator for Web server and related software
            Installing Z and I Emulator for Web using Installation Manager
              Important links
            Before the ZIEWeb Installation
              Preparing to Install
            Installing Z and I Emulator for Web
              Using the Installation Manager GUI to install
            Deployment Wizard
              Installing the Deployment Wizard
              Downloading the Deployment Wizard installation image from a Z and I Emulator for Web server
            ZIE Host Access Toolkit
              Installing the ZIE Host Access Toolkit
            Installing in the Console Mode
              About installing in the Console Mode
              Before installing ZIEWeb on IBM iSeries
              Installation procedure
              Installing Deployment wizard in Console mode
              Installing ZIE Host Access Toolkit in console mode
            Installing in Silent Mode
              Installation procedure
            Installing the configuration servlet
              Deploying the servlet on WebSphere Application Server
          Uninstalling the Z and I Emulator for Web server
            Uninstalling Z and I Emulator for Web using Installation Manager Console mode
        Configuring Z and I Emulator for Web
          Configuring Z and I Emulator for Web emulator clients
            Creating Z and I Emulator for Web HTML files
            Configuring Z and I Emulator for Web sessions
            Using the Deployment Wizard
              Distributing the Deployment Wizard output to your Z and I Emulator for Web server
          Using Z and I Emulator for Web administration and new user clients
            Loading administration and new user clients
            Administration clients
              Directory Utility
            New user clients
          Using Z and I Emulator for Web emulator clients
            Loading emulator clients
            Selecting the appropriate client
            Web Start client
              Installing the Web Start client
                Installing the Web Start client from the Z and I Emulator for Web server
                  Using a Web browser
                  Without using a Web browser
                Installing the Web Start client from a LAN or DVD
              Configuring your Web server for Web Start
                Apache HTTP Server or IBM HTTP Server
                Microsoft IIS 7.0
              Upgrading the Web Start client
              Adding Web Start components after the initial install
              Bookmarking sessions with Web Start
              Using Web Start with HTTPS
              Removing the Web Start client
            Deploying customer-supplied Java archives and classes
              Using the AdditionalArchives HTML parameter
              Deploying from the Publish directory
              Hints and tips for archive files
          Using Database On-Demand clients
            Database functions in Display Emulation clients and in macros
            Starting a Database On-Demand client
            Database On-Demand predefined clients
            Configuring Database On-Demand for users
            Obtaining and installing a JDBC driver
            File formats for database access
            Using multiple code pages with Database On-Demand
              Supported Database On-Demand code pages
          Creating and deploying server macro libraries
            Deploying a server macro library to a Web server
              Deploying a server macro library to a shared drive
          Modifying session properties dynamically
            Setting up the initial HTML file
            Setting the Code base
            Add the ConfigBase Parameter
            Overriding HTML parameters
            Specific session properties that can be overridden
            Example #1: Overriding the LU name based on the client's IP address
            Example #2: Allowing the user to specify the host to connect to using an HTML form
          Configuring Z and I Emulator for Web on zSeries
            Setting up separate read/write private and publish directories
              Set up a separate File System for the Z and I Emulator for Web private directory
              Set up a separate user publish directory
            Installing the Development Wizard from the z/OS server
          Configuring Z and I Emulator for Web on IBM System i
            Configuring, starting, and stopping the Z and I Emulator for Web Service Manager on IBM System i
              Configure
              Start
              Stop
              Work with ZIE Server status
              Start Information Bundler
              Create ZIEWeb Printer Definition Table
            Using the Deployment Wizard with IBM System i
            Configuring IBM System i servers for secure connection
              Installing and configuring Z and I Emulator for Web with TLS on i/OS and OS/400
              Configuring a Telnet server for secure connection
              Configuring the Z and I Emulator for Web CustomizedCAs keyring
              Client authentication
              Configuring the Z and I Emulator for Web OS/400 proxy for secure connections
                Set up TLS user authorizations
              Secure Web serving
            Unicode Support for i/OS and OS/400
              General information
              Host programming information
            Eclipse-Plugin support
              Creating Z and I Emulator for Web plug-ins
              Setting Session Properties Dynamically
              Using a separate user publishing directory
              View IDs used in Z and I Emulator for Web plugin
              Limitations on using Z and I Emulator for Web in a Eclipse-Plugin environment
            Configuring Z and I Emulator for Web Server to use LDAP
              Setting up LDAP support
              Installing the schema extensions
              Configuring the Z and I Emulator for Web server to use LDAP as a data store
        Notices
        Trademarks
    Web Express Logon Reference
      About this book
        About this book
          Conventions used in this book
      Overview of Web Express Logon
        Introduction
          What is the difference between Web Express Logon, Certificate Express Logon and Reuse Active Credentials?
            Using client certificates with Web Express Logon
          Can I migrate from Certificate Express Logon to Certificate-based Web Express Logon?
          How does Web Express Logon work?
            Macro-based automation
              Supported environments
                z/OS and DCAS host authentication
                z/OS with vault-style credential mapping
                Authentication via Portal Server's Credential Vault Service
            Connection-based automation
              Supported environments
                IBM i5/OS or OS/400 host with Kerberos passticket authentication
                FTP login
      Planning
        Planning for implementation
          Step 1: Choose your style of logon automation.
          Step 2: Identify areas of credential challenges.
          Step 3: Take an inventory of your environment.
            Macro-based automation
            Connection-based automation
          Step 4: Develop your deployment strategy.
          Step 5: Establish an HCM database.
      Implementing macro-based automation
        Configuring macro-based automation in a z/OS and DCAS environment
          Step 1: Configure the Credential Mapper Servlet (CMS).
            A. Locate the WAR files on the Z and I Emulator for Web DVD
            B. Become familiar with the INIT parameters in the web.xml file.
            C. Edit the CMS-related parameters.
            D. Add optional CMS-related debugging parameters.
            E. Add the required DCAS client parameters for the CMPIDCASPlugin.
            F. Add the optional DCAS client parameters (if desired).
          Step 2: Save the WAR file and deploy the CMS.
          Step 3: Create the SSL key database.
          Step 4: Add the Web server's certificate to the Java keyring (Java 2 clients only).
          Step 5: Begin creating your HTML file.
          Step 6: Configure the Z and I Emulator for Web session to use Web Express Logon.
          Step 7: Record the Web Express Logon macro.
          Step 8: Finish creating your HTML file.
        Configuring macro-based automation in a vault-style environment
          Step 1: Configure the Credential Mapper Servlet (CMS).
            A. Locate the WAR files on the Z and I Emulator for Web DVD
            B. Become familiar with the INIT parameters in the web.xml file.
            C. Edit the CMS-related parameters.
            D. Add optional CMS-related debugging parameters.
            E. Add the required Vault parameters for the CMPIVaultPlugin.
            F. Add the optional Vault parameters (if desired).
          Step 2: Save the WAR file and deploy the CMS.
          Step 3: Begin creating your HTML file.
          Step 4: Configure the Z and I Emulator for Web session to use Web Express Logon.
          Step 5: Record the Web Express Logon macro.
          Step 6: Finish creating your HTML file.
        Configuring macro-based automation in a Portal Server environment
          Step 1: Begin creating your Z and I Emulator for Web portlet.
          Step 2: Configure the Z and I Emulator for Web session to use Web Express Logon.
          Step 3: Record the Web Express Logon macro.
          Step 4: Finish creating your Z and I Emulator for Web portlet.
          Step 5: Using a custom portlet to manage user credentials
      Implementing connection-based automation
        Configuring connection-based automation in an i5/OS or OS/400 and Kerberos environment
          Step 1: Use the Deployment Wizard to create your HTML file.
          Step 2: Configure your Z and I Emulator for Web session to use Web Express Logon.
        Configuring connection-based automation in an FTP environment
          Step 1: Configure the Credential Mapper Servlet (CMS).
            A. Locate the WAR files on the Z and I Emulator for Web DVD
            B. Become familiar with the INIT parameters in the web.xml file.
            C. Edit the CMS-related parameters.
            D. Add optional CMS-related debugging parameters.
            E. Add the required Vault parameters for the CMPIVaultPlugin.
            F. Add the optional Vault parameters (if desired).
          Step 2: Save the WAR file and deploy the CMS.
          Step 3: Begin creating your HTML file.
          Step 4: Configure the Z and I Emulator for Web session to use Web Express Logon.
          Step 5: Finish creating your HTML file.
      API programming guide
        Customizing Web Express Logon
          Approach 1: Replace the entire CMS with your own custom version of the servlet
            HTTP request parameters
            XML data response object
          Approach 2: Customize the existing CMS provided with Z and I Emulator for Web
            com.ibm.eNetwork.security.SSO.CMS.CMInterface
            com.ibm.eNetwork.security.sso.CMRequest
            com.ibm.eNetwork.security.sso.CMResponse
          Writing your own plug-ins
      Troubleshooting error messages
        Troubleshooting Web Express Logon
          Web Express Logon client-side messages
          Web Express Logon server-side messages
          DCAS error messages
      Recording the Web Express Logon macro
      Web Express Logon using the Configuration server-based model
      Password encryption tool
        Windows platforms
        Unix platforms
      Sample HCM plug-in
        Write the HCM plug-in.
        Update the web.xml file.
      Glossary of terms
        authentication type
        client certificate
        connection-based automation
        credential challenges
        Credential Mapper Servlet (CMS)
        Digital Certificate Access Server (DCAS)
        Enterprise Identity Mapping (EIM)
        full class path name
        Host Credential Mapper (HCM)
        host ID
        host mask
        Kerberos
        macro-based automation
        network ID
        Network Security plug-in
        Portal Server Credential Vault
        Resource Access Control Facility (RACF)
      Sources for more information
      Notices
      Trademarks
    Macro Programming Guide
      About this book
        About the other Z and I Emulator for Web documentation
        Conventions used in this book
      Macro basics
        Introduction
          Z and I Emulator for Web macros
            Definition of a macro
            Advantages of macros
            Unsophisticated users
            Sophisticated users
            Programming features
            Samples
          Deploying macros
          Using macros to integrate your enterprise applications
          ZIE Host Access Toolkit
          Macros and security
          This book focuses on 3270 applications
        Macro components
          Overview
          Macro Manager
            Macro Manager toolbar
            Macro Editor
            Code Editor
          Macro runtime
          Macro object
          Definitions of other terms
        Recording and playing back a simple macro
          Recording a simple macro
          Playing back a simple macro
          Assigning the macro to a key combination
        Macro structure
          Macro script
            XML elements
            Conceptual view of a macro script
            Introduction to the Macro tab
          The macro screen and its subcomponents
            Application screen
            Macro screen
            Conceptual view of a macro screen
            Introduction to the Screens tab
      Developing macros
        Data types, operators, and expressions
          Choosing a macro format
            The basic macro format versus the advanced macro format
            Representation of strings and special characters, treatment of operator characters
              In the basic macro format, rules for representation of strings, etc.
              In the advanced macro format, rules for representation of strings, etc.
            Converting your macro to a different format
              Converting your macro to the advanced macro format
              Converting your macro to the basic macro format
          Standard data types
            Boolean data
              Boolean values are not strings
            Integers
              Integer constants
            Doubles
            Strings
          Fields
          The value null
          Arithmetic operators and expressions
            Operators and expressions
            Where arithmetic expressions can be used
          String concatenation operator (+)
            Operators and expressions
          Conditional and logical operators and expressions
            Conditional expression can include complex terms
            Where conditional expressions can be used
          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
            Scenario used as an example
            Stages in processing a macro screen
            Closer look at stage 1
            Overview of the entire process (all 3 stages)
            Conclusion of the overview
          Stage 1: Determining the next macro screen to be processed
            Adding macro screen names to the list of valid next screens (step 1(a))
              Valid next screens
              How the macro runtime selects the names of candidate macro screens
                First macro screen
                Subsequent macro screens
                Transient screens
            Screen recognition (step 1(b))
              Overview of evaluation
              Re-doing the evaluation
              Determining whether a macro screen matches the application screen
              Two recognition features
                Timeout setting for screen recognition
                Recognition limit
            Removing the names of candidate macro screens from the list of valid next screens (step 1(c))
          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 and recognition
          Terms defined
          Introduction to the Description tab
            Sample Description tab
              Creating a new descriptor
          Recorded descriptions
            What information is recorded
            Why the recorded descriptions work
            Recorded descriptors provide a framework
          Evaluation of descriptors
            Practical information
            Overview of the process
            Evaluation of individual descriptors
            Default combining method
              When to use the default combining method
              Inverse Descriptor
              Optional
              Default combining rule
            The uselogic attribute
          The descriptors
            Overview
            Field Counts and OIA descriptor
              Required
              Presents three separate and independent descriptors as if one
              Treatment during screen recognition
              Wait for OIA to Become Uninhibited descriptor (<oia> element)
                Specifying a session
              Number of Fields descriptor (<numfields> element)
                Specifying a session
              Number of Input Fields descriptor (<numinputfields> element)
                Specifying a session
              Counting fields in the session window during macro development
            String descriptor (<string> element)
              Specifying the rectangular area
              How the macro runtime searches the rectangular area (Wrap option)
                Using an extracted string in a String descriptor
              The '*' string in a new String descriptor
              Easy method for filling in the parameters
              Multiple String descriptors in the same <description> element
              Specifying a session
            Cursor descriptor (<cursor> element)
              Specifying a session
            Attribute descriptor (<attrib> element)
              Specifying an attribute
              Specifying a session
            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
        Macro actions
          In general
            The actions by function
            How actions are performed
              The runtime context
              The macro screen context
            Specifying parameters for actions
          Introduction to the Actions tab
            Sample Actions tab
            Creating a new action
          The actions
            Box selection action (<boxselection> element)
              Specifying row and column values
              Erasing the marking rectangle
              Specifying a session
              Example
            Comm wait action (<commwait> element)
              How the action works
              Specify a communication status that is persistent
              Communication states
              Specifying a session
              Examples
            Conditional action (<if> element and <else> element)
              Specifying the condition
              Condition is True (<if> element)
              Condition is false (<else> element)
              Condition action not allowed within a Condition action
              Example
            Extract action (<extract> element)
              Capturing text
                Set the Continuous Extract option
                Specify the area of the session window
                Specify an extraction name
                Specify TEXT_PLANE as the data plane
                Specify the variable in which you want the text to be stored
              Treatment of nulls and other undisplayable characters
              Capturing a rectangular area of the session window
              Capturing a sequence of text from the session window
              Unwrap Text option
                When Unwrap Text is true and Continuous Extract is false
                When Unwrap Text is true and Continuous Extract is true
              Using the Toolkit to capture data from any data plane
              Specifying a session
            FileUpload action (<fileupload> element)
              Connecting with the database server
                Database URL
                Driver Identifier and Driver Class
                User ID and Password
              Specifying information for the file upload
                File Name and File Type
                Table Name
                Create
                Replace
                Append
                Update
              Preloading the database components for the Z and I Emulator for Web client
            Input action (<input> element)
              Location at which typing begins
              Input errors
              Input string
              Translate Host Action Keys
              Move Cursor to End of Input
              Password
                Automatic encryption during macro recording
                Using the Password checkbox
                Using the Code Editor
                Encrypting a variable name
              Specifying a session
              Example
            Message action (<message> element)
              Displaying the message caption and message text
            Mouse click action (<mouseclick> element)
              Specifying row and column
              Specifying a session
              Copy and paste example
            Pause action (<pause> element)
            Perform action (<perform> element)
              Invoking the method
              Examples
            PlayMacro action (<playmacro> element)
              Adding a PlayMacro action
              Target macro file name and starting screen
              Transferring variables
                Requirements for transferring variables
                Restriction
                Additional information
                When the target macro needs to import a type
              Examples
            Print actions (<print> element)
              Print Start
                Printer Setup and Page Setup
                Assign Return Code to a Variable
              Print Extract
                Specifying the area to be printed
                Assign Return Code to a Variable
                Specifying a session
              Print End
                Assign Return Code to a Variable
            Prompt action (<prompt> element)
              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 session window
              Assigning the input sequence to a variable
              The promptall attributes
              Specifying a session
            Run program action (<runprogram> element)
              Launching the native application
              Waiting for the native application to terminate
              Capturing the return code
              Example of launching a native application
            SQLQuery action (<sqlquery> element)
              Two sections: statement and results
              Using the SQL Wizard
              Importing an SQL statement
              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 global variable ($HMLSQLUtil$)
                Writing the data into a file
                Displaying the data
              Preloading the database components for the Z and I Emulator for Web client
            Trace action (<trace> element)
              Example
              User trace event
            Variable update action (<varupdate> element)
              Variable update action with a field variable
                Reading part of a field
            Xfer action (<filexfer> element)
              Basic parameters
              Advanced parameters
              Parameters for BIDI sessions (Arabic or Hebrew)
              Specifying a session
              Examples
        Screen Recognition, Part 2
          Valid next screens
          Entry screens, exit screens, and transient screens
            Entry screens
              Macro with several entry screens
              Entry screen can also be a normal screen
            Exit screens
            Transient screens
              Example of handling of transient screen
          Timeout settings for screen recognition
            Screen recognition
            Timeout Between Screens (Macro tab)
            Timeout (Links tab)
          Recognition limit (General tab of the Screens tab)
            Determining when the recognition limit is reached
            Action when the Recognition limit is reached
        Actions, Part 2: Timing issues
          Pause after an action
            Speed of processing actions
            Pause Between Actions (Macro tab)
            Set Pause Time (General tab of the Screens tab)
            Adding a pause after a particular action
          Screen completion
            Recognizing the next macro screen too soon
            The ordinary TN3270 protocol
            Solutions
              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
              ignorepauseoverride=true/false
              delayifnotenhancedtn=(milliseconds)
        Variables and imported Java classes
          Introduction to variables and imported types
            Advanced macro format required
            Scope of variables
            Introduction to the Variables tab
              Creating a new variable
              Creating an imported type for a Java class
          Issues you should be aware of
            Deploying Java libraries or classes
            Variable names and type names
            Transferring variables from one macro to another
            Field variables
          Using variables
            When variables are initialized
            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
          Passing a parameter list to a macro
            How the Z and I Emulator for Web processes a parameter list
            Specifying the parameter list
              Where to specify a parameter list
              Format of a parameter list
              Checking the parameter list for errors
              Specifying the parameter list from a program
            Considerations for the macro writer
            A parameter list does not initialize variables in a chained-to macro
          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 an method belonging to an HML library
            Variables 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()
            $HMLSystemUtil$
              Method details
                getHTMLParameter()
                getenv()
                  Limitations
                getSystemProperty()
                General Limitations
            FormatNumberToString() and FormatStringToNumber()
        Other security options
          Record password
            When Record Password is enabled
            When Record Password is disabled
        Other advanced features
          Interacting with more than one session
            Basics
            Implementation
            Two techniques for building macro screens
            Runtime processing
              Descriptors
                All descriptors apply to the same active session
                Some descriptors apply to a different active session
              Actions
            Run-time requirements
            Specifying a Host ID
              Using automatic editing features with other sessions
            Recording a macro that interacts with more than one session
              Storing the macro script
              One recorded macro screen refers to one session window
              Starting, stopping, and switching sessions
              The currently selected session
              Other active sessions
              More than one active recording
            Referring to different sessions in the same macro screen
            Disabling macro recording
        The graphical user interface
          Updating fields in the Macro Editor
            Using the session window
            Using the marking rectangle
            Using the session window's text cursor
            Error in specifying a string
          Using the Code Editor
            Copy and paste a script from this guide into the Code Editor
      The macro language
        Features of the macro language
          Use of XML
            XML syntax in the Z and I Emulator for Web macro language
            Code Editor
          Hierarchy of the elements
          Inserting comments into a macro script
            Format of comments
            Comment errors
            Examples of comments
          Debugging macro scripts with the <trace> element
          Using the ZIE Host Access Toolkit product with macros
        Macro language elements
          Specifying the attributes
            XML requirements
            Advanced format in attribute values
            Typed data
          <actions> element
            General
            Attributes
            XML samples
          <attrib> element
            General
            Attributes
            XML samples
          <boxselection> element
            General
            Attributes
            XML samples
          <comment> element
            General
              A better method for inserting comments
            Attributes
            XML samples
          <commwait> element
            General
            Attributes
            XML samples
          <condition> element
            General
            Attributes
            XML samples
          <create> element
            General
            Attributes
            XML samples
          <cursor> element
            General
            Attributes
            XML samples
          <custom> element
            General
            Attributes
            XML samples
          <customreco> element
            General
            Attributes
            XML samples
          <description> element
            General
            Attributes
            XML samples
          <else> element
            General
            Attributes
            XML samples
          <extract> element
            General
            Attributes
            XML samples
          <fileupload> element
            General
            Attributes
            XML samples
          <filexfer> element
            General
            Attributes
            XML samples
          <HAScript> element
            General
            Attributes
            XML samples
          <if> element
            General
            Attributes
            XML samples
          <import> element
            General
            Attributes
            XML samples
          <input> element
            General
            Attributes
            XML samples
          <message> element
            General
            Attributes
            XML samples
          <mouseclick> element
            General
            Attributes
            XML samples
          <nextscreen> element
            General
            Attributes
            XML samples
          <nextscreens> element
            General
            Attributes
            XML samples
          <numfields> element
            General
            Attributes
            XML samples
          <numinputfields> element
            General
            Attributes
            XML samples
          <oia> element
            General
            Attributes
            XML samples
          <pause> element
            General
            Attributes
            XML samples
          <perform> element
            General
            Attributes
            XML samples
          <playmacro> element
            General
            Attributes
            XML samples
          <print> element
            General
            Attributes
            XML samples
          <prompt> element
            General
            Attributes
            XML samples
          <recolimit> element
            General
            Attributes
            XML samples
          <runprogram> element
            General
            Attributes
            XML samples
          <screen> element
            General
            Attributes
            XML samples
          <sqlquery> element
            General
            Attributes
            XML samples
          <string> element
            General
            Attributes
            XML samples
          <trace> element
            General
            Attributes
            XML samples
          <type> element
            General
            Attributes
            XML samples
          <vars> element
            General
            Attributes
            XML samples
          <varupdate> element
            General
            Attributes
            XML samples
        Sample macro code
          Copy CICS transaction records into Excel spreadsheet or DB2 database
            Introduction
            Steps for running Excel sample (Windows only)
            Steps for running DB2 sample
      Additional information
        The default combining rule for multiple descriptors in one macro screen
          Statement of the rule
        Mnemonic keywords for the Input action
      Notices
      Trademarks
    Host Access Toolkit
      About this book
      Introducing the ZIE Host Access Toolkit
        Components of the ZIE Host Access Toolkit
        What's new in Z and I Emulator for Web Version 1.0
          New functions in Z and I Emulator for Web Version 1.0
        Where to go for more information
          Web sites
      Planning for the ZIE Host Access Toolkit
        Supported operating systems
        Disk space requirement
        Supported browsers
        Java Support
      Installing the ZIE Host Access Toolkit
      Introducing the ZIE Host Access Toolkit Application Programming Interfaces
        Introducing the Host Access Class Library
        Introducing the Host Access Beans
          Descriptions
          Events
          Accessibility Features
        Introducing Z and I Emulator for Web J2EE Connector
      Installing the iSeries Toolbox for Java
      Notices
        Trademarks
    Host Printing Reference
      About this book
      Conventions used in this book
      Introduction to Host Printing (3270)
      Creating a Printer Definition Table (3270)
      Understanding the Format of Printer Definition Files (3270)
      Introduction to Host Printing (5250)
      Introduction to Host Printing (VT)
      Printer Data Stream Information (3270)
      National Language Support
      Advanced Configuration Options (3270)
      Troubleshooting
      Associated Printer Sessions (3270)
      Printer Definition File Example (3270)
    Tutorials
      Customizing HTML templates
      Configuring the SSH client
      ZIE for Web on iSeries
    Troubleshooting and support
      Troubleshooting overview
      Troubleshooting checklist
      Troubleshooting tips for users
      Searching knowledge bases
        Web search
      Getting fixes
      Preparing to call HCL support
      Contacting support
    Online Help
      For Administrators
        ZIE License Manager
          Installing and Configuring the HCL ZIE License Manager
        Overview
          Planning for deployment
          Configuring ZIE for Web sessions
        Deployment Wizard
          Deployment Wizard welcome
          Configuration model
          Choose ZIE for Web Java Level
          Browser Independent ZIE for Web Clients
            ZIEWeb Launcher
          Client Settings
          Web Start Settings
          Preload Options
          Advanced Options
            HTML parameters
            Code base
            HTML templates
          File Name and Output Format
        HTML model
          Understanding the HTML model
          Benefits of the HTML-based model
          Configuring and managing sessions using the Deployment Wizard
            Configuring host sessions
            Disable Functions
            Sharing and reusing macros, keyboard and toolbar definitions (administrators)
        Configuration server model
          Understanding the configuration server model
          Configuration server-based model
          Managing users and groups
            Adding a group
            Enabling users to create accounts
            Adding a user
            Deleting a user or group
            Using the Directory Utility
          Configuring and managing sessions using the Administration Utility
            Configuring host sessions
            Disable Functions
            Sharing and reusing macros, keyboard and toolbar definitions
          LDAP
            Understanding directories
            Setting up and using LDAP
            Specifying the LDAP directory information
            Migrating to an LDAP directory
            Implications of migrating to LDAP
        Combined model
          Understanding the combined model
          Combined model
        Printing
          Printing from a host to a workstation (3270)
          Printing from a host to a workstation (5250)
          Compiling a printer definition table
          Printer Setup
        Transferring files
          Using FTP
          Using sftp (SSH File Transfer Protocol)
          Using host file transfer
        Java 1 and Java 2
          Planning for Java on the client
          Java 1
          Java 2
        Security and certificate management
          Server authentication
          Obtaining a server certificate
          Making server certificates available to clients
          Configuring clients to use SSH
          Configuring clients to use SSL
        Working with macros
          Using the Macro Editor
          Using the Macro Manager
          Creating and deploying server macro libraries for users
          Editing macro screen definitions
        Service manager
          Configuring the service manager
          Using the Redirector
            Introducing the Redirector
            Defining a host in the Redirector
            Changing a host defined to the Redirector
            Deleting a host from the Redirector
      Using sessions
        Starting a session
        Adding a session
        Copying a session
        Deleting a session
        Bookmarking a session
        Jumping between sessions
        Cut, Copy, Paste, and Entry Assist in a session
        Using Start PC Command (STRPCCMD) in a 5250 host session
      Configuring user sessions
        Sharing and reusing macros, keyboard and toolbar definitions
        Remapping the keyboard
        Specifying a key as repeating or non-repeating
        Changing host session colors
        Customize Toolbar
        Configuring clients to use SSH
        Configuring clients to use SSL
        Configuring to connect to the Redirector
        History file setup
        Configuring the Popup Keypad
        Configuring the Mouse Wheel
      Java 1 and Java 2
        Using Java 1
        Using Java 2
      Printing
        Printing a screen
        Changing margins, page orientation, and paper source
        Adding headers and footers
        Print Screen
        Print Screen Collection
        Printing from a 3270 host session
        Printing from a 5250 host session
        ZipPrint
      Transferring files
        Using FTP
        Using sftp (SSH File Transfer Protocol)
        Using host file transfer
        Changing transfer options
      Security and certificate management
        Client authentication
        Obtaining client certificates
        Changing a certificate password
        Viewing security information for an SSH session
        Viewing server certificate information
        Viewing or saving certificate information
      Managing macros
        Managing a macro
        Recording a macro
        Saving a macro to a personal macro library
        Playing a macro
        Changing a macro
        Editing a macro
        Deleting a macro
      National language support
        General national language support
          Adobe PDF file created by a 3270 printer session
          Definitions of some national language support terms
          Displaying national language characters correctly
          DBCS languages
          European languages
          Greek
          Turkish
          Unicode support for OS/400
          User-defined characters (UDCs)
        Bidirectional language support
        Hindi language support
        Thai language support