ToC DocOverview CGDoc RelNotes FAQ Index PermutedIndex
Allegro CL version 11.0

dde variables


*case-sensitive-dde*

Variable, dde package

This variable has an effect only in case-insensitive Lisps (i.e. a Lisp where the value of *current-case-mode* is either :case-insensitive-upper or :case-insensitive-lower).

The value of this variable is the default value for the case-sensitive-dde property of any process that may act as a DDE server or client.

The initial value is nil. See case-sensitive-dde for more information.

See dde.html.


*generate-dde-messages*

Variable, dde package

This variable replaces the older cg:*show-dde-warnings*, which has been removed.

When the value of this variable is true (the default), then the default dde-message method will display warnings and other messages to inform the client or server that is running in lisp of what has happened. Custom dde-message methods could also check the value of this variable to make it easy to toggle the message-handling on and off.

See dde.html for information about DDE support in Common Graphics.


*service-name*

Variable, dde package

The value of this variable is the default value of the name argument to open-server, which determines the service name that DDE clients must specify to connect with the Lisp DDE server opened by open-server. The initial value is :allegro, meaning that the client should specify the service name as the string "allegro".

Compatibility note: Starting with release 6.2, this variable is no longer automatically modified to match the service name that was most recently passed to open-server. You may still modify the value of this variable to change the global default for a service name, but to retrieve the service name that is actually being used by a particular Lisp process, you must call the function service-name instead.

See dde.html.


*service-topics*

Variable, dde package

The default value of the topics argument to open-server, which determines the DDE topic names that DDE clients may specify to connect with DDE servers running in Lisp. The initial value is the list (nil :system :eval), meaning that the client should specify the topic as one of the strings "nil", "system", or "eval".

The default value :system follows a DDE convention where a DDE client can send a request with the "System" topic and the "sysitems" item to find out what items are available under the standard "System" topic, or with the "topics" item to find out what other topics are available. A built-in answer-request method will reply to these requests, and return the sysitems or service-topics for the Lisp process that the server is running in.

The default value :eval provides some built-in behavior unique to an Allegro DDE server. If sent by a client in a request with the name of a Lisp variable as the item, a built-in answer-request method returns the value of the variable (as a string). If the item is "command-result", a built-in answer-request method returns the value that was returned by the most recent command that the client asked this Lisp server to perform (see execute-command). (When Lisp is the client, it sends a command by calling send-command.) When the item is "help", a string that explains these points is returned.

The default value nil accepts a topic of "nil" and passes the symbol nil to overridable DDE server generic functions such as answer-request and execute-command, but the default methods for topic nil do nothing.

Compatibility note: Starting with release 6.2, this variable is no longer automatically modified to match the service topics that were most recently passed to open-server. You may still modify the value of this variable to change the global default for service topics, but to retrieve the service topics that are actually being used by a particular Lisp process, you should call the function service-topics instead.

See dde.html for information about DDE support in Common Graphics.


*sysitems*

Variable, dde package

The value of this variable is the default value for the sysitems property of any Lisp DDE server created by calling open-server. The initial value is the list of symbols (:sysitems :topics :help), but you may modify the value of this variable to use a different default set of sysitems.

The initial value follows a DDE convention where a "sysitems" item may be passed along with the "System" topic to a DDE server to find out what other items are available on the standard "system" topic.

While any Lisp DDE server will initially have the value of *sysitems* as its sysitems property, (setf sysitems) may be called after calling open-server in order to customize the system items of the DDE server running in a particular process.

See dde.html.


Copyright (c) 2023, Franz Inc. Lafayette, CA., USA. All rights reserved.

ToC DocOverview CGDoc RelNotes FAQ Index PermutedIndex
Allegro CL version 11.0