IBM Host Access Transformation Services: User's and Administrator's Guide

522 Pages·2015·3.42 MB·English

IBM Host Access Transformation Services
User's and Administrator's Guide
Version 9.5
SC27-5904-01
IBM Host Access Transformation Services
User's and Administrator's Guide
Version 9.5
SC27-5904-01
Note
Before using this information and the product it supports, be sure to read the general information under Appendix C,
“Notices,” on page 487.
Tenth Edition (November 2015)
© Copyright IBM Corporation 2003, 2015.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Contents
Chapter 1. Using Host Access Considerations and limitations for iPad devices 51
Considerations and limitations for Android
Transformation Services (HATS) . . . . 1
devices . . . . . . . . . . . . . . . 51
Understanding HATS key concepts and objects . . . 2
Understanding HATS application processing. . . . 8
Understanding HATS application development . . 10 Chapter 4. Developing and deploying
How do I know what version of HATS I have? . . 12 HATS rich client applications . . . . . 53
Gathering problem determination information . . . 12 Developing HATS rich client applications . . . . 54
Where can I find information about HATS?. . . . 12 Target platform specifics . . . . . . . . . . 55
Project contents . . . . . . . . . . . . 55
| Chapter 2. Migrating to HATS V9.5 . . . 15 Setting the compiler compliance level. . . . . 55
HATS migration . . . . . . . . . . . . . 15 HATS RCP Runtime Extension project . . . . . 56
Importing a HATS project . . . . . . . . 15 Working with HATS rich client projects . . . . . 57
Using the HATS Migration wizard. . . . . . 16 Copying resources between Web and rich client
Migrating HATS transformations . . . . . . 16 projects . . . . . . . . . . . . . . . 59
Special migration considerations . . . . . . 17 Exporting and importing HATS rich client
HATS for Host Publisher users . . . . . . . . 22 projects . . . . . . . . . . . . . . . 60
Migrating from Host Publisher Version 4 . . . 23 Testing HATS rich client applications . . . . . . 61
J2EE migration . . . . . . . . . . . . . 25 Configuring the target platform . . . . . . 61
Installing runtime plug-ins . . . . . . . . 62
Setting the default JRE. . . . . . . . . . 63
Chapter 3. Developing and deploying
Launching your project . . . . . . . . . 63
HATS Web applications . . . . . . . 27
Deploying HATS rich client applications. . . . . 65
Organizing HATS Web applications . . . . . . 28
Packaging an Eclipse client environment for
Moving HATS Web projects to a different .ear file 29
distribution . . . . . . . . . . . . . 65
Backing up your HATS projects . . . . . . . 30
Packaging for existing Eclipse clients (Eclipse
Exporting and importing HATS Web projects . . . 30
RCP, Lotus Notes, or Lotus Expeditor Client) . . 66
Exporting a Web project . . . . . . . . . 30
Updating plug-in and feature version numbers 76
Importing a Web project . . . . . . . . . 30
Administering HATS rich client applications . . . 76
Deploying HATS Web applications . . . . . . 31
Runtime environment . . . . . . . . . . . 77
Enabling the HATS runtime . . . . . . . . 31
Applications view . . . . . . . . . . . 77
Exporting your project as a Java EE application 32
Transformation view . . . . . . . . . . 79
Installing your application in a runtime
Workstation ID prompting . . . . . . . . 81
environment . . . . . . . . . . . . . 32
LU name prompting . . . . . . . . . . 81
Changes necessary in the runtime environment 34
Preferences . . . . . . . . . . . . . 81
Developing HATS applications for the Apache
HATS rich client considerations and limitations . . 84
Geronimo Server . . . . . . . . . . . . 36
Installing and configuring for Geronimo servers 36
Chapter 5. Modifying a HATS project 87
Considerations and limitations for Geronimo
Overview . . . . . . . . . . . . . . . 87
servers . . . . . . . . . . . . . . . 37
Connections . . . . . . . . . . . . . . 89
Developing HATS applications for Oracle WebLogic
Template . . . . . . . . . . . . . . . 89
Server . . . . . . . . . . . . . . . . 37
Rendering . . . . . . . . . . . . . . . 90
Installing and configuring for WebLogic servers 37
Default rendering . . . . . . . . . . . 90
Considerations and limitations for WebLogic
Global rules . . . . . . . . . . . . . 94
servers . . . . . . . . . . . . . . . 39
Text replacement . . . . . . . . . . . 97
| Developing HATS applications for IBM Bluemix
Components and widgets. . . . . . . . . 98
| Server . . . . . . . . . . . . . . . . 39
Toolbar RCP-only . . . . . . . . . . . 98
| Configuring Rational SDP for IBM Bluemix
Application keypad. . . . . . . . . . . 99
| server . . . . . . . . . . . . . . . 39
Host keypad . . . . . . . . . . . . . 99
| Considerations and limitations for IBM Bluemix
Operator information area . . . . . . . . 99
| Server . . . . . . . . . . . . . . . 40
DBCS . . . . . . . . . . . . . . . 101
| Developing HATS applications for Web Sphere
Events. . . . . . . . . . . . . . . . 101
| Application Server Liberty Porfile . . . . . . . 42
Screen event priority . . . . . . . . . . 101
| Considerations and limitations for WebSphere
Application events . . . . . . . . . . 102
| Application Server Liberty Profile . . . . . . 42
Other . . . . . . . . . . . . . . . . 105
Developing HATS applications for mobile devices 43
Keyboard support . . . . . . . . . . . 105
Considerations and limitations for mobile devices 43
© Copyright IBM Corp. 2003, 2015 iii
Client locale . . . . . . . . . . . . . 106 Insert Macro Key . . . . . . . . . . . 178
Connection parameter overrides . . . . . . 106 Insert Global Variable . . . . . . . . . 178
Asynchronous Update RCP-only . . . . . 109 Insert Operator Information Area Web-only 179
Automatic Disconnect and Refresh Web-only 109 Insert Host Keypad . . . . . . . . . . 179
Global variable overrides . . . . . . . . 115 Insert Application Keypad . . . . . . . . 179
Client settings . . . . . . . . . . . . 116 Insert All Host Components Web-only . . . 180
Macro Content Assistance . . . . . . . . 121 Insert Stored Screen Web-only . . . . . . 180
Portlet settings . . . . . . . . . . . . 121 Previewing transformations . . . . . . . . 180
Source . . . . . . . . . . . . . . . . 122 Host keypad . . . . . . . . . . . . . 181
Using HATS preferences. . . . . . . . . . 122
Use of other Rational SDP preferences . . . . . 127
Chapter 9. Component and widget
descriptions and settings . . . . . . 183
Chapter 6. Managing connections . . 129
Component and widget settings . . . . . . . 183
Creating a connection . . . . . . . . . . 129 Host component settings . . . . . . . . . 183
Connection editor . . . . . . . . . . . . 130 Command line . . . . . . . . . . . . 183
Overview. . . . . . . . . . . . . . 130 Dialog . . . . . . . . . . . . . . . 184
Basic . . . . . . . . . . . . . . . 130 ENPTUI . . . . . . . . . . . . . . 187
Advanced . . . . . . . . . . . . . 131 Field . . . . . . . . . . . . . . . 189
Printing . . . . . . . . . . . . . . 133 Function key . . . . . . . . . . . . 190
Screen Handling . . . . . . . . . . . 135 HTML DDS keyword Web-only . . . . . . 191
Security . . . . . . . . . . . . . . 137 Input field . . . . . . . . . . . . . 192
Pooling . . . . . . . . . . . . . . 139 Input field with hints. . . . . . . . . . 194
Macros . . . . . . . . . . . . . . 140 Item selection . . . . . . . . . . . . 196
User List . . . . . . . . . . . . . . 141 Light pen (attention) . . . . . . . . . . 197
Source . . . . . . . . . . . . . . . 142 Light pen (selection) . . . . . . . . . . 198
Selection list . . . . . . . . . . . . . 199
Chapter 7. Working with screen Subfile. . . . . . . . . . . . . . . 202
Table . . . . . . . . . . . . . . . 208
events . . . . . . . . . . . . . . 143
Table (field) . . . . . . . . . . . . . 210
Create a Screen Customization wizard . . . . . 143
Table (visual) . . . . . . . . . . . . 211
Create a Screen Combination wizard . . . . . 144
Text . . . . . . . . . . . . . . . 213
Editing screen events . . . . . . . . . . . 144
URL . . . . . . . . . . . . . . . 213
Overview. . . . . . . . . . . . . . 144
Widget settings . . . . . . . . . . . . . 214
Screen Recognition Criteria or Begin Screen . . 144
Button. . . . . . . . . . . . . . . 214
Rendering (screen combination only) . . . . 149
Button table . . . . . . . . . . . . . 216
Navigation (screen combination only) . . . . 149
Calendar Web-only . . . . . . . . . . 217
End Screen (screen combination only) . . . . 149
Check box . . . . . . . . . . . . . 223
Actions . . . . . . . . . . . . . . 150
Combo RCP-only . . . . . . . . . . 225
Global Rules. . . . . . . . . . . . . 161
Dialog . . . . . . . . . . . . . . . 228
Text Replacement . . . . . . . . . . . 162
Drop-down (data entry) . . . . . . . . . 229
Next Screen . . . . . . . . . . . . . 163
Drop-down (selection) . . . . . . . . . 232
Source . . . . . . . . . . . . . . . 164
Field . . . . . . . . . . . . . . . 234
Inhibited screens . . . . . . . . . . . . 164
Graph (horizontal bar, line, vertical bar) . . . 239
Recognition criteria . . . . . . . . . . 164
Label . . . . . . . . . . . . . . . 243
Automated handling of inhibited screens . . . 165
Link . . . . . . . . . . . . . . . 244
Handling multiple inhibited screens . . . . . 165
Link (item selection) . . . . . . . . . . 245
Importing BMS map sets . . . . . . . . . 166
List . . . . . . . . . . . . . . . . 247
Popup . . . . . . . . . . . . . . . 249
Chapter 8. Working with
Radio button (data entry) . . . . . . . . 254
transformations . . . . . . . . . . 169
Radio button (item selection) . . . . . . . 256
Create a Transformation wizard . . . . . . . 169
Radio button (selection) . . . . . . . . . 258
Editing transformations . . . . . . . . . . 171
Scrollbar (ENPTUI) . . . . . . . . . . 260
Editing transformations for Web projects . . . 171
Subfile (check box) . . . . . . . . . . 261
Editing transformations for rich client projects 174
Subfile (drop-down) . . . . . . . . . . 268
Transformation wizards . . . . . . . . . . 174
Subfile (popup). . . . . . . . . . . . 274
Insert Host Component . . . . . . . . . 174
Table . . . . . . . . . . . . . . . 281
Edit Host Component Web-only . . . . . 176
Text input . . . . . . . . . . . . . 286
Transform for Dojo Editing Web-only . . . . 176
Toolbar RCP-only . . . . . . . . . . 289
Insert Default Rendering . . . . . . . . 176
Widget settings (Dojo) . . . . . . . . . . 292
Edit Default Rendering Web-only . . . . . 176
HATS Dojo widget considerations and
Insert Tabbed Folder Web-only . . . . . . 177
limitations . . . . . . . . . . . . . 292
iv IBM Host Access Transformation Services: User's and Administrator's Guide
Combo box (Dojo) Web-only . . . . . . . 293 Chapter 15. Enabling print support 349
Date text box (Dojo) Web-only . . . . . . 295 Configuring the host print session on 3270 hosts 349
Enhanced grid (Dojo) Web-only . . . . . . 298 Defining print support for your project . . . . . 349
Filtering select (Dojo) Web-only . . . . . . 299 For 3270E connections . . . . . . . . . 349
Text box (Dojo) Web-only . . . . . . . . 301 For 5250 connections . . . . . . . . . . 352
Validation text box (Dojo) Web-only . . . . 302 Providing documentation for users . . . . . . 352
Component and widget mapping. . . . . . . 303
Chapter 16. Enabling keyboard
Chapter 10. Using templates . . . . . 307
support . . . . . . . . . . . . . . 355
Template examples . . . . . . . . . . . 307
Defining keyboard support . . . . . . . . . 355
Create a Template wizard . . . . . . . . . 310
Changing the appearance of the keypads . . . . 355
Editing templates . . . . . . . . . . . . 312
Providing documentation for users . . . . . . 356
Editing templates for Web projects . . . . . 312
Special 5250 field key support . . . . . . . 357
Editing templates for rich client projects . . . 316
Remapping the keyboard in a HATS application 359
Application keypad . . . . . . . . . . . 317
Concepts to understand before remapping
HATS keys . . . . . . . . . . . . . 359
Chapter 11. Macros and host terminal 319 Remapping keys for HATS Web applications 361
Macro Editor . . . . . . . . . . . . . 320 Remapping keys for HATS rich client
Overview. . . . . . . . . . . . . . 320 applications . . . . . . . . . . . . . 364
Prompts and Extracts. . . . . . . . . . 330 Adding additional keypad buttons to a
Source . . . . . . . . . . . . . . . 330 transformation . . . . . . . . . . . . 366
Working with macro errors . . . . . . . . . 331
Importing a macro . . . . . . . . . . . 331
Chapter 17. Using host simulation 367
Exporting a macro. . . . . . . . . . . . 332
Host simulation wizard . . . . . . . . . . 367
Macro hints and tips . . . . . . . . . . . 332
Host simulation editor . . . . . . . . . . 368
Preventing an infinite loop . . . . . . . . 332
Overview tab . . . . . . . . . . . . 368
Handling transient screens . . . . . . . . 332
Source tab . . . . . . . . . . . . . 369
Recording in the runtime environment . . . . . 369
Chapter 12. Interacting with global Playback options . . . . . . . . . . . . 369
variables . . . . . . . . . . . . . 333 Importing and exporting trace files . . . . . . 370
Renaming global variables . . . . . . . . . 334
Differences between global variables and macro Chapter 18. Using HATS
variables . . . . . . . . . . . . . . . 335
administrative console . . . . . . . 371
Global variables . . . . . . . . . . . 335
HATS administrative console and WebSphere
Macro variables . . . . . . . . . . . 335
security . . . . . . . . . . . . . . . 371
HATS administrative console roles . . . . . . 373
Chapter 13. Using Integration Objects 337 Starting HATS administrative console . . . . . 374
Creating an Integration Object . . . . . . . . 337 Starting the administrative console while in
Integration Object chaining . . . . . . . . . 338 HATS Toolkit . . . . . . . . . . . . 375
Deciding when to use Integration Object Using the functions in HATS administrative
chaining . . . . . . . . . . . . . . 339 console . . . . . . . . . . . . . . . 375
Using Integration Object chaining . . . . . 339 Selecting management scope . . . . . . . 375
Debugging applications that use Integration Managing licenses . . . . . . . . . . . 376
Object chaining. . . . . . . . . . . . 341 Monitoring connections . . . . . . . . . 376
Building Web pages from an Integration Object . . 342 Monitoring connection pools . . . . . . . 376
Create Model 1 Web pages . . . . . . . . 342 Monitoring pool definitions . . . . . . . 377
Create Struts Web pages . . . . . . . . . 343 Monitoring user lists and user list members . . 377
Create JSF Web pages . . . . . . . . . 344 Administering problem determination
BasicIOErrorPage.jsp and components . . . . . . . . . . . . . 377
AdvancedIOErrorPage.jsp . . . . . . . . . 345 Display terminal functions . . . . . . . . . 380
Working with Integration Objects on JSPs . . . . 345 Using display terminal for testing and
Insert Integration Object Properties . . . . . 345 debugging . . . . . . . . . . . . . 380
Insert Forward to HATS Application . . . . 346
Chapter 19. WebSphere Portal and
Chapter 14. Combining screens . . . 347
HATS . . . . . . . . . . . . . . . 383
Combining contiguous output data . . . . . . 347
Creating HATS portlets . . . . . . . . . . 383
Combining noncontiguous output data . . . . . 347
Creating a new HATS portlet project . . . . 383
Combining output from multiple applications . . 347
Generating portlets from HATS Web projects 384
Combining input for multiple screens . . . . . 348
Working with HATS portlets . . . . . . . . 386
Contents v
Connection parameter and global variable Working with the host terminal . . . . . . . 434
overrides . . . . . . . . . . . . . . 386 Host terminal limitations . . . . . . . . 435
Portlet communication . . . . . . . . . 387 Capturing screens . . . . . . . . . . . 436
Custom PDTs and custom tables . . . . . . 390 Recognizing bidirectional host components . . . 436
Web Services for Remote Portlets . . . . . . 390 Controlling the orientation of widgets . . . . . 437
Testing HATS portlets . . . . . . . . . . 390 Controlling the alignment of widgets . . . . . 438
Exporting HATS portlets . . . . . . . . . 390 Customized components and widgets bidirectional
Administering HATS portlets . . . . . . . . 391 support . . . . . . . . . . . . . . . 438
Using a stand-alone HATS administrative Global variables . . . . . . . . . . . . 438
application . . . . . . . . . . . . . 391 Text replacement . . . . . . . . . . . . 439
HATS portlet considerations and limitations . . . 392 Global rules . . . . . . . . . . . . . . 439
Common considerations and limitations . . . 392 Enabling the user to reverse the screen direction 440
VT bidirectional display options . . . . . . . 440
Macro prompt and extract bidirectional options 441
Chapter 20. WebFacing and HATS . . 395
Macro SQL query bidirectional options . . . . . 441
HATS interaction with WebFacing . . . . . . 395
Right-To-Left printing support. . . . . . . . 442
HATS connection to a WebFacing server . . . 395
BMS map support . . . . . . . . . . . . 443
HATS interoperability with WebFacing
Integration Object support . . . . . . . . . 443
applications . . . . . . . . . . . . . 396
Support of bottom-up Web services . . . . . . 444
Support of RESTful Web services . . . . . . . 445
Chapter 21. Security and Web Express
Portlet support . . . . . . . . . . . . . 445
Logon . . . . . . . . . . . . . . 399
Information for users . . . . . . . . . . . 445
Enabling SSL security . . . . . . . . . . 399
Auto field reverse . . . . . . . . . . . 446
Enabling SSH security . . . . . . . . . . 401
Field reverse . . . . . . . . . . . . 446
Using Web Express Logon (WEL). . . . . . . 402
Clipboard functions . . . . . . . . . . 447
Overview. . . . . . . . . . . . . . 402
Operator information area (OIA) . . . . . . 447
Architecture . . . . . . . . . . . . . 402
Automatic keyboard layer switching . . . . 447
Planning for implementation . . . . . . . 404
IBM i 5250 Unicode support . . . . . . . . 447
Implementation . . . . . . . . . . . 404
Functions for Arabic code pages . . . . . . . 447
How to create a WEL logon macro . . . . . 405
HATS Toolkit screen orientation . . . . . . 448
Network Security plug-in . . . . . . . . 406
Customizing the direction for JSP pages . . . 448
Credential Mapper plug-ins . . . . . . . 406
Shaping direction . . . . . . . . . . . 448
Initialization parameters . . . . . . . . . 408
Arabic selective shaping . . . . . . . . . 449
Create SSL keystore file (DCAS only) . . . . 413
Symmetric and numeric swapping . . . . . 449
Using Kerberos service tickets . . . . . . . . 415
Disable entry of Arabic-Western digits . . . . 449
Java 2 security . . . . . . . . . . . . . 415
Automatic keyboard layer switching . . . . 449
Policy file . . . . . . . . . . . . . 416
Host terminal limitations . . . . . . . . 449
Using IBM Certificate Management for HATS
Screen captures . . . . . . . . . . . . 450
applications . . . . . . . . . . . . . . 416
Setting Arabic printing sessions on System i
Creating a key database file . . . . . . . 416
Access for Web . . . . . . . . . . . . 450
Requesting and storing certificates from
Other considerations . . . . . . . . . . 451
Certificate Authorities . . . . . . . . . 417
Additions to HATS files . . . . . . . . . . 451
Using a self-signed certificate . . . . . . . 419
Exchanging certificates . . . . . . . . . 420
Chapter 24. Double-byte character set
Certificate Management tool considerations . . 420
support . . . . . . . . . . . . . . 453
DBCS and SBCS field support . . . . . . . . 453
Chapter 22. Language support . . . . 423
Data type checking . . . . . . . . . . . 454
Language codes . . . . . . . . . . . . 423
Field length checking. . . . . . . . . . . 454
Code pages . . . . . . . . . . . . . . 424
Copy-and-paste prevention . . . . . . . . . 454
Encoding settings . . . . . . . . . . . . 426
Input Method Editor (IME) . . . . . . . . . 454
5250 Unicode support . . . . . . . . . . 427
AutoIME switching . . . . . . . . . . . 455
Using accented characters for code page 937 . . . 427
Shift Out/Shift In considerations . . . . . . . 455
Using code page 1388 (GB18030) . . . . . . . 427
Other considerations . . . . . . . . . . . 455
Host code mapping for code pages 1390 and 1399 428
Project theme settings . . . . . . . . . 455
JIS2004 support. . . . . . . . . . . . 428
Project settings editor. . . . . . . . . . 455
Remapping keyboard and display characters . . . 431
Screen event editor . . . . . . . . . . 458
Priority of character replacement . . . . . . 431
Host components . . . . . . . . . . . 458
Widgets . . . . . . . . . . . . . . 458
Chapter 23. Bidirectional application
Macro support . . . . . . . . . . . . 459
support . . . . . . . . . . . . . . 433 Creating an Integration Object . . . . . . . 460
Software environment . . . . . . . . . . 434 Working with mobile device applications . . . 460
vi IBM Host Access Transformation Services: User's and Administrator's Guide
Remapping keyboard and display characters 460 Performance impact of using contention
Working with user-defined characters . . . . 460 resolution . . . . . . . . . . . . . 479
Determining contention resolution status . . . 480
Automatic refresh . . . . . . . . . . . . 481
Appendix A. Runtime properties files 465
Transient screen handling . . . . . . . . . 481
Tracing options . . . . . . . . . . . . . 468
Initial blank screen handling settings . . . . . 482
Host On-Demand tracing . . . . . . . . . 470
Related HATS settings . . . . . . . . . . 483
Host simulation tracing . . . . . . . . . . 472
Tuning HATS screen-settling . . . . . . . . 484
References . . . . . . . . . . . . . . 485
Appendix B. HATS screen-settling
Contention resolution information . . . . . 485
reference . . . . . . . . . . . . . 473
Advanced Macro Guide . . . . . . . . . 486
Screen-settling overview. . . . . . . . . . 473
Screen-settling procedure . . . . . . . . . 473
Appendix C. Notices . . . . . . . . 487
Analyzing outbound data . . . . . . . . . 474
Programming interface information . . . . . . 488
Waiting for OIA flags. . . . . . . . . . . 476
Trademarks . . . . . . . . . . . . . . 489
Changing customization settings . . . . . . . 477
Determining which strategy HATS is using . . . 478
Glossary . . . . . . . . . . . . . 491
Contention resolution (TN3270E only) . . . . . 478
Contention resolution using z/OS
Communications Server . . . . . . . . . 478 Index . . . . . . . . . . . . . . . 499
Contention resolution using other
Communications Servers . . . . . . . . 479
Contents vii
viii IBM Host Access Transformation Services: User's and Administrator's Guide