Tivoli Service Desk 6.0 Developer's Toolkit Script - Manuel de référence du langage TSD Script

Instructions DDE

Retour à la page principale


DDEAdvise

Description

Permet de demander au serveur DDE d'indiquer à l'application les modifications des données associées au domaine demandé.

Syntaxe

 FUNCTION DDEAdvise(VAL whdl, whdlPartner: WINDOW,
                    VAL topic:STRING,VAL Flag: INTEGER)
                    : INTEGER;

Remarques concernant les arguments

Nom de l'argument Description
whdl Descripteur de la fenêtre de l'application qui reçoit les réponses du partenaire DDE. En général, cette fenêtre est un enfant du bureau et constitue la fenêtre principale de l'application. Lorsque la fonction DDE répond à un message DDE, le pseudo-paramètre utilisé est $Handle.
whdlPartner Descripteur de la fenêtre appartenant à l'application partenaire lors de la conversation. Il s'agit de la fenêtre à laquelle accède la fonction DDE. C'est habituellement le pseudo-paramètre $DDEWindow qui fait partie de tous les messages DDE.
topic Données adressées à l'application partenaire par la fonction DDE. Les deux applications participant à une conversation DDE doivent décider des domaines abordés et des actions possibles pour un domaine donné. Si la chaîne du domaine est vide, tous les domaines sont pris en charge.
Flag Indique le type d'indication demandé. Les valeurs admises sont :
  • $DDEack - Demande un accusé de réception au partenaire.
  • $DDENoData - Avertit lorsque les données sont modifiées (par un message de données DDE), mais ne les transmet pas.

Remarques

DDEAdvise demande au serveur DDE de créer un $MsgDDEData dans le descripteur de la fenêtre dès que les données associées au domaine sont modifiées. Les messages de données envoyés de cette manière n'ont pas de bit DDEResponse paramétré dans les indicateurs de statut. Un message DDEAdvise peut être supprimé par un DDEUnAdvise.

Exemple

Pour avoir un exemple sur l'utilisation des commandes DDE en langage TSD Script afin de communiquer avec les autres applications, reportez-vous aux fichiers ddetcli.kb et ddetsrv.kb dans le répertoire EXAMPLES/DDE où Tivoli Service Desk Developer's Toolkit a été installé.

Codes retour

Code retour Description
1 Opération exécutée avec succès
-2 Valeur inconnue
-10 Un appel a échoué au niveau du système d'exploitation. Cela peut être dû à une configuration incorrecte ou à une inadéquation des ressources.

Voir aussi

Pour plus de détails , reportez-vous à la page Messages de TSD Script.


DDEData

Description

Permet d'envoyer des données via DDE à l'application qui les demande.

Syntaxe

 FUNCTION DDEData(VAL whdl, whdlPartner: WINDOW,
 VAL topic,data: STRING,
 VAL Flag: INTEGER): INTEGER;

Remarques concernant les arguments

Nom de l'argument Description
whdl Descripteur de la fenêtre de l'application qui reçoit les réponses du partenaire DDE. En général, cette fenêtre est un enfant du bureau et constitue la fenêtre principale de l'application. Lorsque la fonction DDE répond à un message DDE, le pseudo-paramètre utilisé est $Handle.
whdlPartner Descripteur de la fenêtre de l'application partenaire lors de la conversation. Il s'agit de la fenêtre à laquelle accède la fonction DDE. C'est habituellement le pseudo-paramètre $DDEWindow qui fait partie de tous les messages DDE.
topic Données adressées à l'application partenaire par la fonction DDE. Les deux applications participant à une conversation DDE doivent décider des domaines abordés et des actions possibles pour un domaine donné. Si la chaîne du domaine est vide, tous les domaines sont pris en charge.
data Données envoyées à l'application partenaire.
Flag Indique le type d'indication demandé. Les valeurs admises sont :
  • $DDEack - Demande un accusé de réception au partenaire.
  • $DDENoData - Avertit lorsque les données sont modifiées (par un message de données DDE), mais ne les transmet pas.

Remarques

