• Communications
• Preface
• Notices
  • Trademarks
• About this book
  • Who this book is for
  • What's new?
    • VAST Platform 2021 (version 10.0.0)
  • Conventions used in this book
  • Tell us what you think
• User Guide
  • Communications Subsystem design
    • Dialog layer
    • System layer
    • System interface layer
    • Deciding which layer to use
  • The Communications/Transactions feature in VA Smalltalk
    • Using the dialog layer
      • Adding a Proc Dialog
      • Setting up an APPC conversation
      • Setting up a CICS transaction
      • Setting up a CPI-C conversation
      • Setting up an MQI conversation
      • Setting up an RPC/XDR conversation
      • Specifying function-call details
      • Setting up a TCP/IP socket
      • Using a Proc Dialog in an application
    • Using the system layer
      • Adding a Connection part
      • Adding a Connection Spec part
      • Adding a reception part
      • Connecting and disconnecting (except RPC and CICS)
        • To connect to the remote server
        • To disconnect from the server
      • Sending and receiving data (except RPC and CICS)
        • To send data to the server
        • To receive data from the server
      • Handling errors
      • Using the system layer in an application
    • Using the RPC system layer
      • Adding a RPC Client part
      • Adding a RPC Connection Spec.
      • Executing an RPC transaction
      • Handling errors
    • Using the CICS ECI system layer
      • Adding a CICS Program
      • Adding a CICS Logical Unit of Work
      • Executing a CICS transaction
    • Server programming with VA Smalltalk
  • Communications programming with basic VA Smalltalk
    • The dialog layer
      • AbtConnectionSpec protocol
        • APPC ConnectionSpec
        • CICS ConnectionSpec
        • MQI ConnectionSpec
        • RPC ConnectionSpec
        • TCP/IP ConnectionSpec
      • Dialog protocols
        • Simple dialogs
        • Multi-receive dialogs
        • Multi-send dialogs
        • Proc dialogs
    • The system layer
      • Using the APPC system layer
        • Creating a new local transaction program
        • Establishing a new conversation
        • Sending and receiving messages
        • Detecting errors
        • Using APPC in Windows
        • Using APPC in AIX
      • Using the CICS system layer
        • Creating a transaction (logical unit of work) object
        • Running multiple programs as one LUW
        • Creating a program object
        • Accessing the program
        • Running a program and storing the results
        • Checking for errors
        • Committing and rolling back changes
        • Using CICS in AIX
      • Using the CPI-C system layer
        • Establishing a new conversation
        • Sending and receiving messages
        • Detecting errors
        • Using CPI-C in Windows
        • Using CPI-C IN AIX
      • Using the MQ Series system layer
        • Defining and connecting to a queue manager
        • Defining and opening a queue
        • Querying the queue type
        • Defining a Distribution List
        • Sending and receiving messages
        • Closing the queue
        • Disconnecting from the queue manager
        • MQ Series client and server support
        • Using the AbtMQConnection class
        • Defining an AbtMQConnectionSpec
        • Connecting to a queue manager and opening input and output queues
        • Putting a message to the output queue
        • Reading a message from the input queue
        • Defining a unit of work
        • Disconnecting from the queue manager and closing the queues
      • Using the TCP/IP system layer
        • Defining and connecting a remote host
        • Sending and receiving data
        • Ending the connection
        • Handling Errors
      • Using the RPC/XDR client system layer
        • Defining and connecting to a RPC server
        • Executing the transaction
        • Destroy the client handle
      • Using the RPC/XDR server system layer
        • Defining a RPC server
        • Unregister from PortMapper and destroy the server handle
        • Handling Errors
  • Server programming with basic VA Smalltalk
  • Communications/Transactions feature EHLLAPI support
    • What is EHLLAPI?
    • Why use EHLLAPI?
    • Using EHLLAPI with VA Smalltalk parts
      • Adding a 3270 Screen part
      • Tailoring a 3270 Screen part
      • Using 3270 screens in an application
        • Actions
        • Events
        • Attributes
      • Example program using a 3270 screen part
        • Building the window
        • Tailoring the 3270 Screen part
        • Connecting the parts
    • Using EHLLAPI with Smalltalk code
      • Basic EHLLAPI classes
      • 3270 Terminal example method
