Bull DPX/20 Installation guide

SC23-2563

Bull DPX/20

HCON Guide and Reference

AIX

86 A2 74WG 02

ORDER REFERENCE

Bull DPX/20

HCON Guide and Reference

AIX

Software

December 1996

Bull Electronics Angers S.A.

CEDOC

Atelier de Reprographie

331 Avenue Patton

49004 ANGERS CEDEX 01

FRANCE

86 A2 74WG 02

ORDER REFERENCE

The following copyright notice protects this book under the Copyright laws of the United States and other

countries which prohibit such actions as, but not limited to, copying, distributing, modifying, and making

derivative works.

Copyright

Bull S.A. 1992, 1996

Printed in France

Suggestions and criticisms concerning the form, content, and presentation of

this book are invited. A form is provided at the end of this book for this purpose.

Trademarks and Acknowledgements

We acknowledge the right of proprietors of trademarks mentioned in this book.

AIX

R

is a registered trademark of International Business Machines Corporation, and is being used under

licence.

UNIX is a registered trademark in the USA and other countries licensed exclusively through X/Open.

The information in this document is subject to change without notice. Groupe Bull will not be liable for errors

contained herein, or for incidental or consequential damages in connection with the use of this material.

iii

Preface

About This Book

This book contains conceptual and procedural information about the Host Connection

Program (HCON) facility. Topics covered include an introduction to HCON, as well as more

detailed information about using, configuring, and managing HCON.

Note: The information in this book can also be found in the Hypertext Information Base

Library. This online documentation is designed for use with the InfoExplorer

hypertext retrieval system.

Who Should Use This Book

This book is intended for people who want to use, manage, and program the HCON facility.

This book gives information from the most basic uses of HCON, such as invoking the facility

itself, to the most complex uses, such as managing HCON sessions. It is intended for both

beginners and advanced users.

Before you begin the tasks in this book, you should have a working knowledge of networks,

local and remote hosts, and client/server architecture.

How to Use This Book

Each chapter lists conceptual information on the chapter topic, followed by procedural

articles describing the various tasks associated with the topic.

Highlighting

The following highlighting conventions are used in this book:

Bold Identifies commands, keywords, files, directories, and other items whose

names are predefined by the system.

Italics Identifies parameters whose actual names or values are to be supplied by

the user.

Monospace Identifies examples of specific data values, examples of text similar to what

you might see displayed, examples of portions of program code similar to

what you might write as a programmer, messages from the system, or

information you should actually type.

ISO 9000

ISO 9000 registered quality systems were used in the development and manufacturing of

this product.

Related Publications

The following books contain information about or related to communications:

AIX and Related Products Documentation Overview, order number 86 A2 71WE.

AIX Topic Index and Glossary, order number 86 A2 57AP.

AIX 4.1 Installation Guide, order number 86 A2 60AP.

AIX 4.2 Installation Guide, order number 86 A2 05AT.

AIX General Programming Concepts : Writing and Debugging Programs, order number 86

A2 65AP.

AIX Communications Programming Concepts, order number 86 A2 70AP.

Hypertext Information Base Library.

3270 Information Display System 3274 Control Unit Customizing Guide

iv

Host Connection Program Guide and Reference

3270 Information Display System 3174 Subsystem Control Unit Customization Guide

3270 Information Display System 3274 Control Unit Customizing Guide Configuration

Support. Also, 3270 Control Unit Planning and Setup Customizing Guide.

3270 Information Display System Data Stream Programmer’s Reference.

SNA Format and Protocol Reference Manual: Management Services.

The 4-Port Multiprotocol Interface Adapter Technical Reference.

X.25 Co-Processor/2 Technical Reference.

O’Reilly, Tim; and Todino, Grace. Managing UUCP and Usenet. Sebastopol, California:

O’Reilly and Associates, Inc., 1990.

Berkeley System Distribution manuals.

Dougherty, Dale; and Todino, Grace. Using UUCP and Usenet. Sebastopol, California:

O’Reilly and Associates, Inc., 1987.

Ordering Publications

You can order publications from your sales representative or from your point of sale.

