beautypg.com

HP NonStop G-Series User Manual

Page 62

background image

DDE Functions

Creating Client Applications

4–6

110838 Tandem Computers Incorporated

are initialized to binary zeros. The first INITIALIZESERVICE command of a DDE
conversation allocates data communications resources for use by the current DDE
conversation.

Configure the ServiceName specified as the first parameter of the
INITIALIZESERVICE command as a ServiceName object. Configure the
ApplicationName specified as the second parameter of the INITIALIZESERVICE
command as an ApplicationName object.

All ApplicationName objects used (or defaulted) in INITIALIZESERVICE commands
in one DDE conversation must be associated with the same PortName object in the
[ApplicationPorts] section of the Tandem DDE Gateway configuration file. If the
ApplicationName parameter is omitted, then an ApplicationName of DEFAULT is
assumed.

To have the Tandem system process the same transaction type more than once in a
DDE conversation, you need to issue the INITIALIZESERVICE command just once. If
you want the Tandem system to process more that one transaction type within a single
DDE conversation, you can use the INITIALIZESERVICE command more than once in
the DDE conversation; however, all the ServiceName objects used in these
INITIALIZESERVICE commands must have the same SessionType attribute (RSC
interprocess or RSC IDS session type).

See Section 2, “Workstation Configuration,” for details on configuring the
ServiceName and the ApplicationName objects.

Examples

[INITIALIZESERVICE(READ-EMPLOYEE)]

[INITIALIZESERVICE(DEBIT-ACCOUNT, GENERAL-LEDGER)]

SEND Command

The SEND command is used to tell the Tandem DDE Gateway to send a message
buffer with data accumulated from one or more DDE Poke functions to a Tandem
server. The Tandem DDE Gateway will wait for the reply message from the Tandem
server and put the reply into a buffer for you to access with DDE Request functions.
The SEND command completes when the reply message is in the Tandem DDE
Gateway buffer.

The Gateway sends the message to the Tandem server (Pathway server or Guardian
process) configured with the ServiceName object that you named in the previous DDE
Execute function INITIALIZESERVICE command.

Configure the number of bytes of data to be sent to the Tandem server using the
MaxSendLength and DefaultSendLength attributes of the ServiceName object. You can
override this configured byte count on the SEND command.

Only one SEND command can be outstanding for each DDE conversation.

Examples

[SEND]

[SEND(42)]