DDEData envoie les données en réponse à $MsgDDERequest. Elle peut également envoyer des données demandées par une application. DDEPoke est utilisée pour envoyer des données non demandées vers une application.

Exemple

 TYPES
 DDEREC IS RECORD
 partners: LIST OF DDEPARTNERREC;
 whdlPartner: WINDOW;
              END;
 .
 .
 .
EVENT DDEWindow( REF DDEDataRec: DDEREC ) IS
 ...
ACTIONS
     WHEN $Event IS $MsgCreate THEN
 ...
 ELSWHEN $MsgDDERequest THEN
 WHEN $EventParm(2,STRING) IS 'TOPICS' THEN
 DDEData( $Handle, $DDEWindow, $DDETopic, 'TEST');
 ...
              END;

Codes retour

Code retour Description
1 Opération exécutée avec succès
-2 Valeur inconnue
-10 Un appel a échoué au niveau du système d'exploitation. Cela peut être dû à une configuration incorrecte ou à une inadéquation des ressources.

Voir aussi

Pour plus de détails, reportez-vous à la page Messages de TSD Script.

Pour avoir d'autres exemples sur l'utilisation des commandes DDE en langage TSD Script afin de communiquer avec les autres applications, reportez-vous aux fichiers ddetcli.kb et ddetsrv.kb dans le répertoire EXAMPLES/DDE où Tivoli Service Desk Developer's Toolkit a été installé.


DDEExecute

Description

Envoie une chaîne de commande à exécuter par un partenaire DDE.

Syntaxe

 FUNCTION DDEExecute(VAL whdl, whdlPartner: WINDOW,
                     VAL topic, cmdString: STRING)
                     : INTEGER;

Remarques concernant les arguments

Nom de l'argument Description
whdl Descripteur de la fenêtre de l'application qui reçoit les réponses du partenaire DDE. En général, cette fenêtre est un enfant du bureau et constitue la fenêtre principale de l'application. Lorsque la fonction DDE répond à un message DDE, le pseudo-paramètre utilisé est $Handle.
whdlPartner Descripteur de la fenêtre de l'application partenaire lors de la conversation. Il s'agit de la fenêtre à laquelle accède la fonction DDE. C'est habituellement le pseudo-paramètre $DDEWindow qui fait partie de tous les messages DDE.
topic Données adressées à l'application partenaire par la fonction DDE. Les deux applications participant à une conversation DDE doivent décider des domaines abordés et des actions possibles pour un domaine donné. Si la chaîne du domaine est vide, tous les domaines sont pris en charge.
cmdString Chaîne de commande du partenaire DDE. Le contenu et le format de la chaîne de commande doivent être acceptés par les applications participant à la conversation DDE.

Exemple

  VARIABLES
  rc              :INTEGER;
 partner_whdl: WINDOW;
 partner_topic: STRING;
ACTIONS
 .
 . (* Assuming a DDE session has been initiated, topic is
 set. *)
 .
 rc := DDEExecute ( $Handle, partner_whdl, partner_topic,
                    "del *.*" );
IF (rc <> 1) THEN
 (* DDEExecute a échoué *)
ELSE
 (* DDEExecute a abouti *)
              END;
 .
 .
 .
              END;

Codes retour

Code retour Description
1 Opération exécutée avec succès.
-2 Valeur inconnue.
-10 Un appel a échoué au niveau du système d'exploitation. Cela peut être dû à une configuration incorrecte ou à une inadéquation des ressources.

Voir aussi

Pour plus de détails, reportez-vous à la page Messages de TSD Script.

Pour avoir d'autres exemples sur l'utilisation des commandes DDE en langage TSD Script afin de communiquer avec les autres applications, reportez-vous aux fichiers ddetcli.kb et ddetsrv.kb dans le répertoire EXAMPLES/DDE où Tivoli Service Desk Developer's Toolkit a été installé.


DDEInitiate

Description

Permet de commencer une conversation DDE avec un ou plusieurs partenaires.

Syntaxe

 FUNCTION DDEInitiate(VAL whdl: WINDOW, VAL topic,
                      appName: STRING): INTEGER;

Remarques concernant les arguments

