Bull DPX/20 Installationsanleitung

SC23-2563Bull DPX/20HCON Guide and ReferenceAIX86 A2 74WG 02ORDER REFERENCE

viiiHost Connection Program Guide and ReferenceCustomizing Color and Keyboard Definitions 3-56. . . . . . . . . . . . . . . . . . . . . . . . . . . .

Host Connection Program Guide and Reference2-76The data in the Session Name and Password fields must be entered. However, thevalues for User ID, Node

Using Host Connection Program2-77HCON CommandsSee “HCON Programming References” on page 5-11 for information about the File TransferProgram Interface,

Host Connection Program Guide and Reference2-78Working with Session Profileschhcons Changes a session profile.clhcons Returns the type of a session

Managing Host Connection Program3-1Chapter 3. Managing Host Connection ProgramThe Host Connection Program (HCON) emulates a 3278/79 display or a 3286/

Host Connection Program Guide and Reference3-2HCON UsersBefore using HCON, the user must be defined as an HCON user. An HCON user can createsession pr

Managing Host Connection Program3-3Managing HCON SessionsHow HCON sessions process data depends on the type of host connections used. Thesession profi

Host Connection Program Guide and Reference3-4HCON Printer SessionsHCON supports three types of printer sessions:• 3270 data stream over non-SNA DFT (

Managing Host Connection Program3-5HCON Display EmulationHCON supports the emulation of a 3270 display session in Models 2, 3, 4, and 5. Thedisplay se

Host Connection Program Guide and Reference3-6Attribute TypeCode SFE, MFOrdersSAOrdersCharacter Attribute Reset X‘00’ – xField Attribute X‘C0’ x –Exte

Managing Host Connection Program3-7write (WR) Sends orders or data to update the display screen. Data characters arestored in successive buffer locati

ixPrefaceRemarks 4-12. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CONVERT

Host Connection Program Guide and Reference3-8Write Control CharactersThe Write Control Character (WCC) bits have these definitions.WCC BitExplanation

Managing Host Connection Program3-9Start Field (SF)Starts a new field by placing a basic field attribute character at the currentbuffer address of the

Host Connection Program Guide and Reference3-10Modify Field Attribute (MF)Enables the user to selectively change these attributes at the current buffe

Managing Host Connection Program3-11The PT order stops its search at the last character location of the screenbuffer. If an unprotected field attribut

Host Connection Program Guide and Reference3-123270 Data Stream Outbound Structured FieldsThe structured field is a format used to transport data. Out

Managing Host Connection Program3-13Erase/Reset Erases the screen and resets the display session to implicit partition stateusing the default or alter

Host Connection Program Guide and Reference3-14Outbound 3270DSEnables the user to direct the write commands and other structured fields tothe display

Managing Host Connection Program3-15The format for each structured field includes:Inbound 3270DSEnables the user to send data from the alphanumeric pr

Host Connection Program Guide and Reference3-16Usable Area Defines the size and characteristics of the screen.ByteBit Content Description0–1 X‘0014’ L

Managing Host Connection Program3-174X‘00’ (Reserved)5 X‘08’ Number of Color Attribute Pairs6–21 X‘00F4’ F1F1 F2F2 F3F3 F4F4 F5F5 F6F6 F7F7Default is

xHost Connection Program Guide and ReferenceSupplied Parameters 4-34. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Host Connection Program Guide and Reference3-182X‘81’ Query Reply3 X‘99’ Auxiliary Device4 X‘00’ Reserved5 X‘00’ ReservedImplicit PartitionDefines the

Managing Host Connection Program3-19HCON Printer EmulationHCON supports continuous printing of printer data streams from the host. The data streamscon

Host Connection Program Guide and Reference3-203270 Printer Data StreamThe 3270 printer data stream is used in non-SNA DFT configuration, as well as i

Managing Host Connection Program3-21The SCS codes supported include:Supported SCS Control CodesSymbol Hex Value CommandBS 16 BackspaceBEL 2F * BellCR

Host Connection Program Guide and Reference3-22Outbound Structured FieldsOutbound SCS data is transported as raw data or packaged in one or more SCS s

Managing Host Connection Program3-23HCON ProcessesHCON emulator and file transfer sessions are established, maintained, and stopped bythese processes:

Host Connection Program Guide and Reference3-24The HCON Processes figure shows the parent and child process relationship.SNA T2.1HLLAPIe789fxferdfxfer

Managing Host Connection Program3-25/usr/bin/stopsrc –f –s hconWarning: Do not stop the hcondmn subsystem unless under directions from customersupport

Host Connection Program Guide and Reference3-26HCON File Transfer ProcessThe HCON file transfer program transfers files between a local system and a m

Managing Host Connection Program3-27• Transfers the file.• Logs off the host.• Ends the session.If a file transfer wait period is specified, the dfxfe

xiPrefaceSyntax 4-49. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Supp

Host Connection Program Guide and Reference3-28Creating HCON File Transfer Shell ProceduresThe following sections describe the procedures for creating

Managing Host Connection Program3-29else echo ”File transfer completed successfully.”fiUsing the File Transfer Shell ProcedureTo use the fx shell pro

Host Connection Program Guide and Reference3-30Then include both the host logon ID and the host password in a separate file and use thecat command to

Managing Host Connection Program3-31HCON Connections and AdaptersHCON host communication is established through several types of adapters and interfac

Host Connection Program Guide and Reference3-32The operating system has direct access to any customer SNA network. The choice ofconnectivity is depend

Managing Host Connection Program3-33HCON AttachmentsThe HCON Adapters and Protocols figure shows the protocols and session types supportedfor each typ

Host Connection Program Guide and Reference3-34HCON supports these DFT capabilities:• 8KB hardware communication buffer• Slow device for non-SNA print

Managing Host Connection Program3-35The DFT, HIA, and TCP/IP Connections to Separate Hosts figure shows three distinct datahosts. Each host has differ

Host Connection Program Guide and Reference3-36The direct channel attachment enables the local system to serve as a gateway between aLAN and a mainfra

Managing Host Connection Program3-37node. However, the actual performance and response time of each LU depends on thesystem workload and type of appli

xiiHost Connection Program Guide and ReferencePrerequisite Calls 4-60. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Host Connection Program Guide and Reference3-38The SNA Standalone Structure figure shows the structure of layers in standalone mode.To Host (Control P

Managing Host Connection Program3-39SNA SupportSNA support can be from the SNA Services program or from within HCON. HCON SNAfunction is dependent on

Host Connection Program Guide and Reference3-40System Tuning Considerations for HCON in SNA Standalone ModeIf you run a large number of HCON sessions

Managing Host Connection Program3-41Configuring SNA Services for Use with HCONThis article provides information on configuring SNA services for use wi

Host Connection Program Guide and Reference3-42HCON Display Session PoolingPooling is a method for partitioning resources to ensure a logical distribu

Managing Host Connection Program3-43Non-SNA DFTFor non-SNA DFT sessions, the principle is the same as for SNA DFT sessions exceptprinter sessions are

Host Connection Program Guide and Reference3-44– If an LU is not available in the defined pool, an error message displays or writes to the$HOME/hconer

Managing Host Connection Program3-455. Assign each HCON user’s session to a pool based on the session profile and the user’srequirements. HCON does no

Host Connection Program Guide and Reference3-46Disable SNA Node T2.1 Display Session PoolingTo disable pooling support for a session, use the entire S

Managing Host Connection Program3-47The SNA BIND command parameters (bytes 20 to 24) and the influence upon the screensize include:SNA Screen Size Han

xiiiPrefacePurpose 4-83. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Pre

Host Connection Program Guide and Reference3-48Installing and Updating HCONBefore using HCON on a local system, you must install:• HCON software• HCON

Managing Host Connection Program3-49Updating HCONOccasionally HCON software needs updating. Use SMIT or the installp command. Theupdate procedure is t

Host Connection Program Guide and Reference3-50Stopping the hcondmn SubsystemPrerequisites• HCON must be installed on your system.• You must have root

Managing Host Connection Program3-51Tuning Local Systems When Using SNA Services with HCONPrerequisites1. The HCON program and messages must be instal

Host Connection Program Guide and Reference3-527. Set the value of the SESSIONS and CONVERSATIONS variables to a number equalingtwice the value of the

Managing Host Connection Program3-53Configuring HCONHCON supports attachment to an SNA network as a Type 2.1 Node. For this attachment,the SNA network

Host Connection Program Guide and Reference3-54Defining a New Terminal for HCONThis procedure explains how to define a new terminal for HCON.Prerequis

Managing Host Connection Program3-55key_tabktab key_pf6 kf6key_btab kbtab key_pf7 kf7key_enter kcmd key_pf8 kf8key_sysreq khlp key_pf9 kf9key_clear kc

Host Connection Program Guide and Reference3-56Customizing HCON for System ManagementSeveral customization options are available to the HCON system ma

Managing Host Connection Program3-57TERM Environment VariablesTerminalTypeDescriptionsTERMVariable316X ibm3162-132 28x132 (model 5) with OIA line316X

xivHost Connection Program Guide and Reference

Host Connection Program Guide and Reference3-58When converting an HCON 1.1 keyboard table to a newer release, define these keys:Emulator Key Default S

Managing Host Connection Program3-59Maintaining HCONTo maintain HCON you can:• Add and delete users from the registered user list.• Create new session

Host Connection Program Guide and Reference3-60time the dfxfer process attempts recovery is determined by the File Transfer Recovery Timevalue in the

Managing Host Connection Program3-61• The control unit for the emulator is not configured to support DFT terminals.• An insufficient number of session

Host Connection Program Guide and Reference3-62The SNA Services Connection profile names a local LU profile that in turn containsthe LU address or LU

Managing Host Connection Program3-630831 Sense Code Received During Printer SessionProblem: The host’s print spooler indicates a 0831 sense code was r

Host Connection Program Guide and Reference3-64• Use a host print application that sends properly formatted SCS data and the FMHs.SNA Node T2.1 Sense

Managing Host Connection Program3-65SNA Node T2.1 Sense CodesSenseCodeDescriptionSubCode1005 0000 The emulator detected one of the following program c

Host Connection Program Guide and Reference3-66Configuring Hosts for HCONBefore users on the system can use the Host Connection Program (HCON) to comm

Managing Host Connection Program3-67application. An LU’s session is established between the two LUs by theSNA BIND command. The BIND parameters determ

Host Connection Program Overview1-1Chapter 1. Host Connection Program OverviewThe Host Connection Program is a 3270 connectivity application for the

Host Connection Program Guide and Reference3-68Setting Up the Host LOGMODE Table for HCONThe table definition LOGMODE entry controls the session types

Managing Host Connection Program3-69LU33270 MODEENT LOGMODE=LU33270,FMPROF=X’03’, C TSPROF=X’03’,PRIPROT=X’B1’, C

Host Connection Program Guide and Reference3-70VTAM/NCP Node Definition ExamplesThese examples define nodes on a Virtual Telecommunctations Access Mod

Managing Host Connection Program3-71Non-SNA Local Channel Attachment HCON ExampleThis example shows how to define a non-SNA local channel subsystem on

Host Connection Program Guide and Reference3-72Remote Non-SNA Binary Synchronous Communication AttachmentExampleThis example shows how to define an ne

Managing Host Connection Program3-73Remote Leased SDLC Attachment ExampleThis example illustrates a typical synchronous data link control (SDLC) lease

Host Connection Program Guide and Reference3-74Remote Switch SDLC Attachment ExampleThe switched SDLC link definition has two components:• GROUP, LINE

Managing Host Connection Program3-75Token-Ring Attachment ExampleThe definitions for a Token-Ring attachment are similar to those for a switched line.

Host Connection Program Guide and Reference3-76Problem Determination Using an SNA Standalone Node T2.1with HCONWhen using an SNA standalone session wi

Managing Host Connection Program3-77e789 abcdefghijklmnopqrstuvwxyzaRemedy Specify no more than 26 sessions on the e789 command line.Error Message0789

Host Connection Program Guide and Reference1-2The HCON Connectivity figure illustrates the connectivity capability of HCON.EthernetIEEE 802.3Token-Rin

Host Connection Program Guide and Reference3-78Try the operation again. If the problem persists, record the error numberand exit code, and contact sys

Managing Host Connection Program3-79Cause Refer to message 0789-011Error Message0789–020 Cannot open file. . .Cause The open subroutine returned a neg

Host Connection Program Guide and Reference3-80Error Message0789-029 Cannot read from communication device special file. . .Cause The readx subroutine

Managing Host Connection Program3-81Error Message0789–047 The communication device or keyboard queue poll failed. . .Cause The poll subroutine was uns

Host Connection Program Guide and Reference3-82Remedy Size or open the window with a different font size. Ensure the number ofrows and columns in the

Managing Host Connection Program3-83Error Message0789–065 File contains data which is not valid. . .Cause The indicated file is not a valid color tabl

Host Connection Program Guide and Reference3-84Error Message0789–073 Cannot redirect standard output to a pipe. . .Cause The close or dup subroutine w

Managing Host Connection Program3-85to the terminal. See “Understanding I/O Access Through Special Files” inAIX Kernel Extensions and Device Support P

Host Connection Program Guide and Reference3-86Error Message0789–083 Cannot deallocate the SSCP–LU session. . .Cause The ioctl subroutine was unsucces

Managing Host Connection Program3-87If the problem persists, record the error number and contact systemsupport.Error Message0789–089 Attempting to iss

Host Connection Program Overview1-3• Supports DFT connection through the 3270 Connection Adapter. The mainframe systemconsole attachment using DFT is

Host Connection Program Guide and Reference3-88For information on how to change system parameters (such as userprocess limits or available memory), re

Managing Host Connection Program3-89Remedy The remedy depends on the error number specified in the error message:• If the error number is 11 (EAGAIN),

Host Connection Program Guide and Reference3-90Error Message0789–108 Session ended abnormally. . .Cause The msgsnd subroutine failed to communicate wi

Managing Host Connection Program3-91Remedy Verify that the interruption was not caused by process managementfunctions (for example, a kill command or

Host Connection Program Guide and Reference3-92Cause The write subroutine failed to write data to the indicated HCON replace file.Remedy The remedy de

Managing Host Connection Program3-93Error Message0789–126 Cannot send change direction notification to the host. . .Cause The ioctl subroutine was uns

Host Connection Program Guide and Reference3-94Error Message0789–130 BIND failure FM profile must be 3. . .Cause Byte 2 of the BIND image is not set t

Managing Host Connection Program3-95Error Message0789–137 BIND failure invalid bracket reset state. . .Cause Bit 2 of byte 6 of the BIND image is set

Host Connection Program Guide and Reference3-96Cause The HCON profile for the indicated session specifies a display session, andbyte 14 of the BIND im

Managing Host Connection Program3-97Error Message0789–183 BIND failure FMH data not allowed. . .Cause Bit 1 of byte 6 of the BIND image is set to B‘1’

Host Connection Program Guide and Reference1-4• International Language Support (ILS) for all SBCS countries currently supported by AIXJapanese, Korean

Host Connection Program Guide and Reference3-98Error Message0789–191 BIND failure SLU data compression is not supported. . .Cause Bit 6 of byte 5 of t

High-Level Language Application Programming Interface4-1Chapter 4. High-Level Language ApplicationProgramming InterfaceThe Host Connection Program (HC

Host Connection Program Guide and Reference4-2e789lus Emulator child process for DFT SNA protocol processingfxfer File File transfer parent processdf

High-Level Language Application Programming Interface4-3HLLAPI ComponentsThe HLLAPI components of HCON provide comprehensive communications capabiliti

Host Connection Program Guide and Reference4-4Uses of HLLAPIHLLAPI is a valuable tool in a variety of work environments. It provides interaction betwe

High-Level Language Application Programming Interface4-5HLLAPI ConnectionsHLLAPI supports the following 3270 connections:• Distributed Function Termin

Host Connection Program Guide and Reference4-6The term “current connection” refers to the most recent connection between the HLLAPIapplication program

High-Level Language Application Programming Interface4-7Programming with HLLAPIHLLAPI supports three different languages: C, COBOL, and FORTRAN. The s

Host Connection Program Guide and Reference4-8CALL “COBLIM” USING FUNC STR DLEN RETC.The parameter types are defined as:01 FUNC PIC S9(4) COMP.01 DLEN

High-Level Language Application Programming Interface4-9HLLAPI Functions by Function NumberThe following lists the HLLAPI functions organized by funct

Host Connection Program Overview1-5HCON also runs on the following ASCII terminals using 3278/79 Model 2 emulation orModel 5 on IBM 3151 using the ex

Host Connection Program Guide and Reference4-10Summary of Prerequisite Calls for HLLAPI FunctionsThis table lists the prerequisite calls for each HLLA

High-Level Language Application Programming Interface4-11CONNECT PRESENTATION SPACE (1)PurposeEstablishes a connection between a HLLAPI application pr

Host Connection Program Guide and Reference4-12RemarksWhen establishing a connection between your HLLAPI application and a specific host PS,remember t

High-Level Language Application Programming Interface4-13CONVERT POSITION or CONVERT ROWCOL (99)PurposeConverts the host presentation space (PS) posit

Host Connection Program Guide and Reference4-140 Specifies that incorrect column input was provided.>0 Specifies that this is the PS position or

High-Level Language Application Programming Interface4-15COPY FIELD TO STRING (34)PurposeTransfers characters from a field in the host-connected prese

Host Connection Program Guide and Reference4-167 Indicates the host PS position is invalid.9 Indicates that a system error occurred.24 Specifies th

High-Level Language Application Programming Interface4-17COPY OIA (13) PurposeReturns the current Operator Information Area (OIA) data from the host P

Host Connection Program Guide and Reference4-18OIA Group Bit Meanings and Corresponding Images for 3270 SessionsThe following is a breakdown of each O

High-Level Language Application Programming Interface4-19BitMeaningData StringStarting PositionMFI Hex Code Points0 Reserved1 APL 37 A0AFABF6F62-7 Res

Host Connection Program Guide and Reference1-6• For TCP/IP attachment using the Telnet 3270 function, the following are supported:– Token-Ring High-Pe

Host Connection Program Guide and Reference4-20BitMeaningData StringStarting PositionMFI Hex Code Points0 Reserved1 Reserved2 Machine check 10 C6F6ACA

High-Level Language Application Programming Interface4-21BitMeaningData StringStarting PositionMFI Hex Code Points0-7 ReservedTable 10. Group 9 (offse

Host Connection Program Guide and Reference4-22BitMeaningData StringStarting PositionMFI Hex Code Points0-7 ReservedTable 18. Group18 (offset 103): En

High-Level Language Application Programming Interface4-23COPY PRESENTATION SPACE (5)PurposeCopies the contents of the host presentation space (PS) int

Host Connection Program Guide and Reference4-24RemarksThe COPY PRESENTATION SPACE function translates the characters from the host PSinto ASCII format

High-Level Language Application Programming Interface4-25If the copy starts at the second byte of a DBCS character or ends at the first byte, this byt

Host Connection Program Guide and Reference4-26COPY PRESENTATION SPACE TO STRING (8)PurposeCopies all or part of the host-connected Presentation Space

High-Level Language Application Programming Interface4-27The EXTENDED ATTRIBUTES BYTES (EAB) option under the SET SESSIONPARAMETERS (9) function can b

Host Connection Program Guide and Reference4-28The COPY PRESENTATION SPACE TO STRING function is affected by theATTRB/NOATTRB, EAB/NOEAB, EAD/NOEAD, a

High-Level Language Application Programming Interface4-29Byte 2:Bit position Character position Field attributes position0 Reserved Left vertical line

Host Connection Program Overview1-7• System/370 or System/390 Host-Support File Transfer Program (IND$FILE) for VirtualMachine/Conversational Monitor

Host Connection Program Guide and Reference4-30COPY STRING TO FIELD (33)PurposeTransfers a string of characters into a specified field in the host-con

High-Level Language Application Programming Interface4-31the COPY STRING TO FIELD function. (For information on keyboard mnemonics, see theSEND KEY (3

Host Connection Program Guide and Reference4-32COPY STRING TO PRESENTATION SPACE (15)PurposeCopies an ASCII data string directly into the host Present

High-Level Language Application Programming Interface4-33RemarksThe COPY STRING TO PRESENTATION SPACE function is affected by theSTRLEN/STREOT, and th

Host Connection Program Guide and Reference4-34DISCONNECT PRESENTATION SPACE (2) PurposeDrops the connection between your HLLAPI application program a

High-Level Language Application Programming Interface4-35FIND FIELD LENGTH (32)PurposeReturns the length of a target field in the connected Presentati

Host Connection Program Guide and Reference4-369 Indicates a system error occurred.24 Indicates that no such field was found, or that PS isunformatt

High-Level Language Application Programming Interface4-37FIND FIELD POSITION (31)PurposeReturns the beginning position of a target field in the host c

Host Connection Program Guide and Reference4-38ret The following fields are valid:0 Indicates the FIND FIELD POSITION function wassuccessful.1 Indic

High-Level Language Application Programming Interface4-39GET KEY (51)PurposeIntercepts keystrokes from sessions specified by the START KEYSTROKE INTER

Host Connection Program Guide and Reference1-8

Host Connection Program Guide and Reference4-40Position 2 A code character, which is one of the following:• A for ASCII-returned• M for keystroke mne

High-Level Language Application Programming Interface4-4125 Specifies that the requested keystrokes are not availableon the input queue.31 Specifies

Host Connection Program Guide and Reference4-42PAUSE (18)PurposeWaits for a specified amount of time in any application where a time interval is desir

High-Level Language Application Programming Interface4-43Once a PAUSE function call has been satisfied by a host event, the QUERY HOSTUPDATE (24) func

Host Connection Program Guide and Reference4-44POST INTERCEPT STATUS (52) PurposeInforms the user that a keystroke obtained through the GET KEY (51) f

High-Level Language Application Programming Interface4-45RemarksThe POST INTERCEPT STATUS function informs the user that a keystroke obtainedthrough t

Host Connection Program Guide and Reference4-46QUERY CURSOR LOCATION (7)PurposeReturns the cursor position from the presentation space (PS).Prerequisi

High-Level Language Application Programming Interface4-47QUERY FIELD ATTRIBUTE (14)PurposeReturns the attribute byte of the field containing the input

Host Connection Program Guide and Reference4-483270 Field AttributeBit Position Meaning0-1 Both = 1, field attribute byte2 Unprotected/protected:• 0 =

High-Level Language Application Programming Interface4-49QUERY HOST UPDATE (24)PurposeEnables the programmed operator to determine if the host has upd

Using Host Connection Program2-1Chapter 2. Using Host Connection ProgramThe Host Connection Program (HCON) emulates a 3278/79 display or a 3286/87 pri

Host Connection Program Guide and Reference4-50QUERY SESSIONS (10)PurposeReturns the valid number of configured host sessions for a user.Prerequisite

High-Level Language Application Programming Interface4-51RemarksThe QUERY SESSIONS function returns the valid number of configured host sessions for a

Host Connection Program Guide and Reference4-52QUERY SESSION STATUS (22) PurposeObtains session-specific information for any configured session of a u

High-Level Language Application Programming Interface4-53Position 11 Session characteristics, expressed as a binary numbercontaining the following ses

Host Connection Program Guide and Reference4-54QUERY SYSTEM (20)PurposeDetermines the level of the HLLAPI and HCON support and other system-related va

High-Level Language Application Programming Interface4-55RECEIVE FILE (91)PurposeTransfers a file from the host session to the workstation session.Pre

Host Connection Program Guide and Reference4-56–I Specifies file transfer options placed directly within theIND$FILE command. This option also allows

High-Level Language Application Programming Interface4-57RELEASE (12)PurposeFrees blocked user input that was prohibited by the RESERVE (11) function.

Host Connection Program Guide and Reference4-58RESERVE (11)PurposeBlocks the currently connected host presentation space (PS) from user input.Prerequi

High-Level Language Application Programming Interface4-59RESET SYSTEM (21)PurposeReinitializes HLLAPI to its starting state.Prerequisite CallsThis fun

Host Connection Program Guide and Reference2-2S/390 Host Double-Byte Character Set EmulationHCON allows emulation for a double-byte character set (DBC

Host Connection Program Guide and Reference4-60SEARCH FIELD (30) PurposeExamines a field within the connected host Presentation Space (PS) for the occ

High-Level Language Application Programming Interface4-61(row 1, column 1) is position 1. This function can be used to search either protected orunpro

Host Connection Program Guide and Reference4-62SEARCH PRESENTATION SPACE (6) PurposeEnables your HLLAPI program to examine the host Presentation Space

High-Level Language Application Programming Interface4-63• If the string is found, then the returning length is set to the string’s beginning location

Host Connection Program Guide and Reference4-64SEND FILE (90)PurposeTransfers a file from the workstation session where HLLAPI is running to a host se

High-Level Language Application Programming Interface4-65–I Specifies file transfer options placed directly within theIND$FILE command. This option a

Host Connection Program Guide and Reference4-66To upload the newfile file to a TSO environment with a complete destination file name ofsys4.parmlib.sa

High-Level Language Application Programming Interface4-67SEND KEY (3)PurposeSends either a keystroke or a string of keystrokes to the currently connec

Host Connection Program Guide and Reference4-683. The NORESET option is not the same as the RESET SYSTEM(21) function.Keyboard MnemonicsKeyboard mnemo

High-Level Language Application Programming Interface4-69Mnemonics with Lowercase Numbers or LettersASCII Mnemonic Meaning@e PF14@f PF15@g PF16@h PF17

Using Host Connection Program2-3HCON Sessions and Session ProfilesA display session begins with a logon to a mainframe host and ends when the connecti

Host Connection Program Guide and Reference4-70ASCII Mnemonics Using Data Keys and Combinations of “Shift”(@S) and “@” Uppercase Alpha KeysASCII Mnemo

High-Level Language Application Programming Interface4-71by the user. You can also send all attention identifier (AID) keys such as Enter or PA1. Allh

Host Connection Program Guide and Reference4-72SET CURSOR (40)PurposeSets the position of the cursor within the currently connected host Presentation

High-Level Language Application Programming Interface4-73SET SESSION PARAMETERS (9)PurposeEnables you to change certain default session options in HLL

Host Connection Program Guide and Reference4-74Session OptionsThe following are session options are represented below. The default session options are

High-Level Language Application Programming Interface4-75Option 4 The following values affect the search functions SEARCH FIELD (30) andSEARCH PRESENT

Host Connection Program Guide and Reference4-76Option 8 The following values affect the WAIT (4) function and the GET KEY (51)function.Value Explanat

High-Level Language Application Programming Interface4-77Value ExplanationTROFF Turns trace off.TRON Turns trace on. When TRON is in effect, all execu

Host Connection Program Guide and Reference4-78NOSO Shift-out (SO) and shift-in (SI) control characters areeliminated from the presentation space data

High-Level Language Application Programming Interface4-79START HOST NOTIFICATION (23)PurposeDetermines if the designated host Presentation Space (PS)

Host Connection Program Guide and Reference2-4Session ProfilesSession profiles define the characteristics of either a printer or a display session. De

Host Connection Program Guide and Reference4-80Position 3 Replace with one of the following characters if position 2 isA:P Asks for notification of P

High-Level Language Application Programming Interface4-81START KEYSTROKE INTERCEPT (50) PurposeEnables an HLLAPI application to filter any keystrokes

Host Connection Program Guide and Reference4-822 Specifies that an invalid option was specified.4 Specifies that resource was unavailable; the reque

High-Level Language Application Programming Interface4-83STOP HOST NOTIFICATION (25)PurposePrevents the QUERY HOST UPDATE (24) function from determini

Host Connection Program Guide and Reference4-84STOP KEYSTROKE INTERCEPT (53)PurposeEnds your application program’s ability to intercept keystrokes.Pre

High-Level Language Application Programming Interface4-85WAIT (4)PurposeChecks the status of the host presentation space (PS).Prerequisite CallsThis f

Host Connection Program Guide and Reference4-86The WAIT function determines if the host Operator Information Area (OIA) is inhibited.Note: The 3270 te

High-Level Language Application Programming Interface4-87Sample C HLLAPI ProgramThis sample program is part of the software offering for the HLLAPI fu

Host Connection Program Guide and Reference4-88/******************************************************************//*************************** DEFINE

High-Level Language Application Programming Interface4-89/******************* HLLAPI variables*****************************/unsigned int hfunc_num;

Using Host Connection Program2-5HCON Profile Fields and Associated Command Flags HCON session characteristics are specific to the session type.Display

Host Connection Program Guide and Reference4-90/******************************************************************//************************** BEGIN C

High-Level Language Application Programming Interface4-91 if (rc == 0){ printf(”Press ENTER to search for string ’”); printf(host_text)

Host Connection Program Guide and Reference4-92 fputc(data_ptr–>qsys_hllapi_ver,stdout); printf(”\n”); printf(” HLLAPI level : ”);

High-Level Language Application Programming Interface4-93*/ /* displays the requested session info. *//**//**//*******************

Host Connection Program Guide and Reference4-94 { printf(”Host”); if (!(dft_sess)){ /* First HOST not set alreaCS2C */

High-Level Language Application Programming Interface4-95 printf(”DFT non–SNA printer”); } printf(”\n”);

Host Connection Program Guide and Reference4-96 hllc(&hfunc_num, (char * )hdata_str, &hds_len, &hrc); /* C

High-Level Language Application Programming Interface4-97/******************************************************************//*DISP_HOST_SCR - Display

Host Connection Program Guide and Reference4-98/******************************************************************//* WRT_STR – Writes char string to

Programming the Host Connection Program5-1Chapter 5. Programming the Host Connection ProgramThe Host Connection Program (HCON) emulates a 3278/79 disp

Bull DPX/20HCON Guide and ReferenceAIXSoftwareDecember 1996Bull Electronics Angers S.A.CEDOCAtelier de Reprographie331 Avenue Patton49004 ANGERS CEDEX

Host Connection Program Guide and Reference2-6Printer SessionsThis table shows valid SMIT dialog fields and flags for the mkhcons and chhconscommands

Host Connection Program Guide and Reference5-2File Transfer Program InterfaceThe File Transfer Programming Interface permits the transfer of files bet

Programming the Host Connection Program5-3not necessary to specify the FXC_REPL option when uploading to a communicationinterrupt control program (CIC

Host Connection Program Guide and Reference5-4Compiling Example ProgramsFor information about how to debug, compile, and link HCON programming applica

Programming the Host Connection Program5-5VM/CMS File Transfer Program ExampleThe following program illustrates the file transfer process using the fi

Host Connection Program Guide and Reference5-6 xfer–>fxc_opts.f_flags | = FXC_CMS; /* VM/CMS host */ xfer–>fxc_opts.f_logonid = (ch

Programming the Host Connection Program5-7FORTRAN File Transfer Program ExampleThe following programming example shows the downloading procedure for t

Host Connection Program Guide and Reference5-8C SAMPLE PROGRAM ”sample fname”C THIS FORTRAN PROGRAM WILL DOWNLOAD THE TSO FILE test.file TOC THE AIX T

Programming the Host Connection Program5-9Pascal File Transfer Program ExampleThe following programming example displays how to use the pfxfer functio

Host Connection Program Guide and Reference5-10begin new(source, 256);new(destin, 256);new(profid, 256);new(login, 102);new(inputfld, 64);source@ :=

Programming the Host Connection Program5-11HCON Programming ReferencesHCON programming references include functions, header files, status codes, examp

Using Host Connection Program2-7Xwindow 3270 Emulator (xhcon)The xhcon command is the Motif version of the e789 command. It has all of thefunctionalit

Host Connection Program Guide and Reference5-12Compiling a File Transfer ProgramThis article describes how to compile a File Transfer Program.Prerequi

A-1HLLAPI Return CodesAppendix A. HLLAPI Return CodesThis appendix describes the standard return codes for HLLAPI.Return Codes OverviewCheck the retur

A-2Host Connection Program Guide and ReferenceStandard Return CodesReturnCodeExplanation11 The resource that you requested is unavailable (for example

A-3HLLAPI Return CodesFile Transfer Error CodesThis table describes the standard return codes for the SEND FILE and RECEIVE FILEfunctions of HLLAPI.Fi

A-4Host Connection Program Guide and ReferenceFile Transfer Error CodesErrorCodeUser ResponseError Description218 An incorrect option has beenspecifie

A-5HLLAPI Return CodesFile Transfer Error CodesErrorCodeUser ResponseError Description259 Cannot send an interrupt signal tokill the dfxfer file trans

A-6Host Connection Program Guide and ReferenceFile Transfer Error CodesErrorCodeUser ResponseError Description279 Transfer Status: The file transfer r

A-7HLLAPI Return CodesFile Transfer Error CodesErrorCodeUser ResponseError Description286 Transfer Status:The file transfer request wascancelled by th

A-8Host Connection Program Guide and ReferenceFile Transfer Error CodesErrorCodeUser ResponseError Description293 Transfer Status:The file transfer re

A-9HLLAPI Return CodesFile Transfer Error CodesErrorCodeUser ResponseError Description301 Transfer Status:The file transfer request wascancelled by th

Host Connection Program Guide and Reference2-8For international language support, the double-byte character set (DBCS) countries havetheir own applica

A-10Host Connection Program Guide and ReferenceFile Transfer Error CodesErrorCodeUser ResponseError Description309 Transfer Status:The file transfer r

A-11HLLAPI Return CodesFile Transfer Error CodesErrorCodeUser ResponseError Description315 Transfer Status:The file transfer completed with onewarning

A-12Host Connection Program Guide and ReferenceFile Transfer Error CodesErrorCodeUser ResponseError Description326 Transfer Status:The file transfer r

A-13HLLAPI Return CodesFile Transfer Error CodesErrorCodeUser ResponseError Description335 Transfer Status:The file transfer request wascancelled.Diag

A-14Host Connection Program Guide and ReferenceFile Transfer Error CodesErrorCodeUser ResponseError Description345 Transfer Status:The file transfer r

X-1IndexIndexNumbers3270 host connection program. See HCON3270 keyboard, 2-143274/3174 control unit, 3-67370 host configuration, 3-665088/6098 graphic

X-2Host Connection Program Guide and Referenceheader files, 5-3interruption, 5-2overview, 5-2–5-3security, 5-2file transfer utility programmenusCICS,

X-3IndexNNational Language Support (NLS), 1-3OOIAerror codes, 2-21fields, 2-19–2-21Operator Information Area. See OIAoverview, HCON, 1-1PPAUSE (18) fu

X-4Host Connection Program Guide and ReferenceUupdating, HCON, 3-48users, defining, 3-2utility programfile transfer facility, 2-58message window, 2-63

Vos remarques sur ce document / Technical publication remark formTitre / Title :Bull DPX/20 HCON Guide and Reference Nº Reférence / Reference Nº :86

Using Host Connection Program2-9The Function Key Window screen shows the layout of the Function Key window when it isfirst activated.Function KeysFunc

Bull Electronics Angers S.A.CEDOCAtelier de Reprographie331 Avenue Patton49004 ANGERS CEDEX 01FRANCE86 A2 74WG 02ORDER REFERENCEPLACE BAR CODE IN LOWE

Utiliser les marques de découpe pour obtenir les étiquettes.Use the cut marks to get the labels.AIX86 A2 74WG 02HCON Guide andReferenceDPX/20AIX86 A2

Host Connection Program Guide and Reference2-101. Log on to AIXwindows Desktop.2. Open an Application Manager window. Make sure you are at the top lev

Using Host Connection Program2-11xhconWindow CharacteristicsSession Utility Keys 123Menu Bar: The user can select Sessions, Utility, and Keys from the

Host Connection Program Guide and Reference2-12Utility: This option is a productivity session for various personal configurations.The following button

Using Host Connection Program2-133270 EmulatorThe e789 command emulates a 3278/79 display attached to a System/390 computer. Thee789pr command emulate

Host Connection Program Guide and Reference2-143270 KeyboardThe Host Connection Program’s e789 and xhcon commands provide special characteristicsfor u

Using Host Connection Program2-15Note: The SYSREQ and ATTN keys are only used for SNA connections.The ATTN key is always supported by TCP/IP.BACKSPACE

The following copyright notice protects this book under the Copyright laws of the United States and othercountries which prohibit such actions as, but

Host Connection Program Guide and Reference2-16DUP Informs the application program a duplicate operation is indicated for therest of the field where i

Using Host Connection Program2-17Note: The following special emulator keys, related to four-byte operations,are not supported in the DBCS environment:

Host Connection Program Guide and Reference2-18REFRESH Refreshes the current screen on the active display session.REPLS Replaces the contents of the r

Using Host Connection Program2-19Operator Information Area (OIA)When using the 3270 Host Connection Program, the last line on the display screen is th

Host Connection Program Guide and Reference2-20Input-Inhibited FieldColumn Symbol Description9 X ( ) The host system needs time to perform a function.

Using Host Connection Program2-21Note: For SNA standalone sessions, the SNA Logical Connection Profile name isright-justified in the session use field

Host Connection Program Guide and Reference2-22Input-Inhibited Field Error CodesError Code User ResponseExplanation703 Unsupported requestreceivedPres

Using Host Connection Program2-23Input-Inhibited Field Error CodesError Code User ResponseExplanation719 BIND SLU protocol notvalidPress the RESET key

Host Connection Program Guide and Reference2-24Input-Inhibited Field Error CodesError Code User ResponseExplanation752 Address out of range forSBA, RA

Using Host Connection Program2-25Input-Inhibited Field Error CodesError Code User ResponseExplanation798 SO/SI are received inDBCS field or GE isrecei

iiiPrefaceAbout This BookThis book contains conceptual and procedural information about the Host ConnectionProgram (HCON) facility. Topics covered inc

Host Connection Program Guide and Reference2-26Using Default 3270 KeyboardsThe 3270 Host Connection Program is shipped with default keyboard mappings

Using Host Connection Program2-27TERM Environment VariablesTerminalTypeTERMVariableDescriptionsWYSE wy60 24x80 (model 2)*WYSE wy370 24x80 (model 2)*No

Host Connection Program Guide and Reference2-28Using Display Session on Server and Station KeyboardsThis table contains the default key functions on S

Using Host Connection Program2-29Default e789 Key Functions on Server and StationKeyboardsFunction PressFunctionPressPF11 F11 CLICK Ctrl-Y*PF12 F12 JO

Host Connection Program Guide and Reference2-30Using Display Session on 3151, 3161, 3162, 3163, and 3164KeyboardsFor the display session to function p

Using Host Connection Program2-31Default Key Functions on 3151, 3161/62/63/64 KeyboardsFunction PressFunctionPressCHGDIS N/A PF20 Shift-F8INSERT Inser

Host Connection Program Guide and Reference2-32Using Display Session on DEC VT100 KeyboardsThe DEC VT100 must be configured with the keypad in applica

Using Host Connection Program2-33Default Key Functions on DEC VT100 KeyboardsFunction PressFunctionPressPF4 PF4 POREST Ctrl-PPF5 Keypad 7 RESET Ctrl-R

Host Connection Program Guide and Reference2-34Using Display Session on DEC VT220 KeyboardsFor the e789 command to function properly, the DEC VT220 mu

Using Host Connection Program2-35Default Key Functions on DEC VT220 KeyboardsFunction PressFunctionPressPF8 F8 HCONUTIL Ctrl-VPF9 F9 DELWORD Ctrl-WPF1

ivHost Connection Program Guide and Reference3270 Information Display System 3174 Subsystem Control Unit Customization Guide3270 Information Display S

Host Connection Program Guide and Reference2-36Using Display Session on WYSE KeyboardsFor the e789 command to function properly, the WYSE WY-50 must b

Using Host Connection Program2-37Default Key Functions on WYSE WY-50 and WYSE WY-60 KeyboardsFunction PressFunctionPressPF6 F6 DUP Ctrl-UPF7 F7 HCONUT

Host Connection Program Guide and Reference2-38The following table contains the default key functions for the WYSE WY-370 terminalkeyboards. See “Spec

Using Host Connection Program2-39Default Key Functions on WYSE WY-370 KeyboardFunction PressFunctionPressPF12 F12 ATTN Ctrl-ACURSEL Ctrl-L

Host Connection Program Guide and Reference2-40HCON Utility Program OverviewThe utility program is a menu-driven interface for customizing portions of

Using Host Connection Program2-41The Color Redefinition Menus figure shows the color definition options.UnprotectedIntensifiedProtectedProtectedIntens

Host Connection Program Guide and Reference2-42File Transfers with the Utility ProgramFile transfers with the utility program are explicit file transf

Using Host Connection Program2-43HCON Utility Program Keys and FieldsThe utility program uses several types of keys and fields to perform its function

Host Connection Program Guide and Reference2-44F10 Esc-0F12 Esc-2Up Arrow and Down Arrow KeysThe Up Arrow and Down Arrow keys move the cursor up and d

Using Host Connection Program2-45display Indicates the current value of the field. A display field can usually bechanged by a selection process or fro

vPrefaceContentsChapter 1. Host Connection Program Overview 1-1. . . . . . . . . . . . . . . . . . . . . . . . . . . HCON Capabilities 1-2. . . . . .

Host Connection Program Guide and Reference2-46The Heading and Message Fields figure shows the HCON utility program Main Menu with aheading and messag

Using Host Connection Program2-47Customizing HCON Color and Highlight Values with the UtilityProgramColor and highlight values are redefined for each

Host Connection Program Guide and Reference2-48Each 3270 field displays by category as illustrated on the Color Redefinition Main Menuscreen. Press th

Using Host Connection Program2-49– BLUE– MAGENTA– CYAN– WHITE• Highlight Values– NORMAL– UNDERLINE– BLINK– REVERSE– BRIGHTDefine foreground color, bac

Host Connection Program Guide and Reference2-50Customizing the HCON Color Definition TableThis procedure explains how to customize the Color Definitio

Using Host Connection Program2-51Customizing the HCON Keyboard Definition TableThis procedure explains how to customize the Keyboard Definition Table

Host Connection Program Guide and Reference2-52Customizing HCON Key Definitions with the Utility ProgramCustomize the keyboard functions using the uti

Using Host Connection Program2-53Note: The ENTER, RESET, and QUIT key map values must be assigned to at least onephysical key.Redefining Keyboard Valu

Host Connection Program Guide and Reference2-54Meta/3270 Control KeysHCON Utility Programctrl – a [ BTABW ]Physical Keyctrl – b [ EOF ]ctrl – c [

Using Host Connection Program2-55HCON File TransfersThe HCON file transfer facility transfers files from a local system to a System/370 host overa dis

viHost Connection Program Guide and ReferencePrerequisites 2-50. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Host Connection Program Guide and Reference2-56Session Profiles for File TransfersFor a file transfer, the session profile can define:• Communication

Using Host Connection Program2-57How file transfers are restarted depends on whether the new file transfer is implicit orexplicit:• Explicit transfers

Host Connection Program Guide and Reference2-58HCON Utility Program File Transfer FacilityUse the HCON utility program to issue explicit file transfer

Using Host Connection Program2-59RESTART file. Highlight a choice and press the Enter key to accept the choice. The Restartmenu displays the following

Host Connection Program Guide and Reference2-60The CMS Menu for the File Transfer Facility in a DBCS Environment figure shows anexample menu for file

Using Host Connection Program2-61Explicit File Transfer=>HCON Utility ProgramF1–help F12–returnF3–exitF2–refreshHCON session profile is ’a’. Press

Host Connection Program Guide and Reference2-62The second TSO/DBCS figure shows page 2 of 2 of the TSO menu in a DBCS environment,containing the optio

Using Host Connection Program2-63Explicit File Transfer=>HCON Utility ProgramF1–help F12–returnF3–exitF2–refreshHCON session profile is ’a’. Press

Host Connection Program Guide and Reference2-64Toggle FieldsThe toggle fields have a limited number of values. Use the Left Arrow and Right Arrow keys

Using Host Connection Program2-65Specify this option when the Translation field is text or DOS. This fieldis only available in a Japanese language env

viiPrefaceStarting and Controlling a Printer Session 3-19. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3270 Data Stream Support for

Host Connection Program Guide and Reference2-66direction is up, this is the name of a host file. If the transfer direction isdown, this is the full pa

Using Host Connection Program2-67HCON Host Logon ProceduresBefore information can be exchanged between a local system and a host system, you mustlog o

Host Connection Program Guide and Reference2-68ID, the string can contain the optional AUTOLOG Trace and AUTOLOG Timeout parametervalues. Each paramet

Using Host Connection Program2-69Creating and Testing an HCON AUTOLOG ScriptThis procedure explains how to create and verify and HCON AUTOLOG script.P

Host Connection Program Guide and Reference2-70Example AUTOLOG ScriptThe following example shows an AUTOLOG script that logs on to a CMS system whilep

Using Host Connection Program2-71Using an HCON AUTOLOG ScriptThis procedure explains how to use an HCON AUTOLOG script.PrerequisiteAn AUTOLOG script m

Host Connection Program Guide and Reference2-72Debugging an HCON AUTOLOG ScriptThis procedure explains how to debug an HCON AUTOLOG script.Prerequisit

Using Host Connection Program2-73Using the HCON Utility Program Logon and Logoff FacilityThe utility program logon and logoff facility enables automat

Host Connection Program Guide and Reference2-74Logoff Screen Contains two types of fields: Session Name and Status. The LogoffScreen figure shows an e

Using Host Connection Program2-75Logon/Logoff Status WindowDisplays the status of a logon or logoff request. The window displays afterthe logon or log