• Writing communications applications for the server
  • Writing APPC transaction programs
    • Writing APPC applications for CICS
      • Writing a front-end transaction program for CICS
        • Step 1: Allocating a session to the conversation
        • Step 2: Connecting the partner transaction
        • Step 3: Sending data to the partner transaction
        • Step 4: Receiving data from the partner transaction
        • Step 5: Ending the conversation
      • Writing a back-end transaction program for CICS
        • Step 1: Obtaining the conversation identifier
        • Step 2: Retrieving conversation characteristics
        • Step 3: Receiving data from the front-end transaction
    • Writing APPC applications with the VA Smalltalk APPC classes
      • Writing a front-end transaction program
        • Step 1: Defining a conversation
        • Step 2: Allocating the conversation
        • Step 3: Sending data to the partner transaction
        • Step 4: Receiving data from the partner transaction
        • Step 5: Ending the conversation
      • Writing a back-end transaction program
        • Step 1: Accepting the conversation
        • Step 2: Retrieving conversation characteristics
        • Step 3: Receiving data from the front-end transaction
  • Using MVS CICS options
  • Writing a CPI-C application
    • Writing CPI-C applications for VA Smalltalk Server
      • Writing a front-end transaction program
        • Step 1: Defining a conversation
        • Step 2: Allocating a conversation
        • Step 3: Sending data to the partner transaction
        • Step 4: Receiving data from the partner transaction
        • Step 5: Ending the conversation
      • Writing a back-end transaction
        • Step 1: Accepting the conversation
        • Step 2: Retrieving conversation characteristics
        • Step 3: Receiving data from the front-end transaction
  • Writing an MQSeries application
    • Writing MQSeries applications for VA Smalltalk Server
      • Step 1: Instantiating the connection
      • Step 2: Connecting to the queue manager
      • Step 3: Opening the queue
      • Step 4: Putting messages on a queue
      • Step 5: Getting messages from a queue
      • Step 6: Closing the queue and disconnecting
      • Step 7: Disconnecting from the queue
  • Writing a TCP/IP application
    • Creating a database application that uses TCP/IP to access a server
      • Creating an application
      • Adding database function
      • Defining a client user interface
      • Defining a database record
      • Defining a TCP/IP server
      • Testing your application
• Sample Programs
  • TCP/IP
    • Installing the Communications/Transactions feature's TCP/IP support
    • Using TCP/IP Sockets
      • Building the client application
        • Making the connections
      • Building the server application
        • Defining the attributes
        • Creating the scripts
        • Creating the user interface
        • Making the connections
      • Testing the application