If you received a printed copy of Documentation Overview with your system, use that book

for information on related publications and for instructions on ordering them.

To order additional copies of this book, use order number 86 A2 74WG.

v

Preface

Contents

Chapter 1. Host Connection Program Overview 1-1. . . . . . . . . . . . . . . . . . . . . . . . . . .

HCON Capabilities 1-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

National Language Support 1-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Machine Requirements 1-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Connection Requirements 1-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Programming Requirements 1-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Limitations 1-7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Chapter 2. Using Host Connection Program 2-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

S/390 Host Double-Byte Character Set Emulation 2-2. . . . . . . . . . . . . . . . . . . . . . . . . . . .

HCON Sessions and Session Profiles 2-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Display Sessions 2-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Printer Sessions 2-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Session Profiles 2-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HCON Profile Fields and Associated Command Flags 2-5. . . . . . . . . . . . . . . . . . . . . . . .

Display Sessions 2-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Printer Sessions 2-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Xwindow 3270 Emulator (xhcon) 2-7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Customizing the xhcon Command 2-7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Mouse Function 2-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Access Function Keys through Push Buttons 2-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Dynamic Window Size for Multiple Sessions 2-9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3270 Emulator 2-13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3270 Keyboard 2-14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Keyboard Locking and Unlocking Criteria 2-14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Special Keys 2-14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Unsupported Print Control Keys 2-18. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Operator Information Area (OIA) 2-19. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Operator Information Area Fields 2-19. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Input-Inhibited Field Error Codes for the HCON OIA 2-21. . . . . . . . . . . . . . . . . . . . . . . .

Using Default 3270 Keyboards 2-26. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Setting the Terminal Type 2-26. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Using Display Session on Server and Station Keyboards 2-28. . . . . . . . . . . . . . . . . . . . . .

Using Display Session on 3151, 3161, 3162, 3163, and 3164 Keyboards 2-30. . . . . . . .

Using Display Session on DEC VT100 Keyboards 2-32. . . . . . . . . . . . . . . . . . . . . . . . . . . .

Using Display Session on DEC VT220 Keyboards 2-34. . . . . . . . . . . . . . . . . . . . . . . . . . . .

Using Display Session on WYSE Keyboards 2-36. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HCON Utility Program Overview 2-40. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Customizing HCON with the Utility Program 2-40. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

File Transfers with the Utility Program 2-42. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Logging On and Logging Off Support Using a Predefined Script 2-42. . . . . . . . . . . . .

HCON Utility Program Keys and Fields 2-43. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Utility Program Keys 2-43. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Utility Program Fields 2-44. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Customizing HCON Color and Highlight Values with the Utility Program 2-47. . . . . . . . .

3270 Fields 2-47. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Displayable 3270 Attributes 2-48. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Changing Color and Highlight Values 2-48. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Customizing the HCON Color Definition Table 2-50. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

vi

Host Connection Program Guide and Reference

Prerequisites 2-50. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Procedure 2-50. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Customizing the HCON Keyboard Definition Table 2-51. . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisites 2-51. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Procedure 2-51. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Customizing HCON Key Definitions with the Utility Program 2-52. . . . . . . . . . . . . . . . . . .

Key Definition Fields 2-52. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Changing Key Definitions 2-52. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Redefining Keyboard Values 2-53. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Changing the Key Map Fields 2-53. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HCON File Transfers 2-55. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Explicit and Implicit File Transfers 2-55. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Synchronous and Asynchronous File Transfers 2-55. . . . . . . . . . . . . . . . . . . . . . . . . . . .

Session Profiles for File Transfers 2-56. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Interrupted and Restarted File Transfers 2-56. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HCON Utility Program File Transfer Facility 2-58. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Session Profile Prompt Screen 2-58. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Restart Menu 2-58. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

CMS Menu 2-59. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

TSO Menu 2-60. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

CICS Menu for CICS/VS and VSE Menu for VSE/ESA 2-62. . . . . . . . . . . . . . . . . . . . .

File Transfer Message Window 2-63. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Transfer Fields for the CICS, CMS, VSE, and TSO Menus 2-63. . . . . . . . . . . . . . . . . .

