Tivoli Service Desk 6.0 Developer's Toolkit Script - Manuel de référence du langage TSD Script
Retour à la page principale
Permet de demander au serveur DDE d'indiquer à l'application les modifications des données associées au domaine demandé.
FUNCTION DDEAdvise(VAL whdl, whdlPartner: WINDOW, VAL topic:STRING,VAL Flag: INTEGER) : INTEGER;
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 :
|
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.
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é.
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. |
Pour plus de détails , reportez-vous à la page Messages de TSD Script.
Permet d'envoyer des données via DDE à l'application qui les demande.
FUNCTION DDEData(VAL whdl, whdlPartner: WINDOW, VAL topic,data: STRING, VAL Flag: INTEGER): INTEGER;
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 :
|
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.
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;
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. |
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é.
Envoie une chaîne de commande à exécuter par un partenaire DDE.
FUNCTION DDEExecute(VAL whdl, whdlPartner: WINDOW, VAL topic, cmdString: STRING) : INTEGER;
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. |
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;
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. |
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é.
Permet de commencer une conversation DDE avec un ou plusieurs partenaires.
FUNCTION DDEInitiate(VAL whdl: WINDOW, VAL topic, appName: STRING): INTEGER;
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. |
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.
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;
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. |
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.
Permet d'envoyer des données non-demandées à un partenaire DDE.
FUNCTION DDEPoke(VAL whdl, whdlPartner: WINDOW, VAL topic, data: STRING): INTEGER;
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. |
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;
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. |
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é.
Permet de demander des données à un partenaire DDE.
FUNCTION DDERequest(VAL whdl, whdlPartner: WINDOW, VAL topic: STRING): INTEGER;
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. |
L'application partenaire peut répondre en envoyant les données demandées ou un accusé de réception négatif ($MsgDDEAcknowledge).
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;
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. |
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é.
Permet d'envoyer une réponse à un message $MsgDDEInitiate.
FUNCTION DDERespond(VAL whdl, whdlPartner: WINDOW, VAL topic, VAL appName: STRING): INTEGER;
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. |
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.
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;
Code retour | Description |
1 | Opération exécutée avec succès. |
-2 | Valeur inconnue. |
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é.
Permet de mettre fin à une conversation DDE.
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.
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. |
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); ...
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; ...
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. |
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é.
Permet d'annuler une demande DDEAdvise.
FUNCTION DDEUnAdvise(VAL whdl, whdlPartner: WINDOW, VAL topic: STRING): INTEGER;
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. |
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.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é.
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. |
Tivoli Service Desk 6.0 Developer's Toolkit Script - Manuel de référence du langage TSD Script