Nom de l'argument Description
whdl Descripteur de la fenêtre de l'application qui reçoit les réponses du partenaire DDE. En général, cette fenêtre est un enfant du bureau et constitue la fenêtre principale de l'application. Lorsque la fonction DDE répond à un message DDE, le pseudo-paramètre utilisé est $Handle.
topic Données adressées à l'application partenaire par la fonction DDE. Les deux applications participant à une conversation DDE doivent décider des domaines abordés et des actions possibles pour un domaine donné. Si la chaîne du domaine est vide, tous les domaines sont pris en charge.
appName Nom de l'application avec laquelle cette application veut avoir une conversation. Si appName est une chaîne vide ou correspond à $Unknown, toutes les applications qui prennent en charge le domaine demandé doivent répondre.

Remarques

DDEInitiate diffuse un message de lancement vers les fenêtres enfants du bureau. Ce message est spécifique à la plateforme.

Si un appName est indiqué, toute application correspondant à appName doit répondre. L'application correspondante doit envoyer un $MsgDDEInitAcknowledge à la fenêtre de lancement. Si appName est une chaîne vide, toutes les applications doivent répondre.

Si le domaine a une longueur de chaîne égale à zéro, toutes les applications doivent signaler les domaines existants. Par exemple, appeler DDEInitiate avec un appName et une chaîne de domaine vide revient à faire la demande de tous les domaines d'applications qui sont des serveurs DDE.

Exemple

  VARIABLES
  rc              :INTEGER;
 partner_whdl: WINDOW;
 partner_topic: STRING;
 partner_app: STRING;
ACTIONS

(* Assuming partner variables have been set. *)

 rc := DDEInitiate ( $Handle, partner_topic, partner_app );
 IF (rc <> 1) THEN
 (* DDEInitiate failed *)
 ELSE
 (* DDEInitiate succeeded *)
 END;
END;

Codes retour

Code retour Description
1 Opération exécutée avec succès.
-2 Valeur inconnue.
-10 La demande d'un service du système d'exploitation (pour compléter la fonction) a échoué. Les causes possibles peuvent être des valeurs non valides pour les arguments des instructions ou les limitations des ressources du système.

Voir aussi

Pour plus de détails, reportez-vous à la page Messages de TSD Script.

Pour avoir d'autres exemples sur l'utilisation des commandes DDE en langage TSD Script afin de communiquer avec les autres applications, reportez-vous aux fichiers ddetcli.kb et ddetsrv.kb dans le répertoire EXAMPLES/DDE où se trouve Tivoli Service Desk Developer's Toolkit.

Pour plus d'informations sur l'interface DDE, reportez-vous à la documentation fournie avec le produit.


DDEPoke

Description

Permet d'envoyer des données non-demandées à un partenaire DDE.

Syntaxe

 FUNCTION DDEPoke(VAL whdl, whdlPartner: WINDOW, VAL topic,
                  data: STRING): INTEGER;

Remarques concernant les arguments

Nom de l'argument Description
whdl Descripteur de la fenêtre de l'application qui reçoit les réponses du partenaire DDE. En général, cette fenêtre est un enfant du bureau et constitue la fenêtre principale de l'application. Lorsque la fonction DDE répond à un message DDE, le pseudo-paramètre utilisé est $Handle.
whdlPartner Descripteur de la fenêtre de l'application partenaire lors de la conversation. Il s'agit de la fenêtre à laquelle accède la fonction DDE. C'est habituellement le pseudo-paramètre $DDEWindow qui fait partie de tous les messages DDE.
topic Données adressées à l'application partenaire par la fonction DDE. Les deux applications participant à une conversation DDE doivent décider des domaines abordés et des actions possibles pour un domaine donné. Si la chaîne du domaine est vide, tous les domaines sont pris en charge.
data Données non-demandées à un partenaire DDE. L'application réceptrice doit savoir comment accepter les données d'un domaine spécifique.

Exemple

  VARIABLES
  rc              :INTEGER;
 partner_whdl: WINDOW;
 partner_topic: STRING;
 partner_data: STRING;

ACTIONS

