Hp NonStop G-Series Manuel d'utilisateur Page 1

Tandem Computers IncorporatedData Management LibraryTandem DDE GatewayUser’s GuideAbstract This manual for applications programmers describes the Tand

About This Manualx 110838 Tandem Computers IncorporatedManual Organization This manual consists of the following sections and appendixes:Section Conte

Developing a Tandem Program to Create UMS MessagesUsing DDE Hot and Warm Data Links7–4 110838 Tandem Computers IncorporatedConsiderationsYou should pu

Microsoft Visual Basic UMS Client ApplicationsUsing DDE Hot and Warm Data Links110838 Tandem Computers Incorporated 7–5DDE-NUM-TIMES-DELIVERED is the

Microsoft Visual Basic UMS Client ApplicationsUsing DDE Hot and Warm Data Links7–6 110838 Tandem Computers Incorporated(This page left intentionally b

8 Extending theTandem DDE Gateway110838 Tandem Computers Incorporated 8–1You can extend the Tandem DDE Gateway in a number of ways to make developingy

Returning Error MessagesExtending the Tandem DDE Gateway8–2 110838 Tandem Computers IncorporatedReturning ErrorMessagesYou can return errors to the Ta

Creating an RSC Logon Function and DialogExtending the Tandem DDE Gateway110838 Tandem Computers Incorporated 8–3Example MAKE files (with a MAK file e

User Hook LibraryExtending the Tandem DDE Gateway8–4 110838 Tandem Computers IncorporatedIf you return a non-zero in the bCancel parameter, then conne

User Hook LibraryExtending the Tandem DDE Gateway110838 Tandem Computers Incorporated 8–5There is always a User Hook Library. The default User Hook L

User Hook LibraryExtending the Tandem DDE Gateway8–6 110838 Tandem Computers Incorporatedcan understand. Built-in data conversion functions will stil

User Hook LibraryExtending the Tandem DDE Gateway110838 Tandem Computers Incorporated 8–7amount of storage to be allocated for the converted data. Th

Notation Conventions110838 Tandem Computers Incorporated xiGeneral SyntaxNotationThe following list summarizes the notation conventions for syntax pre

User Hook LibraryExtending the Tandem DDE Gateway8–8 110838 Tandem Computers IncorporatedhMainWnd Window handle of Tandem DDE Gateway mainwindow.ulIni

User Hook LibraryExtending the Tandem DDE Gateway110838 Tandem Computers Incorporated 8–9ParametersReturn Value Zero = Error.Non-zero = No error.hMai

User Hook LibraryExtending the Tandem DDE Gateway8–10 110838 Tandem Computers IncorporatedPrototypeBOOL FAR PASCAL TdmgwHookDdeRequest(HWND hMainWnd,

User Hook LibraryExtending the Tandem DDE Gateway110838 Tandem Computers Incorporated 8–11in the pbSupportedFormat parameter and zero in the pbConvert

User Hook LibraryExtending the Tandem DDE Gateway8–12 110838 Tandem Computers IncorporatedTdmgwHookEnableUserHooksThe function is called when the Tand

User Hook LibraryExtending the Tandem DDE Gateway110838 Tandem Computers Incorporated 8–13PrototypeBOOL FAR PASCAL TdmgwHookGetRequestDdeSize(HWND hMa

User Hook LibraryExtending the Tandem DDE Gateway8–14 110838 Tandem Computers IncorporatedIf pbSupportedFormat is zero, then you can do the data conve

User Hook LibraryExtending the Tandem DDE Gateway110838 Tandem Computers Incorporated 8–15pbConvertWithOnlyHookCode Zero = Convert with built-in autom

User Hook LibraryExtending the Tandem DDE Gateway8–16 110838 Tandem Computers IncorporatedTdmgwHookPreSendMessageThis function may be called when your

Tandem DDE Gateway Dictionary StructureExtending the Tandem DDE Gateway110838 Tandem Computers Incorporated 8–17To enable this User Hook Library funct

General Syntax NotationNotation Conventionsxii 110838 Tandem Computers IncorporatedEllipsis ... An ellipsis immediately following a pair of brackets

Tandem DDE Gateway Dictionary StructureExtending the Tandem DDE Gateway8–18 110838 Tandem Computers IncorporatedAll string fields are terminated with

Tandem DDE Gateway Dictionary StructureExtending the Tandem DDE Gateway110838 Tandem Computers Incorporated 8–19unsigned int uSubMult[7];unsigned int

Tandem DDE Gateway Dictionary StructureExtending the Tandem DDE Gateway8–20 110838 Tandem Computers Incorporated(This page left intentionally blank)

9 Troubleshooting110838 Tandem Computers Incorporated 9–1This section explains how to solve problems that you may encounter while using theTandem DDE

Troubleshooting9–2 110838 Tandem Computers IncorporatedWhen you connect a Tandem DDE Gateway port, either automatically when theTandem DDE Gateway is

Troubleshooting110838 Tandem Computers Incorporated 9–3being used matches the one used by your Tandem program, the RSC session orgroup alias matches t

Troubleshooting9–4 110838 Tandem Computers Incorporated(This page left intentionally blank)

Index110838 Tandem Computers Incorporated Index–1AABORTTRANSACTION command 4-7adding automatic data conversions 8-1altering exchanged messages 8-1A

IndexIndex–2 110838 Tandem Computers IncorporatedBridge directivesextending the Tandem DDE Gateway 8-1TDMGW-C-STRINGS 5-1, 5-2TDMGW-DDEALIAS 5-2TDM

Index110838 Tandem Computers Incorporated Index–3CF_TEXTapplication design considerations 4-19clipboard format 6-1Registered clipboard format 4-8,

1 Introduction to the TandemDDE Gateway110838 Tandem Computers Incorporated 1–1The Tandem DDE (Dynamic Data Exchange) Gateway allows Windows applicati

IndexIndex–4 110838 Tandem Computers IncorporatedConfiguration error 9-1configuration filesBrowser configuration file 4-16Error Text Overrides confi

Index110838 Tandem Computers Incorporated Index–5data elementscontaining special characters 4-20copied to clipboard 4-15displayed order 4-15finding

IndexIndex–6 110838 Tandem Computers IncorporatedDDE (continued)Initiate function 4-4Initiate function, described 1-7interaction, illustrated 1-6P

Index110838 Tandem Computers Incorporated Index–7DDE warm data linkscreating a client appliction that uses 7-1defined 1-5described 7-1establishing

IndexIndex–8 110838 Tandem Computers Incorporateddefault values (continued)port attributes 2-12PortConfigurationFile 2-11PortConfigurationSection

Index110838 Tandem Computers Incorporated Index–9DLLRSC logon function 8-3User Hook Library 8-4duplicate data element names 5-6Dynamic Data Exchang

IndexIndex–10 110838 Tandem Computers IncorporatedexamplesABORTTRANSACTION 4-7BEGINTRANSACTION 4-7Browser configuration file 4-17CLEARERROR 4-7cli

Index110838 Tandem Computers Incorporated Index–11examples (continued)[ApplicationDdeDicts] 2-8[ApplicationHostEnvironments] section 2-10[Applicati

IndexIndex–12 110838 Tandem Computers Incorporatedfunctions (continued)RSC logon 8-3TdmgwHookDdePoke 8-7TdmgwHookDdePokePreConvert 8-8TdmgwHookDde

Index110838 Tandem Computers Incorporated Index–13Iicon, flashing 4-7, 4-12IDS sessionsexample application 4-1NumberOfIdsSessions option 2-15Sessio

FeaturesIntroduction to the Tandem DDE Gateway1–2 110838 Tandem Computers IncorporatedClient applications that use the Tandem DDE Gateway do not need

IndexIndex–14 110838 Tandem Computers IncorporatedMMAKE files 8-3MaxReplyLengthServiceName objects 2-20MaxReplyLength attribute 4-11MaxSendLengthSe

Index110838 Tandem Computers Incorporated Index–15OobjectsApplicationName 2-1PortName 2-1ServiceName 2-1Options menuClipboard in Lowercase 4-15Dis

IndexIndex–16 110838 Tandem Computers IncorporatedPorts section 2-10Powersoft PowerBuilder 1-1, 4-2, 4-22preparing DDL source 5-1programsBridge 5-

Index110838 Tandem Computers Incorporated Index–17RSC UMS featuredata not arriving at application 9-2developing applications that use 7-1RscIniFile

IndexIndex–18 110838 Tandem Computers IncorporatedServiceName objects (continued)MaxReplyLength 2-20MaxSendLength 2-20ServerClassOrGuardianProcess

Index110838 Tandem Computers Incorporated Index–19Tandem DDE Gateway (continued)Dictionary 1-4See also Dictionarystructure 8-17extending 1-2exten

IndexIndex–20 110838 Tandem Computers IncorporatedTDMGW.EXETandem DDE Gateway program 2-4TDMGW.HC language header file 6-4TDMGW.INITandem DDE Gatewa

Index110838 Tandem Computers Incorporated Index–21TMFABORTTRANSACTION command 4-7BEGINTRANSACTION command 4-7considerations 4-17ENDTRANSACTION comm

IndexIndex–22 110838 Tandem Computers IncorporatedWindows configuration files[Tdmgw] section 2-3Windows dynamic link librarySee DLLWindows USER libr

Index110838 Tandem Computers Incorporated Index–23_TDMGW-BINARY-BUFFERDataElementName parameter 4-9, 4-11_TDMGW-ERROR-MSG-NUMBERDataElementName 4-12

FeaturesIntroduction to the Tandem DDE Gateway110838 Tandem Computers Incorporated 1–3You can drive the DDE protocol from your client application in a

FeaturesIntroduction to the Tandem DDE Gateway1–4 110838 Tandem Computers IncorporatedFigure 1-2. Automatic Message Layout and Data ConversionWindows

FeaturesIntroduction to the Tandem DDE Gateway110838 Tandem Computers Incorporated 1–5The Tandem DDE Gateway supports DDE hot and warm data links. Th

Dynamic Data Exchange (DDE)Introduction to the Tandem DDE Gateway1–6 110838 Tandem Computers Incorporated2. Call DdeClientTransaction with the XTYP_AD

Dynamic Data Exchange (DDE)Introduction to the Tandem DDE Gateway110838 Tandem Computers Incorporated 1–7Figure 1-3. DDE Client-Server InteractionDD

Ordering Information For manual ordering information: domestic U.S. customers, call 1-800-243-6886; international customers, contact yourlocal sales

Client ProgrammingIntroduction to the Tandem DDE Gateway1–8 110838 Tandem Computers Incorporatedone, column one of a spreadsheet”) and its clipboard f

Client ProgrammingIntroduction to the Tandem DDE Gateway110838 Tandem Computers Incorporated 1–9PROCEDURE DIVISION.BEGIN-TRANSACTION. (not really ne

Client ProgrammingIntroduction to the Tandem DDE Gateway1–10 110838 Tandem Computers Incorporatedthe Bridge program. You can configure a memory cache

Client ProgrammingIntroduction to the Tandem DDE Gateway110838 Tandem Computers Incorporated 1–11The employee number sent with the DDE Poke function i

Client ProgrammingIntroduction to the Tandem DDE Gateway1–12 110838 Tandem Computers IncorporatedBinary-Pass-Through DDE CommunicationTo explain the b

Client ProgrammingIntroduction to the Tandem DDE Gateway110838 Tandem Computers Incorporated 1–133. Use the DDE Execute function to tell the Tandem DD

Client ProgrammingIntroduction to the Tandem DDE Gateway1–14 110838 Tandem Computers IncorporatedTools and languages that support calls to Windows DLL

Client ProgrammingIntroduction to the Tandem DDE Gateway110838 Tandem Computers Incorporated 1–15Table 1-1. Example DDE VerbsMicrosoftExcelMicrosoft

Client ProgrammingIntroduction to the Tandem DDE Gateway1–16 110838 Tandem Computers Incorporated(This page left intentionally blank)

2 Workstation Configuration110838 Tandem Computers Incorporated 2–1You must configure the Tandem DDE Gateway before you use it to access the Tandemsys

New and Changed Information110838 Tandem Computers Incorporated iiiNew Features andChanged InformationThe Tandem DDE Gateway User’s Guide includes the

Workstation Configuration2–2 110838 Tandem Computers IncorporatedFigure 2-1. Workstation Configuration FilesServiceName ObjectsORDER-STOCKREAD-EMPLOY

Windows Configuration FileWorkstation Configuration110838 Tandem Computers Incorporated 2–3Windows initialization (INI) files, such as WIN.INI or TDMG

Gateway Configuration FileWorkstation Configuration2–4 110838 Tandem Computers IncorporatedThe Tandem DDE Gateway looks for an initialization file nam

Gateway Configuration FileWorkstation Configuration110838 Tandem Computers Incorporated 2–5Each of these entries is described in detail in the followi

Gateway Configuration FileWorkstation Configuration2–6 110838 Tandem Computers IncorporatedDefaultThe default value is 500. Each cache entry requires

Gateway Configuration FileWorkstation Configuration110838 Tandem Computers Incorporated 2–7DefaultIf the ServiceMapSection option is not specified, th

Gateway Configuration FileWorkstation Configuration2–8 110838 Tandem Computers Incorporated[ApplicationDdeDicts]SectionThis optional section of the co

Gateway Configuration FileWorkstation Configuration110838 Tandem Computers Incorporated 2–9characters starting with a letter for this configuration op

Gateway Configuration FileWorkstation Configuration2–10 110838 Tandem Computers IncorporatedDefaultIf no ApplicationName option is specified in the [A

Gateway Configuration FileWorkstation Configuration110838 Tandem Computers Incorporated 2–11If you do not name a PortConfigurationFile and a PortConfi

New Features and InformationNew and Changed Informationiv 110838(This page left intentionally blank)

PortName Object ConfigurationWorkstation Configuration2–12 110838 Tandem Computers IncorporatedDefaultThe default is the name of the PortName object y

PortName Object ConfigurationWorkstation Configuration110838 Tandem Computers Incorporated 2–13UseRscSecurityRscIniFileRscIniSectionEach of these attr

PortName Object ConfigurationWorkstation Configuration2–14 110838 Tandem Computers IncorporatedNumberOfInterprocessSessionsYou configure each PortName

PortName Object ConfigurationWorkstation Configuration110838 Tandem Computers Incorporated 2–15The SessionType attribute that you specify for a Servic

[AutomaticStartup] SectionWorkstation Configuration2–16 110838 Tandem Computers IncorporatedExampleUseRscSecurity=1 (Prompt for a User ID and password

Example Gateway Configuration FilesWorkstation Configuration110838 Tandem Computers Incorporated 2–17You can specify the AutomaticStartupOption attrib

Example Gateway Configuration FilesWorkstation Configuration2–18 110838 Tandem Computers IncorporatedWorkstation That Accesses Two Applications Throug

Service Map Configuration FileWorkstation Configuration110838 Tandem Computers Incorporated 2–19MOSCOW-PORT=, MOSCOW-CONFIG[ATHENS-CONFIG]PollingInter

Service Map Configuration FileWorkstation Configuration2–20 110838 Tandem Computers IncorporatedOn the Tandem system, create an Enform report that rea

Service Map Configuration FileWorkstation Configuration110838 Tandem Computers Incorporated 2–21SessionTypeFlagThis flag indicates the type of RSC ses

Contents110838 Tandem Computers Incorporated vNew and Changed Information iiiAbout This Manual ixNotation Conventions xiSection 1 Introductio

Startup by Client ApplicationWorkstation Configuration2–22 110838 Tandem Computers IncorporatedExample[ServiceMap]READ-EMPLOYEE=EMPLOYEE-SERVER,42,,12

Error Text Overrides FileWorkstation Configuration110838 Tandem Computers Incorporated 2–23Error TextOverrides FileYou can override error message text

Error Text Overrides FileWorkstation Configuration2–24 110838 Tandem Computers Incorporated(This page left intentionally blank)

3 Running theTandem DDE Gateway110838 Tandem Computers Incorporated 3–1You must start the Tandem DDE Gateway before your client program can use DDE to

Connecting and Disconnecting PortsRunning the Tandem DDE Gateway3–2 110838 Tandem Computers Incorporated(To connect more than one selected PortName ob

Reading and Clearing Error MessagesRunning the Tandem DDE Gateway110838 Tandem Computers Incorporated 3–3Reading and ClearingError MessagesWhen the Ta

Reading and Clearing Error MessagesRunning the Tandem DDE Gateway3–4 110838 Tandem Computers Incorporated(This page left intentionally blank)

4 Creating Client Applications110838 Tandem Computers Incorporated 4–1This section describes the DDE functions that you use in your client application

Example ApplicationCreating Client Applications4–2 110838 Tandem Computers IncorporatedAn example User Hook Library implementing a new data conversion

Example ApplicationCreating Client Applications110838 Tandem Computers Incorporated 4–3Figure 4-1. Tandem DDE Gateway Example ApplicationTandem Syst

Contentsvi 110838 Tandem Computers IncorporatedSection 4 Creating Client ApplicationsExample Application 4-1DDE Functions 4-4DDE Initiate Functi

DDE FunctionsCreating Client Applications4–4 110838 Tandem Computers IncorporatedDDE Functions You can use five different DDE functions to communicate

DDE FunctionsCreating Client Applications110838 Tandem Computers Incorporated 4–5be no lengthy user dialogs (such as input of data) within the DDE con

DDE FunctionsCreating Client Applications4–6 110838 Tandem Computers Incorporatedare initialized to binary zeros. The first INITIALIZESERVICE command

DDE FunctionsCreating Client Applications110838 Tandem Computers Incorporated 4–7BEGINTRANSACTION CommandThe BEGINTRANSACTION command is used to begin

DDE FunctionsCreating Client Applications4–8 110838 Tandem Computers Incorporatedoutput by the Bridge. (The Browser also allows you to use “cut and p

DDE FunctionsCreating Client Applications110838 Tandem Computers Incorporated 4–9If the DataElementValue is too large or too long to fit in its intend

DDE FunctionsCreating Client Applications4–10 110838 Tandem Computers IncorporatedElement-by-Element ApproachTo use the element-by-element approach, t

Example Client Application DDE Function CallsCreating Client Applications110838 Tandem Computers Incorporated 4–11Numeric data elements are returned a

Error HandlingCreating Client Applications4–12 110838 Tandem Computers IncorporatedEXECUTE ([BEGINTRANSACTION])EXECUTE ([SEND])REQUEST ("REPLY-HE

Error HandlingCreating Client Applications110838 Tandem Computers Incorporated 4–13same data element, and so an unsupported clipboard format is not re

Contents110838 Tandem Computers Incorporated viiSection 5 The Tandem DDE Gateway Bridge Program, continuedRunning the Bridge Program 5-4FastSort Pr

The Tandem DDE Gateway BrowserCreating Client Applications4–14 110838 Tandem Computers IncorporatedTandem DDE GatewayFailuresClient applications, espe

The Tandem DDE Gateway BrowserCreating Client Applications110838 Tandem Computers Incorporated 4–15Select a message and click the Poke button to cop

The Tandem DDE Gateway BrowserCreating Client Applications4–16 110838 Tandem Computers Incorporated015Configuring the Browser The Browser has a number

Application Design ConsiderationsCreating Client Applications110838 Tandem Computers Incorporated 4–17DdeDictEnter the default Tandem DDE Gateway Dict

Application Design ConsiderationsCreating Client Applications4–18 110838 Tandem Computers IncorporatedNote The term “asynchronous” means the same as t

Application Design ConsiderationsCreating Client Applications110838 Tandem Computers Incorporated 4–19previous read transaction), then puts these fiel

Application Design ConsiderationsCreating Client Applications4–20 110838 Tandem Computers Incorporatedlarge number of DDE Request functions could be r

Application Design ConsiderationsCreating Client Applications110838 Tandem Computers Incorporated 4–21Use the Tandem DDE Gateway binary-pass-through a

Application Design ConsiderationsCreating Client Applications4–22 110838 Tandem Computers IncorporatedNote The preceding considerations are based on t

5 The Tandem DDE GatewayBridge Program110838 Tandem Computers Incorporated 5–1You use the Tandem DDE Gateway Bridge program to create a Tandem DDE Gat

Contentsviii 110838 Tandem Computers IncorporatedSection 8 Extending the Tandem DDE Gateway, continuedUser Hook LibraryTdmgwHookDdeRequestPostConvert

Preparing Your Data Definition Language (DDL) SourceThe Tandem DDE Gateway Bridge Program5–2 110838 Tandem Computers IncorporatedDDE Gateway for a dat

Preparing Your Data Definition Language (DDL) SourceThe Tandem DDE Gateway Bridge Program110838 Tandem Computers Incorporated 5–3SyntaxTDMGW-DDEALIAS=

Running the Bridge ProgramThe Tandem DDE Gateway Bridge Program5–4 110838 Tandem Computers IncorporatedThe DDL source produces the following data elem

Running the Bridge ProgramThe Tandem DDE Gateway Bridge Program110838 Tandem Computers Incorporated 5–5For example, if your DDL dictionary contains pa

Running the Bridge ProgramThe Tandem DDE Gateway Bridge Program5–6 110838 Tandem Computers Incorporated$DATA MYSUBVOL 15> SORT /IN $DISK.ZTDMGW.DD

Running the Bridge ProgramThe Tandem DDE Gateway Bridge Program110838 Tandem Computers Incorporated 5–7Note The last line showing the number of dictio

Running the Bridge ProgramThe Tandem DDE Gateway Bridge Program5–8 110838 Tandem Computers Incorporated(This page left intentionally blank)

6 Data Conversion110838 Tandem Computers Incorporated 6–1Your client application can use two different approaches to sending data to theTandem DDE Gat

Automatic Data ConversionData Conversion6–2 110838 Tandem Computers IncorporatedYou can also add your own automatic data conversion functions, or supp

Data Conversion LibraryData Conversion110838 Tandem Computers Incorporated 6–3Table 6-1. Automatic Data Conversion (Page 2 of 2) DICTOBL“Structure”

About This Manual110838 Tandem Computers Incorporated ixThis manual describes the Tandem DDE (Dynamic Data Exchange) Gateway. TheTandem DDE Gateway a

Data Conversion LibraryData Conversion6–4 110838 Tandem Computers IncorporatedThe Tandem DDE Gateway data conversion functions and related constants a

Data Conversion LibraryData Conversion110838 Tandem Computers Incorporated 6–5lpAlphaNum Pointer to the start of where the converted string is placed.

Data Conversion LibraryData Conversion6–6 110838 Tandem Computers IncorporatednSignType Display numeric sign type to be used for the converteddata:TDM

Data Conversion LibraryData Conversion110838 Tandem Computers Incorporated 6–7nTwosCompNumberLength Length of Tandem two's complement number in b

Data Conversion LibraryData Conversion6–8 110838 Tandem Computers IncorporatedParameterslpElementValue Pointer to where the start of the converted str

Data Conversion LibraryData Conversion110838 Tandem Computers Incorporated 6–9nSignType Indicates whether the Tandem two's complementnumber is si

Data Conversion LibraryData Conversion6–10 110838 Tandem Computers Incorporated(This page left intentionally blank)

7 Using DDE Hot and WarmData Links110838 Tandem Computers Incorporated 7–1DDE hot and warm data links allow a client application to inform a DDE serve

Developing a Tandem Program to Create UMS MessagesUsing DDE Hot and Warm Data Links7–2 110838 Tandem Computers Incorporateda. Workstation configuratio

Developing a Tandem Program to Create UMS MessagesUsing DDE Hot and Warm Data Links110838 Tandem Computers Incorporated 7–305 DDE-ITEM-NAME PIC X(101)