• Parts Reference
  • 3270 HLLAPI
    • 3270 Screen part
      • 3270 Screen Settings -- General
        • Terminal
        • Settle time
        • Key sequence validation string
        • Build records
        • Dump to file
      • 3270 Screen Settings -- Input fields
        • Input fields
      • 3270 Screen Settings -- Output Fields
        • Output field
      • 3270 Screen Attributes
        • inputFields (String)
        • keyString (String)
        • lastError (<className>)
        • self (<className>)
        • settleTime (Integer)
        • shortSessionID (String)
        • terminal (Abt3270Terminal)
      • 3270 Screen Actions
        • clearInput
        • destroyPart
        • disableScreen
        • enableScreen
        • getData
        • press5250PgDown
        • press5250PgUp
        • pressClear
        • pressEnter
        • pressPA: (Integer)
        • pressPF: (Integer)
        • putData:
        • refreshFieldDefs
      • 3270 Screen Events
        • currentScreenUpdated
        • dataRefreshed
        • dataSent
        • destroyedPart
        • fieldDefsRefreshed
        • keySent
        • screenAppears
        • screenChanged
    • 3270 Terminal part
      • 3270 Terminal Attributes
        • cursorPosition (Point)
        • foundPosition (Point)
        • lastError (<className>)
        • self (<className>)
        • sessionID (String)
        • shortSessionID (String)
      • 3270 Terminal Actions
        • destroyPart
        • enter: (String) andWaitForString: (String)
        • enterCommand: (String)
        • findString: (String)
        • key5250PgDown
        • key5250PgUp
        • keyAttn
        • keyBacktab
        • keyClear
        • keyDelete
        • keyDown
        • keyEnter
        • keyEOF
        • keyEraseInput
        • keyHome
        • keyLeft
        • keyPA: (Integer)
        • keyPF: (Integer)
        • keyRight
        • keyTab
        • keyUp
        • setInsertModeOn
        • setInsertModeOff
        • stringAt: (Point) for: (Integer)
        • type: (String)
      • 3270 Terminal Events
        • destroyedPart
        • errorOccurred
        • searchFailed
        • searchSuccessful
  • APPC Category
    • APPC Proc Dialog part
      • APPC Proc Dialog Settings -- Destination
        • Partner TP name
        • Partner LU alias
        • Fully qualified partner LU name
        • Userid
        • Password
        • Security
      • APPC Proc Dialog Settings -- Conversation
        • Local TP name
        • Local LU alias
        • Mode
        • Sync level
        • Return control
      • APPC Proc Dialog Settings -- Data Attributes
        • Code page
        • Buffer length
        • Big endian
      • APPC Proc Dialog Settings -- Records
        • Function language
        • File to Parse
        • Parse
        • Available records
        • Parameter word size
      • APPC Proc Dialog Attributes
        • connection (<className>)
        • connectionSpec (<className>)
        • prototypeSpec
        • self (<className>)
      • APPC Proc Dialog Actions
        • destroyPart
        • execute
      • APPC Proc Dialog Events
        • destroyedPart
    • APPC Conversation part
      • APPC Conversation Attributes
        • aReception (<className>)
        • isConnected (Boolean)
        • lastError (<className>)
        • self (<className>)
      • APPC Conversation Actions
        • confirm
        • confirmed
        • connect
        • destroyPart
        • disconnect
        • receive
        • receiveBuffer
        • receiveWithLengthInData
        • sendBuffer
        • sendErrorDirectionReceived
        • sendIncorporatingLength
        • sendRecord
        • sendString
        • sendStringAsLLAsciiZ
      • APPC Conversation Events
        • confirmReceived
        • connected
        • deallocateReceived
        • destroyedPart
        • disconnected
        • error
        • received
        • receivedCompleteData
        • sendReceived
        • sent
    • APPC Error part
      • APPC Error Attributes
        • codeAsString (String)
        • returnCode (Integer)
      • APPC Error Actions
        • debug
        • display
        • printOn:
    • APPC Connection Spec part
      • APPC Connection Spec Settings - Destination
        • Partner TP name
        • Partner LU alias
        • Fully qualified partner LU name
        • Userid
        • Password
        • Security
      • APPC Connection Spec Settings - Conversation
        • Local TP name
        • Local LU alias
        • Mode
        • Sync level
        • Return control
      • APPC Connection Spec Settings - Data Attributes
      • APPC Connection Spec Attributes
        • bigEndian (Boolean)
        • bufferLength (Integer)
        • codePage (Integer)
        • fqPartnerLUName (String)
        • localLUAlias (String)
        • localTPName (String)
        • mode (String)
        • returnControl (Integer)
        • returnControlString (String)
        • security (Integer)
        • securityString (String)
        • self (<className>)
        • syncLevel (Integer)
        • syncLevelString (String)
        • userID (String)
      • APPC Connection Spec Actions
        • destroyPart
      • APPC Connection Spec Events
        • destroyedPart
    • APPC Receive Buffer part
      • APPC Receive Buffer Settings - General
      • APPC Receive Buffer Attributes
        • asOSByteArray (OSByteArray)
        • contents (ByteArray)
        • contentsAsString (String)
        • conversationType (Integer)
        • length (Integer)
        • self (<className>)
        • whatRcvdData (Integer)
        • whatRcvdStatus (Integer)
        • whatReceivedDataAsString (String)
        • whatReceivedStatusAsString (String)
      • APPC Receive Buffer Actions
        • clearDataBuffer
        • destroyPart
        • free
        • initializeWith
        • initializeWith: (String)
        • putString
        • reset
      • APPC Receive Buffer Events
        • changed
        • confirmReceived
        • deallocateReceived
        • destroyedPart
        • sendReceived
        • statusChanged
  • CICS Category
    • CICS Proc Dialog part
      • CICS Proc Dialog Settings - Destination
        • Transaction ID
        • Program Name
        • Server Name
        • Time out
        • Userid
        • Password
      • CICS Proc Dialog Settings - MVS tab
      • CICS Proc Dialog Settings - Data Attributes
        • Code page
        • Buffer length
        • Big endian
      • CICS Proc Dialog Settings - Records
        • Function language
        • File to Parse
        • Parse
        • Parameter word size
        • Available records
      • CICS Proc Dialog Attributes
        • connection (<className>)
        • connectionSpec (<className>)
        • prototypeSpec
        • self (<className>)
      • CICS Proc Dialog Actions
        • destroyPart
        • execute
      • CICS Proc Dialog Events
        • destroyedPart
    • CICS Logical Unit of Work part
      • CICS Logical Unit of Work Attributes
        • lastError (<className>)
        • LUWToken (Integer)
        • self (<className>)
      • CICS Logical Unit of Work Actions
        • Begin
        • commit
        • destroyPart
        • Rollback
      • CICS Logical Unit of Work Events
        • BackedOut
        • Committed
        • destroyedPart
        • ErrorOccurred
    • CICS Program part
      • CICS Program Settings - Destination
        • Transaction ID
        • Program Name
        • Server Name
        • Time out
        • Userid
        • Password
      • CICS Program Settings - MVS tab
      • CICS Program Attributes
        • lastError (<className>)
        • programName (String)
        • self (<className>)
        • serverName (String)
        • timeOut (Integer)
        • transactionID (String)
        • userID (String)
      • CICS Program Actions
        • destroyPart
        • executeProgram
      • CICS Program Events
        • destroyedPart
        • ErrorOccurred
        • executed
  • CPI-C Category
    • CPI-C Proc Dialog part
      • CPI-C Proc Dialog Settings - Destination
        • Partner TP name
        • Partner LU alias
        • Symbolic destination
        • Userid
        • Password
        • Security
        • Mode
        • Sync level
        • Return control
      • CPI-C Proc Dialog Settings - Data Attributes
        • Code page
        • Buffer length
        • Big endian
      • CPI-C Proc Dialog Settings - Records
        • Function language
          • Parse
        • Parameter word size
        • Available records
      • CPI-C Proc Dialog Attributes
        • connection (<className>)
        • connectionSpec (<className>)
        • prototypeSpec
        • self (<className>)
      • CPI-C Proc Dialog Actions
        • destroyPart
        • execute
      • CPI-C Proc Dialog Events
        • destroyedPart
    • CPI-C Conversation part
      • CPI-C Conversation Attributes
        • aReception (<className>)
        • connectionSpec (<className>)
        • isConnected (Boolean)
        • lastError (<className>)
        • self (<className>)
        • stateAsString (String)
      • CPI-C Conversation Actions
        • confirm
        • confirmed
        • connect
        • destroyPart
        • disconnect
        • receive
        • receiveBuffer
        • receiveWithLengthInData
        • sendBuffer
        • sendErrorDirectionReceived
        • sendIncorporatingLength
        • sendRecord
        • sendString
        • sendStringAsLLAsciiZ
      • CPI-C Conversation Events
        • connected
        • destroyedPart
        • disconnected
        • error
        • received
        • receivedCompleteData
        • sent
    • CPI-C Connection Spec part
      • CPI-C Connection Spec Settings - Destination
        • Partner TP name
        • Partner LU alias
        • Symbolic destination
        • Userid
        • Password
        • Security
        • Mode
        • Sync level
        • Return control
      • CPI-C Connection Spec Settings - Data Attributes
        • Code page
        • Buffer length
        • Big endian
      • CPI-C Connection Spec Attributes
        • bigEndian (Boolean)
        • bufferLength (Integer)
        • codePage (Integer)
        • conversationType (Integer)
        • fill (Integer)
        • mode (String)
        • returnControl (Integer)
        • returnControlString (String)
        • security (Integer)
        • securityString (String)
        • self (<className>)
        • symDestName (String)
        • syncLevel (Integer)
        • syncLevelString (String)
        • userID (String)
      • CPI-C Connection Spec Actions
        • destroyPart
      • CPI-C Connection Spec Events
        • destroyedPart
    • CPI-C Receive Buffer part
      • CPI-C Receive Buffer Settings - General
      • CPI-C Receive Buffer Attributes
        • asOSByteArray (OSByteArray)
        • contents (ByteArray)
        • contentsAsString (String)
        • conversationType (Integer)
        • dataReceived (Integer)
        • dataReceivedAsString (String)
        • length (Integer)
        • self (<className>)
        • statusReceived (Integer)
        • statusReceivedAsString (String)
      • CPI-C Receive Buffer Actions
        • clearDataBuffer
        • destroyPart
        • free
        • initializeWith
        • initializeWith: (String)
        • putString
        • reset
      • CPI-C Receive Buffer Events
        • changed
        • confirmReceived
        • deallocateReceived
        • destroyedPart
        • requestToSendReceived
        • sendReceived
        • stateChanged
  • MQSeries Category
    • MQSeries Proc Dialog part
      • MQSeries Proc Dialog Settings -- General
        • Queue manager name
        • Request Queue name
        • Reply Queue name
        • Alternate user ID
        • Sync point processing
        • Server
      • MQSeries Proc Dialog Settings -- Records
        • Function language
        • File name
          • Parse
        • Parameter word size
        • Available
      • MQSeries Proc Dialog Attributes
        • connection (AbtMQConnection)
        • connectionSpec (AbtMQSeriesConnectionSpec)
        • prototypeSpec
        • self (<className>)
      • MQSeries Proc Dialog Actions
        • destroyPart
        • execute
      • MQSeries Proc Dialog Events
        • destroyedPart
    • MQSeries Connection part
      • MQSeries Connection Attributes
        • lastError (AbtMQError)
        • replyQueue (AbtMQqueue)
        • replyQueueAsList (MQ Series Distribution List
        • requestQueue (AbtMQqueue)
        • requestQueueAsList (MQ Series Distribution List)
        • self (<className>)
        • server (Boolean)
      • MQSeries Connection Actions
        • backout
        • commit
        • connect
        • destroyPart
        • disconnect
        • get
        • putReply
        • putRequest
      • MQSeries Connection Events
        • backedout
        • committed
        • connected
        • destroyedPart
        • disconnected
        • error
    • MQSeries Connection Spec part
      • MQSeries Connection Spec -- General
        • Queue manager name
        • Request queue name
        • Reply queue name
        • Alternate user id
        • Sync point processing
        • Server
      • MQ Series Connection Spec - Distribution List
        • Distribution List tab for MQ Series Connection Specification
        • Distribution List
        • Queue Manager Name
        • Queue Name
      • MQSeries Connection Spec Attributes
        • bigEndian (Boolean)
        • codePage (Integer)
        • queueManagerName (String)
        • replyQueue (String)
        • requestQueue (String)
        • server (Boolean)
        • self (<className>)
        • syncPoint (Boolean)
        • userID (String)
      • MQSeries Connection Spec Actions
        • destroyPart
      • MQSeries Connection Spec Events
        • destroyedPart
    • MQSeries Message part
      • MQSeries Message Settings - General
        • Buffer length
      • MQSeries Message Attributes
        • asOSByteArray (OSByteArray)
        • contents (ByteArray)
        • contentsAsString (String)
        • length (Integer)
        • self (<className>)
      • MQSeries Message Actions
        • clearDataBuffer
        • destroyPart
        • free
        • initializeWith
        • putString
        • reset
      • MQSeries Message Events
        • changed
        • destroyedPart
  • TCP/IP Category
    • RPC Connection Specification part
      • RPC Connection Spec Settings - Program Information
        • Program Number
        • Program Version
      • RPC Connection Spec Settings- Network Information
        • Network Type
        • Vendor
        • Server Name
      • RPC Connection Specification Attributes
        • bigEndian (Boolean)
        • codePage (Integer)
        • connection (<className>)
        • netWorkType (String)
        • pdfn (String)
        • programNumber (Integer)
        • programVersion (Integer)
        • self (<className>)
        • serverName (String)
        • vendor (String)
      • RPC Connection Specification Actions
        • destroyPart
        • execute
      • RPC Connection Specification Events
        • destroyedPart
    • RPC Client part
      • RPC Client Attributes
        • connectionSpec (<className>)
        • functionNumber
        • inputRecord (String)
        • isConnected (Boolean)
        • lastError (AbtRPCError)
        • outputRecord (String)
        • self (<className>)
        • timeOut (Integer)
      • RPC Client Actions
        • connect
        • destroyPart
        • disconnect
        • execute
        • receive
        • receiveBuffer
        • receiveWithLengthInData
        • sendBuffer
        • sendIncorporatingLength
        • sendRecord
        • sendString
        • sendStringAsLLAsciiZ
      • RPC Client Events
        • connected
        • destroyedPart
        • disconnected
        • received
        • receivedCompleteData
        • sent
    • RPC Proc Dialog part
      • RPC Proc Dialog Settings - Program Information
        • Program Number
        • Program Version
      • RPC Proc Dialog Settings - Network Information
        • Network Type
        • Vendor
        • Server Name
      • RPC Proc Dialog Settings - Data Attributes
        • Code page
        • Buffer length
        • Big endian
      • RPC Proc Dialog Settings - Records
        • Function language
        • File name
          • Parse
        • Parameter word size
        • Available records
        • Alignment
      • RPC Proc Dialog Attributes
        • connection (AbtRPCClient)
        • connectionSpec (AbtRPCConnectionSpec)
        • prototypeSpec
        • self (<className>)
      • RPC Proc Dialog Actions
        • destroyPart
        • execute
      • RPC Proc Dialog Events
        • destroyedPart
    • TCP/IP Proc Dialog part
      • TCP/IP Proc Dialog Settings -- Destination
        • Hostname
        • Port number
      • TCP/IP Proc Dialog Settings -- Data Attributes
        • Code page
        • Buffer length
        • Big endian
      • TCP/IP Proc Dialog Settings -- Records
        • Function language
        • File name
          • Parse
        • Parameter word size
        • Available
        • Alignment
      • TCP/IP Proc Dialog Attributes
        • connection (AbtSocket)
        • connectionSpec (AbtTCPConnectionSpec)
        • prototypeSpec
        • self
      • TCP/IP Proc Dialog Actions
        • destroyPart
        • execute
      • TCP/IP Proc Dialog Events
        • destroyedPart
    • TCP/IP Socket part
      • TCP/IP Socket Attributes
        • isConnected (Boolean)
        • lastError (AbtTCPError)
        • self (<className>)
      • TCP/IP Socket Actions
        • connect
        • destroyPart
        • disconnect
        • receive
        • receiveBuffer
        • receiveWithLengthInData
        • sendBuffer
        • sendIncorporatingLength
        • sendRecord
        • sendString
        • sendStringAsLLAsciiZ
      • TCP/IP Socket Events
        • destroyedPart
        • received
        • receivedCompleteData
        • sent
    • TCP/IP Connection Spec part
      • TCP/IP Connection Spec Settings -- Destination
        • Hostname
        • Port number
      • TCP/IP Connection Spec Settings -- Data Attributes
        • Code page
        • Buffer length
        • Big endian
      • TCP/IP Connection Spec Attributes
        • bigEndian (Boolean)
        • bufferLength (Integer)
        • codePage (Integer)
        • hostID (String)
        • hostType (Symbol)
        • port (Integer)
        • self (<className>)
      • TCP/IP Connection Spec Actions
        • destroyPart
      • TCP/IP Connection Spec Events
        • destroyedPart
    • Buffer part
      • Buffer Settings -- General
        • Buffer length
      • Buffer Attributes
        • asOSByteArray (OSByteArray)
        • contents (ByteArray)
        • contentsAsString (String)
        • length (Integer)
        • self (<className>)
      • Buffer Actions
        • clearDataBuffer
        • destroyPart
        • free
        • initializeWith
        • putString
        • reset
      • Buffer Events
        • changed
        • destroyedPart
• Appendices
  • Support for multiple vendors and software versions
    • Support for IBM and Attachmate on Windows
    • Support for SNA Server on AIX
  • Communicating over networks
    • Working with procedure dialogs
      • Overview of procedure dialogs
      • Adding and defining procedure dialogs
      • Connecting to procedure dialogs
    • Communicating with 3270-based applications
      • Overview of communicating with a 3270-based application
      • Adding and defining 3270 Screen parts
      • Connecting to 3270 Screen parts
    • Building a network connection
      • Overview of building a network connection
        • Connection
        • Connection spec
      • Adding network communication links
      • Connecting to a network connection part
        • Connecting to a server
        • Sending data to the server
        • Receiving data from the server
        • Disconnect from the server
  • Pop-up menu for parts in the Communication Category
• Index

Communications/Transactions

Index