(* Assuming session Initiated, partner variables have
 been set. *)

 rc := DDEPoke ($Handle, partner_whdl, partner_topic,
                partner_data );
 IF (rc < 1) THEN
 (* DDEPoke failed *)
 ELSE
 (* DDEPoke succeeded *)
 END;
 ...
END;

Codes retour

Code retour Description
1 Opération exécutée avec succès.
-2 Valeur inconnue.
-10 Un appel a échoué au niveau du système d'exploitation. Cela peut être dû à une configuration incorrecte ou à une inadéquation des ressources.

Voir aussi

DDEData

Pour plus de détails, reportez-vous à la page Messages de TSD Script.

Pour avoir d'autres exemples sur l'utilisation des commandes DDE en langage TSD Script afin de communiquer avec les autres applications, reportez-vous aux fichiers ddetcli.kb et ddetsrv.kb dans le répertoire EXAMPLES/DDE où Tivoli Service Desk Developer's Toolkit a été installé.


DDERequest

Description

Permet de demander des données à un partenaire DDE.

Syntaxe

 FUNCTION DDERequest(VAL whdl, whdlPartner: WINDOW,
                      VAL topic: STRING): INTEGER;

Remarques concernant les arguments

Nom de l'argument Description
whdl Descripteur de la fenêtre de l'application qui reçoit les réponses du partenaire DDE. En général, cette fenêtre est un enfant du bureau et constitue la fenêtre principale de l'application. Lorsque la fonction DDE répond à un message DDE, le pseudo-paramètre utilisé est $Handle.
whdlPartner Descripteur de la fenêtre de l'application partenaire lors de la conversation. Il s'agit de la fenêtre à laquelle accède la fonction DDE. C'est habituellement le pseudo-paramètre $DDEWindow qui fait partie de tous les messages DDE.
topic Données adressées à l'application partenaire par la fonction DDE. Les deux applications participant à une conversation DDE doivent décider des domaines abordés et des actions possibles pour un domaine donné. Si la chaîne du domaine est vide, tous les domaines sont pris en charge.

Remarques

L'application partenaire peut répondre en envoyant les données demandées ou un accusé de réception négatif ($MsgDDEAcknowledge).

Exemple

  VARIABLES
  rc              :INTEGER;
 partner_whdl: WINDOW;
 partner_topic: STRING;
 partner_data: STRING;
ACTIONS
(* Assuming session Initiated, partner variables have
 been set. *)
 DDERequest ( $Handle, partner_whdl, partner_topic );

 (* The DDE Partner will respond with Data or Acknowledge *)

EVENT DDEWindow( REF DDEDataRec: DDEREC ) IS
 ...
ACTIONS
 WHEN $Event IS $MsgCreate THEN
 ...
 ELSWHEN $MsgDDEAcknowledge THEN
 (* Look in $DDETopic, $DDEData and $DDEStatus for
 information. *)
 ...
 ELSWHEN $MsgDDEData THEN
 (* Look in $DDETopic and $DDEData for information. *)
 ...
 END;
END;

Codes retour

Code retour Description
1 Opération exécutée avec succès.
-2 Valeur inconnue.
-10 Un appel a échoué au niveau du système d'exploitation. Cela peut être dû à une configuration incorrecte ou à une inadéquation des ressources.

Voir aussi

Pour plus de détails, reportez-vous à la page Messages de TSD Script.

Pour avoir d'autres exemples sur l'utilisation des commandes DDE en langage TSD Script afin de communiquer avec les autres applications, reportez-vous aux fichiers ddetcli.kb et ddetsrv.kb dans le répertoire EXAMPLES/DDE où Tivoli Service Desk Developer's Toolkit a été installé.


DDERespond

Description

Permet d'envoyer une réponse à un message $MsgDDEInitiate.

Syntaxe

 FUNCTION DDERespond(VAL whdl, whdlPartner: WINDOW,
                     VAL topic, VAL appName: STRING): INTEGER;

Remarques concernant les arguments

