HP NonStop G-Series - Manual (Page 63)

DDE Functions
Creating Client Applications
110838 Tandem Computers Incorporated 4–7
BEGINTRANSACTION Command
The BEGINTRANSACTION command is used to begin a TMF transaction on the
Tandem system.
Example [BEGINTRANSACTION]
ENDTRANSACTION Command
The ENDTRANSACTION command is used to end a TMF transaction on the Tandem
system.
Example [ENDTRANSACTION]
ABORTTRANSACTION Command
The ABORTTRANSACTION command is used to abort a TMF transaction on the
Tandem system.
Example [ABORTTRANSACTION]
CLEARERROR Command
You can use the CLEARERROR command after a DDE “not processed” error has been
returned from the Tandem DDE Gateway. If you retrieve the error information from
the Tandem DDE Gateway with the special DDE Request functions and display a
message, then it may not be helpful to have the Tandem DDE Gateway icon keep
flashing. CLEARERROR will stop the icon flashing (if it is) and clear any error
message from the Tandem DDE Gateway main screen area. See the topic “Error
Handling” later in this section for more information.
Example [CLEARERROR]
DDE Poke Function The DDE Poke function is used to send data to the Tandem DDE Gateway. If the
element-by-element approach is being used, the data is converted by the Tandem DDE
Gateway to Tandem data representation. You can use many DDE Poke functions with
different DataElementName parameters to fill up the buffer before sending it to the
Tandem server with a DDE Execute function SEND command.
Syntax
POKE (DataElementName, DataElementValue)
POKE (DataElementName(Subscript1, ..., Subscript7),
→
DataElementValue)
Element-by-Element Approach
To use the element-by-element approach, the DataElementName parameter is set to a
data element name from the Tandem DDE Gateway Dictionary that you created with
the Bridge program (see Section 5, “The Tandem DDE Gateway Bridge Program”).
The data element name uniquely identifies a data item by using all the levels in the
data naming hierarchy for the message (such as READ-REPLY.EMPLOYEE-
TABLE.FIRST-NAME). To find out the DataElementName parameter, you can use the
Tandem DDE Gateway Browser or the Tandem DDE Gateway Dictionary Report