HCON Host Logon Procedures 2-67. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Automatic Logon (AUTOLOG) 2-67. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Creating and Testing an HCON AUTOLOG Script 2-69. . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisites 2-69. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Procedure 2-69. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Using an HCON AUTOLOG Script 2-71. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite 2-71. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Debugging an HCON AUTOLOG Script 2-72. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite 2-72. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Procedure 2-72. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Using the HCON Utility Program Logon and Logoff Facility 2-73. . . . . . . . . . . . . . . . . . . .

Logon and Logoff Screens 2-73. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Logon and Logoff Fields 2-75. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HCON Commands 2-77. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Emulation and File Transfers 2-77. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

AUTOLOG Procedures 2-77. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Configuring HCON 2-77. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Maintaining HCON 2-77. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Chapter 3. Managing Host Connection Program 3-1. . . . . . . . . . . . . . . . . . . . . . . . . .

Managing HCON 3-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HCON Users 3-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Managing HCON Sessions 3-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Types of HCON Sessions 3-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Storing HCON Session Profiles 3-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HCON Display Emulation 3-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3270 Data Stream Attributes 3-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3270 Data Stream Commands 3-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3270 Data Stream Orders 3-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3270 Data Stream Outbound Structured Fields 3-12. . . . . . . . . . . . . . . . . . . . . . . . . . . .

3270 Data Stream Inbound Structured Fields 3-14. . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HCON Printer Emulation 3-19. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

vii

Preface

Starting and Controlling a Printer Session 3-19. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3270 Data Stream Support for Printer Sessions 3-19. . . . . . . . . . . . . . . . . . . . . . . . . . .

HCON Processes 3-23. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

hcondmn Subsystem 3-24. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

e789 Process 3-25. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

xhcon Process 3-25. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

e789pr Process 3-25. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

e789x Process 3-25. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

xhconx Process 3-25. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

e789lus Process 3-25. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HCON File Transfer Process 3-26. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Creating HCON File Transfer Shell Procedures 3-28. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite 3-28. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HCON Connections and Adapters 3-31. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HCON Attachments 3-33. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3174/3274 or Equivalent Attachment 3-33. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

5088/6098 Graphics Control Unit Attachment 3-34. . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3172/8232 Attachment 3-35. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Channel Attachment 3-35. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

SNA Standalone Attachment 3-36. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

SNA Support 3-39. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

System Tuning Considerations for HCON in SNA Standalone Mode 3-40. . . . . . . . . .

Configuring SNA Services for Use with HCON 3-41. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisites 3-41. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Procedure 3-41. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HCON Display Session Pooling 3-42. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HCON DFT Pooling 3-42. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HIA Pooling 3-43. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

SNA Node T2.1 Pooling 3-43. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Configuration of SNA T2.1 Sessions with Multiple Pools 3-44. . . . . . . . . . . . . . . . . . . .

Setting Up an SNA Node T2.1 LU Pool 3-44. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

LU Pooling Management 3-46. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HCON Screen Size Management 3-46. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Installing and Updating HCON 3-48. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HCON Software 3-48. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HCON Message Catalog (PII) 3-48. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Adapters for HCON 3-48. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

SNA Services Profiles 3-48. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Updating HCON 3-49. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Adapters Supported by HCON 3-49. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Stopping the hcondmn Subsystem 3-50. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisites 3-50. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Procedure 3-50. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Tuning Local Systems When Using SNA Services with HCON 3-51. . . . . . . . . . . . . . . . .

Prerequisites 3-51. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Procedure 3-51. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Configuring HCON 3-53. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisites 3-53. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Procedure 3-53. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Optional Steps 3-53. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Defining a New Terminal for HCON 3-54. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisites 3-54. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Procedure 3-54. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HCON and terminfo Key Names 3-54. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Customizing HCON for System Management 3-56. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

viii

Host Connection Program Guide and Reference

Customizing Color and Keyboard Definitions 3-56. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Setting the Terminal Type 3-56. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Converting Color and Keyboard Definition Tables 3-57. . . . . . . . . . . . . . . . . . . . . . . . . .