Nom de l'argument Description
whdl Descripteur de la fenêtre de l'application qui reçoit les réponses du partenaire DDE. En général, cette fenêtre est un enfant du bureau et constitue la fenêtre principale de l'application. Lorsque la fonction DDE répond à un message DDE, le pseudo-paramètre utilisé est $Handle.
whdlPartner Descripteur de la fenêtre de l'application partenaire lors de la conversation. Il s'agit de la fenêtre à laquelle accède la fonction DDE. C'est habituellement le pseudo-paramètre $DDEWindow qui fait partie de tous les messages DDE.
topic Données adressées à l'application partenaire par la fonction DDE. Les deux applications participant à une conversation DDE doivent décider des domaines abordés et des actions possibles pour un domaine donné. Si la chaîne du domaine est vide, tous les domaines sont pris en charge.
appName Nom de l'application appelante. Ce nom permet aux clients potentiels DDE d'identifier l'application. Il est préférable que les applications de Tivoli Service Desk Developer's Toolkit utilisent le nom de la principale base de connaissances.

Remarques

DDERespond est utilisé pour répondre à un $MsgDDEInitate. Il permet d'identifier l'application comme le serveur DDE auprès de clients DDE (déclencheurs). $MsgDDEInitiate contient le nom de l'application requise dans $DDEData et le domaine requis dans $DDETopic. Pour chaque application ou domaine correspondant, un serveur doit appeler DDERespond avec les éléments suivants :

Les chaînes vides ou $Unknown doivent correspondre à n'importe quel appName ou domaine.

Exemple

  VARIABLES
  rc              :INTEGER;
 partner_whdl: WINDOW;
 partner_topic: STRING;
 partner_data: STRING;

EVENT DDEWindow( REF DDEDataRec: DDEREC ) IS
 ...
ACTIONS
     WHEN $Event IS $MsgCreate THEN
 ...
 ELSWHEN $MsgDDEInitiate THEN
 (* Look in $DDETopic, $DDEData and $DDEWindow for
 information. *)
 WHEN $DDETopic IS '' THEN
 (* Indicate all topics to which this app will respond *)
 DDERespond($Handle, $DDEWindow, 'TOPIC1',
 thisAppName);
 DDERespond($Handle, $DDEWindow, 'TOPIC2',
 thisAppName);
 ELSWHEN 'TOPIC1' THEN
 DDERespond($Handle, $DDEWindow, 'TOPIC1',
 thisAppName);
 ELSWHEN 'TOPIC2' THEN
 DDERespond($Handle, $DDEWindow, 'TOPIC2',
 thisAppName);
              END;
 ...
              END;
              END;

Codes retour

Code retour Description
1 Opération exécutée avec succès.
-2 Valeur inconnue.

Voir aussi

Pour plus de détails, reportez-vous à la page Messages de TSD Script.

Pour avoir d'autres exemples sur l'utilisation des commandes DDE en langage TSD Script afin de communiquer avec les autres applications, reportez-vous aux fichiers ddetcli.kb et ddetsrv.kb dans le répertoire EXAMPLES/DDE où Tivoli Service Desk Developer's Toolkit a été installé.


DDETerminate

Description

Permet de mettre fin à une conversation DDE.

Syntaxe

 FUNCTION DDETerminate(VAL whdl, VAL whdlPartner: WINDOW):INTEGER;

Attention : lorsqu'il est mis fin aux conversations DDE de façon incorrecte, cela peut interrompre l'exécution du programme.

Remarques concernant les arguments

Nom de l'argument Description
whdl Descripteur de la fenêtre de l'application qui reçoit les réponses du partenaire DDE. En général, cette fenêtre est un enfant du bureau et constitue la fenêtre principale de l'application. Lorsque la fonction DDE répond à un message DDE, le pseudo-paramètre utilisé est $Handle.
whdlPartner Descripteur de la fenêtre de l'application partenaire lors de la conversation. Il s'agit de la fenêtre à laquelle accède la fonction DDE.

Remarques

Lorsqu'une connexion DDE whdlPartner est établit, la valeur de la fenêtre de l'application du partenaire doit être enregistrée dans une variable locale de type WINDOW (DDEPartnerWindow, par exemple). La valeur de l'application partenaire se trouve dans le pseudo-paramètre $DDEWindow immédiatement après que la connexion DDE a été établie.

