Personal Communications Administrator's Guide and Reference

396 Pages·2002·2.89 MB·English

Personal Communications for Windows, Version 5.6
Administrator’s Guide and Reference
SC31-8840-01
Personal Communications for Windows, Version 5.6
Administrator’s Guide and Reference
SC31-8840-01
Note
Before using this information and the product it supports, read the information in Appendix E, “Notices” on page 367.
Second Edition (September 2002)
This edition applies to Version 5.6 of IBM Personal Communications (program number: 5639–I70) and to all
subsequent releases and modifications until otherwise indicated in new editions.
© Copyright International Business Machines Corporation 1989, 2002. All rights reserved.
US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract
with IBM Corp.
Contents
Figures . . . . . . . . . . . . . . . ix Configuring to Perform 3270 and 5250 Emulation to
Multiple Hosts . . . . . . . . . . . . . 30
Tables . . . . . . . . . . . . . . . xi
Chapter 5. Attachment Considerations
About This Book . . . . . . . . . . xiii and Adapter Setup Information . . . . 35
Who Should Read This Book . . . . . . . . xiii Attachment Information . . . . . . . . . . 35
How to Use This Book . . . . . . . . . . xiii COAX Attachment . . . . . . . . . . . 35
Command Syntax Symbols . . . . . . . . xiii LAN via IEEE 802.2 Attachment . . . . . . 36
Where to Find More Information . . . . . . . xiv TCP/IP Connection. . . . . . . . . . . 36
Online Help . . . . . . . . . . . . . xiv SDLC MPA Attachment . . . . . . . . . 38
Messages and Alerts . . . . . . . . . . xiv IBM Global Network - SNA over Async
Personal Communications Library. . . . . . xv Attachment . . . . . . . . . . . . . 39
IBM Global Network Connection Attachment . . 39
Home3270 Attachment . . . . . . . . . 40
Part 1. General Information . . . . . 1 3270 Attachment via the AS/400 System. . . . 41
IBM PC720 Modem Initialization (Japan Only). . 41
Chapter 1. Personal Communications 3174 Peer Communications Support (LAN over
Highlights . . . . . . . . . . . . . . 3 Coax) . . . . . . . . . . . . . . . 41
5250 Twinaxial Console . . . . . . . . . 42
Twinax Connections Through a 5494 Controller
Chapter 2. Problem Analysis . . . . . . 9
to an AS/400 . . . . . . . . . . . . . 43
Log Viewer . . . . . . . . . . . . . . . 9
5250 Asynchronous Console . . . . . . . . 43
Trace Facility . . . . . . . . . . . . . . 9
Adapter Setup Information . . . . . . . . . 44
Information Bundler . . . . . . . . . . . 10
Creating and Updating Devices in Windows 2000
Internet Service . . . . . . . . . . . . . 11
and XP . . . . . . . . . . . . . . . 44
Checking for APARs and CSDs . . . . . . . . 11
Using Coax (3270) Adapters . . . . . . . . 44
Connection Configuration . . . . . . . . 12
Twinax Adapters . . . . . . . . . . . 46
APARs . . . . . . . . . . . . . . . 12
MPA Adapters . . . . . . . . . . . . 48
Interim Service Builds . . . . . . . . . . 15
WAC Attachments . . . . . . . . . . . 50
Corrective Service Distributions . . . . . . 15
OEM Adapters . . . . . . . . . . . . 51
Detect and Repair . . . . . . . . . . . . 15
Chapter 6. Tivoli Support . . . . . . . 53
Part 2. Advanced Configuration, Remote Installation of Personal Communications
Management, and Operations . . . 17 Using Tivoli Courier . . . . . . . . . . . 53
IBMPCOMM Plus Module for Personal
Communications . . . . . . . . . . . . 54
Chapter 3. Advanced Configuration . . 19
Task Administration . . . . . . . . . . . 54
Configuration Files . . . . . . . . . . . . 19
Plus Module Administrative Tasks. . . . . . 55
Initial Configuration Definitions . . . . . . 19
Personal Communications Administrative Tasks 55
Using Template and Update Files . . . . . . 20
Event Management . . . . . . . . . . . . 58
Automatic Device Name Generation (5250 Only) . . 23
Personal Communications Events . . . . . . 59
Substitution Characters . . . . . . . . . 24
Event Management Tasks. . . . . . . . . 60
Client Naming Function . . . . . . . . . 24
Event Rules . . . . . . . . . . . . . 61
Device Name Collision Processing . . . . . . 25
Event Adapter . . . . . . . . . . . . 62
Support for Systems Policies. . . . . . . . . 25
® Software Distribution . . . . . . . . . . . 63
Support for Management by Tivoli . . . . . . 25
Distribute and Install Personal Communications 64
Commands for Emulator Functions . . . . . . 25
Distribute the SNA Node Configuration Files . . 64
Start a Personal Communications Session . . . 26
Distribute the Emulator Configuration Files . . 64
Stop a Personal Communications Session . . . 26
Signature (Inventory) Information . . . . . . . 65
Query Personal Communications Sessions . . . 27
Chapter 7. System Policy Support . . . 67
Chapter 4. Configuring Multiple Links 29
Configuration Policy . . . . . . . . . . . 68
Configuring a Second 3270 Emulation Link . . . . 29
Communication Configuration . . . . . . . 68
Configuring a Second 5250 Emulation Link . . . . 29
Menu Configuration . . . . . . . . . . 68
Configuring a Second Link of a Different Kind . . 30
Toolbar Configuration . . . . . . . . . . 69
© Copyright IBM Corp. 1989, 2002 iii
Multiple Sessions Configuration . . . . . . 70 Opening a key database . . . . . . . . . 97
Keyboard Configuration . . . . . . . . . 70 Showing the default key in a key database . . . 97
Mouse Configuration . . . . . . . . . . 71 Using GSK6CMD batch file . . . . . . . . 98
Change Directory . . . . . . . . . . . 71 Summary of Command-Line Invocations . . . 98
Import . . . . . . . . . . . . . . . 72
Execution Policy . . . . . . . . . . . . . 72 Chapter 9. ODBC Drivers and
Dynamic Menu Modification . . . . . . . 72
Database Access Utility . . . . . . . 101
Java Applet . . . . . . . . . . . . . 73
Overview of Open Database Connectivity (ODBC) 101
Macro Play/Record. . . . . . . . . . . 73
Components of ODBC . . . . . . . . . 102
Start Session . . . . . . . . . . . . . 73
Database Access Utility . . . . . . . . . . 103
Delete Session . . . . . . . . . . . . 73
Accessing an ODBC Data Source . . . . . . 103
Product Update . . . . . . . . . . . . 74
Database Size Limit . . . . . . . . . . 105
File Transfer . . . . . . . . . . . . . 74
Detect and Repair . . . . . . . . . . . 74
Chapter 10. Express Logon Feature 107
Installation Policy . . . . . . . . . . . . 74
Using Express Logon . . . . . . . . . . . 107
Preparing to Configure the Express Logon Feature 107
Chapter 8. Configuring and Using SSL
Configuring Express Logon. . . . . . . . . 108
Security for Personal Communications . 77
Recording the Macro . . . . . . . . . . 108
What is SSL? . . . . . . . . . . . . . . 77
Manual Configuration of an ELF Macro . . . 108
Preparation for SSL Communication . . . . . . 77
Limitations of the Logon Macro . . . . . . 108
Server and Related Client Configuration. . . . 77
Problem Determination . . . . . . . . . . 109
Client Configuration . . . . . . . . . . 78
Establishing an SSL-Based Session . . . . . . . 79
Part 3. SNA and AnyNet Topics 111
Secure Session Icon . . . . . . . . . . . 79
Configuring Personal Communications for SSL
Support . . . . . . . . . . . . . . . 80 Chapter 11. SNA Client/Server
Host Definition . . . . . . . . . . . . 80 Concepts . . . . . . . . . . . . . 113
Automatic Host Location . . . . . . . . . 80
Terminology . . . . . . . . . . . . . . 113
Advanced Security Setup . . . . . . . . . 81
APPC Concepts. . . . . . . . . . . . . 113
Pop-up Messages . . . . . . . . . . . . 82
Introducing APPC and CPI-C . . . . . . . 114
Changing the Password of a Client’s Key Database 82
What Is a Transaction Program? . . . . . . 114
Using Certificate Wizard . . . . . . . . . 83
What Is the Difference between APPC and
Using Certificate Management . . . . . . . 83
APPN? . . . . . . . . . . . . . . 115
Configuring SSL for Connecting to a Server Using a
Side Information Definitions . . . . . . . 115
Certificate from a Well-Known CA . . . . . . 83
Improving Productivity Using APPC . . . . 116
Configuring SSL for Connecting to a Server Using a
Improving Productivity Using CPI-C . . . . 116
Certificate from an Unknown CA . . . . . . . 84
What Is a Logical Unit? . . . . . . . . . 116
Opening a Key Database and Adding a Root
LU Types . . . . . . . . . . . . . . 117
Certificate . . . . . . . . . . . . . . 84
Dependent and Independent LUs. . . . . . 117
Opening a Key Database and Adding a Personal
What Is a Session?. . . . . . . . . . . 117
Certificate . . . . . . . . . . . . . . 85
What Is a Conversation?. . . . . . . . . 118
Obtaining a Personal ID Certificate from a
A Conversation between Two TPs . . . . . 119
Known Certificate Authority (CA) . . . . . . 86
Parallel Sessions between LUs . . . . . . . 119
Configuring SSL for Connecting to a Server Using a
SNA Communications . . . . . . . . . . 119
Self-Signed Certificate . . . . . . . . . . . 87
SNA Node Operations . . . . . . . . . . 120
Security References . . . . . . . . . . . . 87
Problem Determination . . . . . . . . . . 87
Chapter 12. AnyNet SNA over TCP/IP 121
Smart Card Support . . . . . . . . . . . 88
What Does AnyNet SNA over TCP/IP Do? . . . 121
Enabling Smart Card Support . . . . . . . 88
Running APPC or CPI-C Applications over a
Using the IKEYCMD Command-Line Interface . . 89
TCP/IP Network . . . . . . . . . . . 121
Environment Setup for IKEYCMD
Using AnyNet to Connect SNA Applications on
Command-Line Interface . . . . . . . . . 89
Different Platforms . . . . . . . . . . 121
IKEYCMD Command Line Syntax . . . . . . 90
Chaining Gateways to Connect Multiple SNA
IKEYCMD Tasks for Personal Communications 92
and IP Networks . . . . . . . . . . . 122
Creating a new key database . . . . . . . 93
5250 Emulation over a TCP/IP Network . . . 123
Creating a new key pair and certificate request 94
APPC3270 Emulation over a TCP/IP Network 123
Creating a self-signed certificate . . . . . . 95
3270 Emulation via DLUR over a TCP/IP
Exporting keys . . . . . . . . . . . . 95
Network . . . . . . . . . . . . . . 124
Importing keys . . . . . . . . . . . . 96
Listing CAs . . . . . . . . . . . . . 96
Storing the CA certificate . . . . . . . . . 96
iv Personal Communications Administrator’s Guide and Reference
3270 Emulation over a TCP/IP Network via an IBM Simplified Chinese Character Set, GBK
®
SNA Gateway to a VTAM Host on an SNA Code . . . . . . . . . . . . . . . 154
Network . . . . . . . . . . . . . . 124 IBM Hangeul Character Set. . . . . . . . 154
3270 Emulation over a TCP/IP Network via an Thai Language Support . . . . . . . . . 155
SNA Gateway to a VTAM Host on an APPN
Network . . . . . . . . . . . . . . 125 Chapter 15. Bidirectional Language
3270 Emulation via an SNA Gateway over a
Support (Arabic and Hebrew) . . . . 157
TCP/IP Network . . . . . . . . . . . 125
Considerations for Printing . . . . . . . . . 157
How Does SNA over TCP/IP Work? . . . . . 126
Printing in Arabic . . . . . . . . . . . 157
Mapping SNA Resources to IP Addresses . . . . 127
DAT File for 5250 Arabic . . . . . . . . 157
Defining Domain Names and IP Addresses . . . 128
Bidirectional Arabic Support . . . . . . . . 158
Defining Unique CP Names and Connection
Limitations . . . . . . . . . . . . . 158
Network Names . . . . . . . . . . . . 129
Installation Tips . . . . . . . . . . . 158
Setting and Modifying the Routing Preference
Bidirectional Keyboard Functions for 3270 . . . 158
Protocol . . . . . . . . . . . . . . . 130
Arabic Character Shape Selection Functions . . 160
Helpful Hints . . . . . . . . . . . . . 131
Personal Communications AS/400 . . . . . 161
Tuning . . . . . . . . . . . . . . 131
Bidirectional Hebrew Support . . . . . . . . 162
Connecting to AS/400 . . . . . . . . . 131
Bidirectional Functions for 3270 . . . . . . 162
Dynamic IP Addresses . . . . . . . . . 131
Keyboard Layout . . . . . . . . . . . 164
AnyNet Configuration Examples . . . . . . . 132
Configuration . . . . . . . . . . . . 164
Example 1. 5250 Emulation Over a TCP/IP
Font . . . . . . . . . . . . . . . 165
Network . . . . . . . . . . . . . . 132
File Transfer With 862 Code Page. . . . . . 165
Example 2. Running APPC or CPI-C
Bidirectional Functions for 5250 . . . . . . 165
Applications over a TCP/IP Network . . . . 133
Bidirectional Support for VT . . . . . . . . 166
Example 3. APPC3270 Emulation over a TCP/IP
Configuring VT Emulation for Arabic or
Network . . . . . . . . . . . . . . 134
Hebrew . . . . . . . . . . . . . . 166
Example 4. 3270 Emulation via DLUR over a
File Transfer . . . . . . . . . . . . . 166
TCP/IP Network . . . . . . . . . . . 135
Copy and Paste . . . . . . . . . . . 167
Example 5. 3270 Emulation over a TCP/IP
Print Screen . . . . . . . . . . . . . 167
Network via a SNA Gateway to a VTAM Host
Remapping BiDi Keys . . . . . . . . . 167
on a SNA Network . . . . . . . . . . 137
Bidirectional Functions for VT . . . . . . . 167
Example 6. 3270 Emulation via an SNA
Arabic Support for ASMO 449 7-bit Code Page 168
Gateway over a TCP/IP Network . . . . . 138
Example 7. 3270 Emulation over a TCP/IP
Chapter 16. Unicode Support . . . . 169
Network via an AnyNet SNA/IP Gateway to a
1390/1399 Code Pages . . . . . . . . . . 169
VTAM Host on an APPN Network . . . . . 139
Hindi Support . . . . . . . . . . . . . 170
Example 8. 3270 Emulation from a Windows NT
Workstation and a Windows 95 Workstation on
Different IP Networks . . . . . . . . . 140 Part 5. Building a Printer Definition
Table (PDT) . . . . . . . . . . . 173
Part 4. National Language Support 143
Chapter 17. Building a Printer
Chapter 13. Multiple-Language Definition Table (PDT) for PC/3270 . . 175
Support . . . . . . . . . . . . . . 145 ASCII_PASSTHRU? and EBCDIC_PASSTHRU? . . 175
Overview. . . . . . . . . . . . . . . 145 Supplemental Explanation of PDF Statements for
System Locale . . . . . . . . . . . . 145 PC/3270 . . . . . . . . . . . . . . . 175
Language Groups . . . . . . . . . . . 145 SCS TAB Setting . . . . . . . . . . . . 177
Personal Communications User Interface Printer Color Mixing . . . . . . . . . . . 177
Languages . . . . . . . . . . . . . . 146 Printer Session Data Stream Support . . . . . 177
Multiple Sessions . . . . . . . . . . . . 147 3270 Data Stream . . . . . . . . . . . 178
Other Considerations . . . . . . . . . . . 147 SCS Data Stream . . . . . . . . . . . 179
Delimiting Print Jobs . . . . . . . . . . . 180
Chapter 14. Country Codes and Structured Fields . . . . . . . . . . . . 181
Begin/End of File Query Reply . . . . . . 181
Character Sets . . . . . . . . . . . 149
Begin/End of File Structured Fields . . . . . 181
Keyboard Country ID and Shift Support . . . . 150
IBM Japanese Character Set (2-Byte Codes) . . . 152
Chapter 18. Building a Printer
Character Types . . . . . . . . . . . 152
Character Size . . . . . . . . . . . . 152 Definition Table (PDT) for PC400 . . . 185
IBM Kanji Codes . . . . . . . . . . . 152 Using the Printer Definition Table (PDT) File . . . 185
IBM Traditional Chinese Character Set . . . . 153 Printer Definition File (PDF File) Format . . . . 185
Contents v
Macro Definitions . . . . . . . . . . . 185 AS/400 System Mode Description . . . . . . 295
Formatting Controls . . . . . . . . . . 187 AS/400 Device Description for Twinaxial
Transparent Print Capability . . . . . . . . 189 Attachments (APPC) Example . . . . . . . . 296
ASCII_PASSTHRU? Keyword Support . . . . 189 AS/400 Device Description for Asynchronous
EBCDIC_PASSTHRU? Keyword Support . . . 190 Attachment Example . . . . . . . . . . . 297
EBCDIC_xx Keyword Support. . . . . . . 190 AS/400 VT Asynchronous Attachment Example 301
Printer Definition Tables. . . . . . . . . . 191 AS/400 Configuration for SDLC Example . . . . 303
Example Printer Definition Files . . . . . . . 191 Network Attributes . . . . . . . . . . 303
IBM4019.PDF File Contents. . . . . . . . 191 SDLC Leased Configuration . . . . . . . . 304
IBM5577.PDF File Contents. . . . . . . . 199 Creating an SDLC Line Description . . . . . 304
Field Names of Printer Definition Files . . . . . 201 SDLC Controller Description . . . . . . . 306
Symbols of Printer Definition Files . . . . . . 208 SDLC Switched Configuration . . . . . . . . 307
Using Printer Control Codes . . . . . . . . 213 SDLC Line Description . . . . . . . . . 307
Printer Control Code Format . . . . . . . 213 SDLC Controller Description . . . . . . . 309
Parameter Definition of Printer Control Codes 213 LAN Configuration Example . . . . . . . . 310
Supported Control Codes . . . . . . . . 214 LAN Controller Description . . . . . . . 311
Supported SCS Commands . . . . . . . . 214
Programming Notes . . . . . . . . . . 217 Appendix C. Host Code Page Tables 313
Restrictions and Notes for AS/400 Printer
Host Code Page 037-1/697-1 Brazil, Canada,
Commands and Printer Setup . . . . . . . 217
Netherlands, Portugal, U.S., and 037/1175
PFT Migration Utility. . . . . . . . . . . 222
Traditional Chinese . . . . . . . . . . . 314
Using the PFT Migration Utility . . . . . . 222
Host Code Page 273-1/697-1 Austria, Germany . . 315
Details of Migration . . . . . . . . . . 223
Host Code Page 275-1/697-1 Brazil . . . . . . 316
Host Code Page 277-1/697-1 Denmark, Norway 317
Part 6. Appendixes . . . . . . . . 247 Host Code Page 278-1/697-1 Finland, Sweden . . 318
Host Code Page 280-1/697-1 Italy . . . . . . 319
Host Code Page 284-1/697-1 Latin America, Spain 320
Appendix A. Keyboard Layouts. . . . 249
Host Code Page 285-1/697-1 United Kingdom . . 321
Local Edit Keys. . . . . . . . . . . . . 250
Host Code Page 290 Japan (Katakana) Extended 322
Keyboard Layouts . . . . . . . . . . . . 251
Host Code Page 297-1/697-1 France . . . . . . 323
Enhanced Keyboard, Microsoft Natural
Host Code Page 420 Arabic Bilingual . . . . . 324
Keyboard (3270 Only) . . . . . . . . . 255
Host Code Page 424/941 Israel (Hebrew - Bulletin
Enhanced Keyboard, Microsoft Natural
Code) . . . . . . . . . . . . . . . . 325
Keyboard (5250 Only) . . . . . . . . . 257
Host Code Page 500-1/697-1 International . . . . 326
Enhanced Keyboard, Microsoft Natural
Host Code Page 803 Israel (Hebrew - Old Code) 327
Keyboard (Combined 3270 and 5250) . . . . 259
Host Code Page 833/1173 Hangeul . . . . . . 328
Enhanced Keyboard, Microsoft Natural
Host Code Page 836/1174 Simplified Chinese . . 329
Keyboard (VT Keyboard Layout) . . . . . . 261
Host Code Page 870/959 Latin 2 - EBCDIC
Enhanced Keyboard, Microsoft Natural
Multilingual . . . . . . . . . . . . . . 330
Keyboard (VT Local Edit Mode Only) . . . . 263
Host Code Page 871-1/697-1 Iceland . . . . . 331
Space-Saving Keyboard (3270 Only) . . . . . 265
Host Code Page 875 Greece . . . . . . . . 332
Space-Saving Keyboard (5250 Only) . . . . . 267
Host Code Page 924-1/1353-1 International . . . 333
Space-Saving Keyboard (Combined 3270 and
Host Code Page 1025/1150 Cyrillic . . . . . . 334
5250) . . . . . . . . . . . . . . . 269
Host Code Page 1026/1152 Latin 5 - Turkey . . . 335
5576-001 (3270 Only) . . . . . . . . . . 271
Host Code Page 1027/1172 Japan (Latin) Extended 336
5576-001 (5250 Only) . . . . . . . . . . 273
Host Code Page 1047/103 Latin 1 (Open Systems) 337
5576-001 (Combined 3270 and 5250) . . . . . 275
Host Code Page 1112/1035 Latvia, Lithuania . . . 338
5576-A01 (3270 Only). . . . . . . . . . 277
Host Code Page 1122/1037 Estonia . . . . . . 339
5576-A01 Keyboard (5250 Only) . . . . . . 279
Host Code Page 1123 Ukraine . . . . . . . . 340
5576-A01 Keyboard (Combined 3270 and 5250) 281
Host Code Page 1130 Vietnam. . . . . . . . 341
5576-002/003 (3270 Only) . . . . . . . . 283
Host Code Page 1132 Laos . . . . . . . . . 342
5576-002/003 Keyboard (5250 Only) . . . . . 285
Host Code Page 1137 India . . . . . . . . . 343
5576-002/003 Keyboard (Combined 3270 and
Host Code Page 1140-1/695-1 Brazil, Canada,
5250) . . . . . . . . . . . . . . . 287
Netherlands, Portugal, U.S., and 1140/1175
APL Keyboard Layouts (3270 Only) . . . . . . 288
Traditional Chinese . . . . . . . . . . . 344
Key Map for Home3270 . . . . . . . . . . 290
Host Code Page 1141-1/695-1 Austria, Germany 345
Host Code Page 1142-1/695-1 Denmark, Norway 346
Appendix B. AS/400 Configuration
Host Code Page 1143-1/695-1 Finland, Sweden . . 347
Examples . . . . . . . . . . . . . 293 Host Code Page 1144-1/695-1 Italy . . . . . . 348
AS/400 Device Description . . . . . . . . . 294 Host Code Page 1145-1/695-1 Latin America, Spain 349
5250 Sessions through One Link . . . . . . . 294 Host Code Page 1146-1/695-1 United Kingdom . . 350
vi Personal Communications Administrator’s Guide and Reference
Host Code Page 1147-1/695-1 France . . . . . 351 Host Code Page 1160/1395 Thailand . . . . . 360
Host Code Page 1148-1/695-1 International . . . 352 Host Code Page 1164/1397 Vietnam . . . . . . 361
Host Code Page 1149-1/695-1 Iceland . . . . . 353
Host Code Page 1153/1375 Latin 2 - EBCDIC
Appendix D. Alerts . . . . . . . . . 363
Multilingual . . . . . . . . . . . . . . 354
Host Code Page 1154/1381 Cyrillic . . . . . . 355
Appendix E. Notices . . . . . . . . 367
Host Code Page 1155/1378 Latin 5 - Turkey . . . 356
Trademarks . . . . . . . . . . . . . . 368
Host Code Page 1156/1393 Latvia, Lithuania . . . 357
Host Code Page 1157/1391 Estonia . . . . . . 358
Index . . . . . . . . . . . . . . . 371
Host Code Page 1158/1388 Ukraine . . . . . . 359
Contents vii
viii Personal Communications Administrator’s Guide and Reference