Developing File Transfer Shell Scripts 3-58. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Maintaining HCON 3-59. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Recovering from Interrupted HCON File Transfers 3-59. . . . . . . . . . . . . . . . . . . . . . . . .

Stopping Interrupted HCON Sessions with the e789cln Command 3-60. . . . . . . . . . .

Troubleshooting HCON 3-60. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Problems with Host Configuration 3-60. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Problems with Host Configuration and the HCON Session Profile 3-61. . . . . . . . . . . .

Problems with SNA Node T2.1 Emulation Using LU Type 1, 2, and 3 3-61. . . . . . . . .

SNA Node T2.1 Sense Codes 3-64. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Configuring Hosts for HCON 3-66. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Host Requirements 3-66. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

3274/3174 Control Unit 3-67. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

5088/6098 Graphics Control Unit 3-67. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Setting Up the Host LOGMODE Table for HCON 3-68. . . . . . . . . . . . . . . . . . . . . . . . . . . . .

LOGMODE Table for SNA Sessions 3-68. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

LOGMODE Table for Non-SNA Sessions 3-69. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

VTAM/NCP Node Definition Examples 3-70. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

SNA Local Channel Attachment Example 3-70. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Non-SNA Local Channel Attachment HCON Example 3-71. . . . . . . . . . . . . . . . . . . . . .

Remote Non-SNA Binary Synchronous Communication Attachment Example 3-72.

Remote Leased SDLC Attachment Example 3-73. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remote Switch SDLC Attachment Example 3-74. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Token-Ring Attachment Example 3-75. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Problem Determination Using an SNA Standalone Node T2.1 with HCON 3-76. . . . . . .

Reading the Error Message 3-76. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Error Messages for SNA Standalone Node T2.1 3-76. . . . . . . . . . . . . . . . . . . . . . . . . . .

Chapter 4. High-Level Language Application Programming Interface 4-1. . . . . . .

Programming HLLAPI 4-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HLLAPI for AIX 3270 Host Connection 4-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HLLAPI Components 4-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Uses of HLLAPI 4-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HLLAPI Services 4-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HLLAPI Connections 4-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HLLAPI Presentation Spaces 4-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Printer Sessions 4-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Running HLLAPI Programs 4-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HLLAPI Current Connection 4-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Keyboard Remap with Utility Session 4-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Ending HLLAPI Communication 4-6. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Programming with HLLAPI 4-7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HLLAPI Guidelines for C Programs 4-7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HLLAPI Guidelines for COBOL Programs 4-7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HLLAPI Guidelines for FORTRAN Programs 4-8. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HLLAPI Functions by Function Number 4-9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Summary of Prerequisite Calls for HLLAPI Functions 4-10. . . . . . . . . . . . . . . . . . . . . . .

CONNECT PRESENTATION SPACE (1) 4-11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

ix

Preface

Remarks 4-12. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

CONVERT POSITION or CONVERT ROWCOL (99) 4-13. . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-13. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-14. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

COPY FIELD TO STRING (34) 4-15. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-15. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-15. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-15. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-15. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-15. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-16. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

COPY OIA (13) 4-17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-17. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-22. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

COPY PRESENTATION SPACE (5) 4-23. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-23. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-23. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-23. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-23. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-23. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-24. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

COPY PRESENTATION SPACE TO STRING (8) 4-26. . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-26. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-26. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-26. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-26. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-26. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-26. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Related Information 4-29. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

COPY STRING TO FIELD (33) 4-30. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-30. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequiste Calls 4-30. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-30. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-30. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-30. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-30. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

COPY STRING TO PRESENTATION SPACE (15) 4-32. . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-32. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-32. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-32. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-32. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-32. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-33. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

DISCONNECT PRESENTATION SPACE (2) 4-34. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-34. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-34. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-34. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

x

Host Connection Program Guide and Reference

Supplied Parameters 4-34. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-34. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-34. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

FIND FIELD LENGTH (32) 4-35. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-35. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-35. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-35. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-35. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-35. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-36. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