Par exemple :

 ...
VARIABLES&;DDEPartnerWindow : WINDOW;
...
ELSWHEN $MsgInitiate THEN
...
DDEPartnerWindow := $DDEWindow;
...

Pendant que le programme se termine ou qu'il gère l'événement $MsgDestroy, appelez DDETerminate avec les paramètres $Handle et le descripteur de fenêtre de l'application du partenaire distant (DDEPartnerWindow) pour éviter les fuites de mémoire.

Par exemple :

    ELSWHEN $MsgDestroy THEN
...
DDETerminate ($Handle, DDEPartnerWindow);
...

Exemple

 TYPES
 DDEPARTNERREC IS RECORD
 whdl: WINDOW;
 topic: STRING;
 appName: STRING;
 data: STRING;
              END;

 DDEREC IS RECORD
 partners: LIST OF DDEPARTNERREC;
 whdlPartner: WINDOW;
              END;

EVENT DDEWindow( REF DDEDataRec: DDEREC ) IS
 ...
ACTIONS
     WHEN $Event IS $MsgCreate THEN
 ...
   ELSWHEN $MsgDestroy THEN

 (* Must terminate the sessions for all
 initiated partners. *)

 FOR ddeDataRec.partners DO
 DDETerminate ( $Handle, ddeDataRec.partners
 [$CURRENT].whdl );
              END;
              END;
 ...
END; ...

Codes retour

Code retour Description
1 Opération exécutée avec succès.
-10 Un appel a échoué au niveau du système d'exploitation. Cela peut être dû à une configuration incorrecte ou à une inadéquation des ressources.

Voir aussi

Pour avoir d'autres exemples sur l'utilisation des commandes DDE en langage TSD Script afin de communiquer avec les autres applications, reportez-vous aux fichiers ddetcli.kb et ddetsrv.kb dans le répertoire EXAMPLES/DDE où Tivoli Service Desk Developer's Toolkit a été installé.


DDEUnAdvise

Description

Permet d'annuler une demande DDEAdvise.

Syntaxe

 FUNCTION DDEUnAdvise(VAL whdl, whdlPartner: WINDOW,
                      VAL topic: STRING): INTEGER;

Remarques concernant les arguments

Nom de l'argument Description
whdl Descripteur de la fenêtre de l'application qui reçoit les réponses du partenaire DDE. En général, cette fenêtre est un enfant du bureau et constitue la fenêtre principale de l'application. Lorsque la fonction DDE répond à un message DDE, le pseudo-paramètre utilisé est $Handle.
whdlPartner Descripteur de la fenêtre de l'application partenaire lors de la conversation. Il s'agit de la fenêtre à laquelle accède la fonction DDE. C'est habituellement le pseudo-paramètre $DDEWindow qui fait partie de tous les messages DDE.
topic Données adressées à l'application partenaire par la fonction DDE. Les deux applications participant à une conversation DDE doivent décider des domaines abordés et des actions possibles pour un domaine donné. Si la chaîne du domaine est vide, tous les domaines sont pris en charge.

Remarques

DDEUnAdvise permet d'annuler un DDEAdvise pour un domaine ou un serveur donné. Si la chaîne du domaine est de longueur zéro, tous les conseils sont annulés sur ce serveur pour le client demandeur.

Exemple

Pour avoir un exemple sur l'utilisation des commandes DDE en langage TSD Script afin de communiquer avec les autres applications, reportez-vous aux fichiers ddetcli.kb et ddetsrv.kb dans le répertoire EXAMPLES/DDE où Tivoli Service Desk Developer's Toolkit a été installé.

Codes retour

Code retour Description
1 Opération exécutée avec succès
-2 Valeur inconnue
-10 Un appel a échoué au niveau du système d'exploitation. Cela peut être dû à une configuration incorrecte ou à une inadéquation des ressources.

Voir aussi


Tivoli Service Desk 6.0 Developer's Toolkit Script - Manuel de référence du langage TSD Script

Retour à la page principale

Copyright