FIND FIELD POSITION (31) 4-37. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-37. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-37. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-37. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-37. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-37. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-38. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

GET KEY (51) 4-39. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-39. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-39. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-39. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-39. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-39. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-41. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

PAUSE (18) 4-42. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-42. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-42. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-42. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-42. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-42. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-42. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

POST INTERCEPT STATUS (52) 4-44. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-44. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-44. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-44. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-44. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-44. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-45. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

QUERY CURSOR LOCATION (7) 4-46. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-46. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-46. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-46. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-46. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-46. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-46. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

QUERY FIELD ATTRIBUTE (14) 4-47. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-47. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-47. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-47. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-47. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-47. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-48. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

QUERY HOST UPDATE (24) 4-49. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-49. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-49. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

xi

Preface

Syntax 4-49. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-49. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-49. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-49. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

QUERY SESSIONS (10) 4-50. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-50. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-50. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-50. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-50. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-50. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-51. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

QUERY SESSION STATUS (22) 4-52. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-52. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-52. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-52. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-52. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-52. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-53. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

QUERY SYSTEM (20) 4-54. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-54. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-54. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-54. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-54. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-54. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-54. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

RECEIVE FILE (91) 4-55. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-55. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-55. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-55. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-55. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-56. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-56. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

RELEASE (12) 4-57. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-57. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-57. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-57. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-57. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-57. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-57. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

RESERVE (11) 4-58. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-58. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-58. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-58. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-58. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-58. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-58. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

RESET SYSTEM (21) 4-59. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-59. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-59. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-59. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-59. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-59. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-59. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

SEARCH FIELD (30) 4-60. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-60. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

xii

Host Connection Program Guide and Reference

Prerequisite Calls 4-60. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-60. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-60. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-60. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-60. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

SEARCH PRESENTATION SPACE (6) 4-62. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-62. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-62. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-62. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-62. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Paremeters 4-62. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-62. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

SEND FILE (90) 4-64. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-64. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-64. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-64. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-64. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-65. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-66. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

SEND KEY (3) 4-67. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-67. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-67. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-67. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-67. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-67. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-70. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

SET CURSOR (40) 4-72. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-72. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-72. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-72. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-72. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-72. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-72. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

SET SESSION PARAMETERS (9) 4-73. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-73. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-73. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-73. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-73. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-73. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-78. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

START HOST NOTIFICATION (23) 4-79. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-79. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-79. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-79. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-79. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-80. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-80. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

START KEYSTROKE INTERCEPT (50) 4-81. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-81. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-81. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-81. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-81. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parmeters 4-81. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-82. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

STOP HOST NOTIFICATION (25) 4-83. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

xiii

Preface

Purpose 4-83. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-83. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-83. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-83. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-83. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-83. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

STOP KEYSTROKE INTERCEPT (53) 4-84. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-84. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-84. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-84. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-84. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Paremeters 4-84. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-84. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

WAIT (4) 4-85. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Purpose 4-85. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisite Calls 4-85. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Syntax 4-85. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Supplied Parameters 4-85. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Returned Parameters 4-85. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Remarks 4-85. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Sample C HLLAPI Program 4-87. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Chapter 5. Programming the Host Connection Program 5-1. . . . . . . . . . . . . . . . . . .

Programming HCON 5-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

File Transfer Program Interface 5-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Restart Files and Interruptions 5-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Synchronous and Asynchronous File Transfers 5-2. . . . . . . . . . . . . . . . . . . . . . . . . . . .

Security 5-2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

File Transfer Programming Header Files 5-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

File Transfer Data Structures 5-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HCON Programming Examples 5-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

File Transfer Programming Examples 5-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Compiling Example Programs 5-4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

VM/CMS File Transfer Program Example 5-5. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

FORTRAN File Transfer Program Example 5-7. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Pascal File Transfer Program Example 5-9. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

HCON Programming References 5-11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

File Transfer Program 5-11. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Compiling a File Transfer Program 5-12. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Prerequisites 5-12. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Procedure 5-12. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Appendix A. HLLAPI Return Codes A-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Return Codes Overview A-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Description of Standard Return Codes A-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

File Transfer Error Codes A-3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Index X-1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

xiv

Host Connection Program Guide and Reference

Host Connection Program Overview

1-1

Chapter 1. Host Connection Program Overview

The Host Connection Program is a 3270 connectivity application for the AIX environment.

The Host Connection Program (HCON) emulates a subset of 327X functions and features,

and it allows end users at AIX terminals to connect to an IBM System/370 host and appear

to the host as an attached IBM 3270 Display Terminal or printer. HCON facilitates file

transfers between the workstation and the IBM System/370 host, allows printer emulation,

and provides High-Level Language Application Programming Interface (HLLAPI) support for

user-provided workstation applications to communicate with 3270 sessions.

HCON connectivity can be:

• System Network Architecture (SNA) connection in a Type 2.1 low-entry networking (LEN)

node attachment

• Distributed Function Terminal (DFT) SNA attachment to an IBM 3274/3174 or IBM 9370

Workstation Subsystem Controller

• Transmission Control Protocol/Internet Protocol (TCP/IP) Telnet 3270 connection

• DFT Non-SNA attachment to a 5088/6098 Graphics Control Unit.

The SNA Node T2.1 and TCP/IP capability can operate over a wide area network (WAN),

allowing users at a remote work group location access to the services and facilities of an

IBM System/370 or System/390 Host. This protocol also supports the IBM Token-Ring or

Ethernet network, which allows users to access these same services and facilities over a

local area network (LAN). The coax DFT attachment uses the 3274/3174 in both SNA and

non-SNA mode and supports up to five sessions per IBM 3270 Connection Adapter.

Host Connection Program Guide and Reference

1-2

The HCON Connectivity figure illustrates the connectivity capability of HCON.

Ethernet

IEEE 802.3

Token-Ring

Ethernet

IEEE 802.3

Token-Ring

HIA

3270

X.25

MPQP

MPA

X.25

SNA Services

HCON

Operating System

TCP/IP

Async Ports

TCP/IP Network

Local/Remote HCON Users

Remote HCON Users

3X74

3172

5088/

6098

37X5

S/390

Packet

Switching

Network

HCON Connectivity

LAN

S/390

Packet

Switching

Network

37X5

TCP/IP

S/390

3172

LAN

9032

9033

ES-

CON

FDDI

Block

Multi-

LAN

. . . . .

S/390 S/390

S/390

plexer

HCON Capabilities

The HCON 3270 emulation program:

• Provides IBM 3278/79 display emulation support on ASCII terminals, including the IBM

3151, IBM 3161, IBM 3162, IBM 3163, IBM 3164, DEC VT100, DEC VT220, WYSE

WY-50, WYSE WY-60 and WYSE WY-370.

• Supports multiple host sessions within a single AIX terminal using AIXwindow support.

• Provides features using the AIX window interface, including menu bar support and

light-pen simulation using a mouse. These features require the (X11R5) with Motif

version 1.2.

• Supports the 3278/79 Models 2, 3, 4, and 5. Models 3, 4, and 5 are only available on

aixterm sessions, Xstations, or xhcon run in AIXwindows. Model 5 is also available on

the IBM 3151 with Expansion Cartridge.

• Supports the IBM 3286/87 printer emulation.

Host Connection Program Overview

1-3

• Supports DFT connection through the 3270 Connection Adapter. The mainframe system

console attachment using DFT is also supported. Each model can support up to four

adapters, and each adapter can have up to five active sessions for the following

interfaces:

– 3174 or 3274 Control unit

– 4361 Workstation adapter

– 9370 Workstation subsystem controller

• Supports up to 16 sessions by connecting to the IBM 5088 Graphics Channel Controller

or 6098 Channel Control Unit through the System/370 Host Interface Adapter.

• Permits more than one active session per user up to a maximum of 26 per user. (The

total number of user sessions cannot exceed the number of sessions available through

the hardware interface connections.)

• Provides extended data stream support for seven colors plus either reverse video,

underlining, or blink. The actual attribute displayed depends on the capabilities of the

display.

• Grants file transfer:

– Support for queued or immediate file transfer requests

– Support for C and FORTRAN programming interface to file transfer

• Supports industry-standard HLLAPI support using C, FORTRAN, and COBOL

languages:

– Workstation-application control of emulation session in an operatorless environment

– Workstation-application control of keystrokes in an operatorless environment

• Provides utility session support where the frequently used utilities are centralized. HCON

allows:

– Color redefinition

– Keyboard redefinition

– Session logon and logoff automatically with generation of session logon/logoff scripts

– File transfer support implicitly or explicitly

• Enables a user to interact with HCON on either a local or remote X server, or remotely by

using TCP/IP, Telnet, or remote login. When running remotely, the user must be aware

that host connection functions are executed on the “connected-to” system. The display

emulation functions are viewed where the user’s terminal is running, but other host

connection functions can run and affect files (by file transfer) and facilities (such as

printers) on the “connected-to” system rather than the local system.

• Provides support for the SNA Logical Unit (LU) pooling to improve LU resource

management and administration by:

– Monitoring a specific LU pool during peak hours to help ensure fair distribution

– Aiding to identify congested pools and low-usage pools

– Displaying the status of each LU for session management and host problem

determination

HCON’s features and connectivity capabilities are detailed in Chapter 2 “Using Host

Connection Program”on page 2-1.

National Language Support

This program includes National Language Support (NLS) for both single-byte character set

(SBCS) and double-byte character set (DBCS). Actual SBCS character presentation on

ASCII display terminals may be limited by a particular display terminal’s capability, and the

use of international names can be restricted in the customization of color and keyboard

mapping.

NLS overall characteristics include:

Host Connection Program Guide and Reference

1-4

• International Language Support (ILS) for all SBCS countries currently supported by AIX

Japanese, Korean and Traditional Chinese language support using DBCS.

• Multiple sessions in different national languages are concurrently supported with some

restrictions.

• Message handling is supported by these programs by providing messages, panels, and

prompts that can be translated. The translatable material is separated from the program

executable code.

The Japanese Language Support program characteristics includes support for the:

• IBM 3270 KANJI display emulation support on the Xstation. Multiple host sessions are

supported within a single AIX terminal or across multiple virtual terminals on the

high-function terminal (HFT). KANJI display sessions only can operate on an aixterm

within the AIXwindows environment, supporting KANJI input and output operations, or

the PS/55 with DEC VT100 interface using an ASCII terminal. The PS/55 requires both

of the following:

– Nihongo DOS Version K3.3 and up

– Nihongo Procomm 4500-JCK or 5605-JCK.

• 3278/79 Models 2, 3, 4, and 5.

– IBM 3270 KANJI printer emulation on printers with the capability to handle DBCS and

field outlining.

• IBM 3270 KANJI stream.

• DBCS-Asia Query Reply and the Character Sets Query Reply Character set IDs and

code page IDs for Japanese Language Support, including the following:

– Japanese Katakana-SBCS (CS-CP: 332-290)

– DBCS (370-300)

– Japanese English-SBCS (101-037)

– DBCS (370-300)

– Operator-controlled single- or double-byte editing using Shift-in Shift-out (SI/SO)

through a special key sequence.

• Expanded extended data stream for field outlining capability.

• Alternate Viewing Mode allowing users to switch the displaying character set between

Japanese Katakana and Japanese English by a local key operation.

– KANJI character input by using the DBCS Input Method and Kana-Kanji Conversion

(KKC) function provided by the AIX Version 3.

• File transfer with additional file transfer command option flags for Japanese host file

transfer program support. These option flags are not supported for C and FORTRAN

programming interfaces.

The High-Level Language Application Program Interface (HLLAPI) does have DBCS

language support.

Machine Requirements

The following are fixed-disk storage requirements for the AIX 3270 Host Connection

Program licensed program:

3270 Host Connection Program

4.10 MB

Messages/Help Text

0.30 MB (per language)

Memory and fixed-disk requirements for other licensed programs, user applications, and

data are not included in the above. Carefully review all system, memory, and fixed-disk

requirements with your marketing representative.

Page is loading ...

Bull DPX/20, HCON Installation guide

Related papers

Other documents