Riferimento Lingua del Tivoli Service Desk 6.0 Developer's Toolkit Script

Istruzioni DDE

Ritorna alla pagina principale


DDEAdvise

Descrizione

Richiede a un server DDE di avvisare l'applicazione quando i dati associati a un argomento vengono modificati.

Sintassi

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

Note argomenti

Nome dell'argomento Descrizione
whdl L'handle della finestra della finestra dell'applicazione che riceve i messaggi di risposta da un partner DDE. Generalmente, questa è una finestra figlio della desktop ed è la finestra principale dell'applicazione. Quando la funzione DDE risponde a un messaggio DDE, questo parametro è lo pseudo parametro $Handle.
whdlPartner L'handle di una finestra proveniente dall'applicazione del partner nella conversazione. Questa è la finestra a cui conduce la funzione DDE. Generalmente, questo è lo pseudo parametro $DDEWindow che fa parte di tutti i messaggi DDE.
topic La voce dati a cui la funzione DDE si riferisce nell'applicazione del partner. Entrambe le applicazioni impegnate in una conversazione DDE devono concordare sugli argomenti della conversazione e sulle azioni disponibili per un dato argomento. Se la stringa argomento è vuota, si suppone che tutti gli argomenti siano disponibili.
Flag Un indicatore che segnala il tipo di avvertimento richiesto. I valori possibili sono:
  • $DDEack - Richiesta di un riconoscimento dal partner
  • $DDENoData - Avvertimento della modifica dei dati (tramite Messaggio dati DDE) senza inoltrarli.

Note

DDEAdvise richiede a un server DDE di inviare un $MsgDDEData all'handle della finestra quando i dati associati all'argomento vengono modificati. I messaggi di dati inviati in questo modo non dispongono del bit DDEResponse impostato nei loro indicatori di stato. Un messaggio DDEAdvise può essere annullato da un DDEUnAdvise.

Esempio

Per un esempio sull'utilizzo dei comandi DDE in TSD Script per comunicare con altre applicazioni, consultare i file ddetcli.kb e ddetsrv.kb nella directory EXAMPLES/DDE dove è stato installato TSD Developer's Toolkit.

Codici di ritorno

Codice di ritorno Descrizione
1 Completamento riuscito
-2 Valore sconosciuto
-10 La chiamata ha avuto esito negativo al livello del sistema operativo. Questo può essere causato da una configurazione non corretta o da risorse inadeguate.

Consultare anche

Per ulteriori informazioni consultare la pagina Messaggi TSD Script.


DDEData

Descrizione

Invia dati tramite DDE a un'applicazione richiedente.

Sintassi

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

Note argomenti

Nome dell'argomento Descrizione
whdl L'handle della finestra della finestra dell'applicazione che riceve i messaggi di risposta da un partner DDE. Generalmente, questa è una finestra figlio della desktop ed è la finestra principale dell'applicazione. Quando la funzione DDE risponde a un messaggio DDE, questo parametro è lo pseudo parametro $Handle.
whdlPartner L'handle della finestra proveniente dalla finestra dell'applicazione del partner nella conversazione. Questa è la finestra a cui conduce la funzione DDE. Generalmente, questo è lo pseudo parametro $DDEWindow che fa parte di tutti i messaggi DDE.
topic La voce dati a cui la funzione DDE si riferisce nell'applicazione del partner. Entrambe le applicazioni impegnate in una conversazione DDE devono concordare sugli argomenti della conversazione e sulle azioni disponibili per un dato argomento. Se la stringa argomento è vuota, si suppone che tutti gli argomenti siano disponibili.
dati I dati da inviare all'applicazione del partner.
Flag Un indicatore che segnala il tipo di avvertimento richiesto. I valori possibili sono:
  • $DDEack - Richiesta di riconoscimento dal partner
  • $DDENoData - Avvertimento della modifica dei dati (tramite Messaggio dati DDE) senza inoltrarli.

Note

DDEData invia i dati in risposta a una $MsgDDERequest. Può anche inviare i dati richiesti da un'applicazione. DDEPoke viene utilizzato per inviare dati non richiesti a un'applicazione.

Esempio

   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;

Codici di ritorno

Codice di ritorno Descrizione
1 Completamento riuscito
-2 Valore sconosciuto
-10 La chiamata ha avuto esito negativo al livello del sistema operativo. Questo può essere causato da una configurazione non corretta o da risorse inadeguate.

Consultare anche

Per ulteriori informazioni, consultare la pagina Messaggi TSD Script.

Per ulteriori esempi sull'utilizzo dei comandi DDE in TSD Script per comunicare con altre applicazioni, consultare i file ddetcli.kb e ddetsrv.kb nella directory EXAMPLES/DDE dove è stato installato TSD Developer's Toolkit.


DDEExecute

Descrizione

Invia una stringa comandi per l'esecuzione da parte di un partner DDE.

Sintassi

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

Note argomenti

Nome dell'argomento Descrizione
whdl L'handle della finestra della finestra dell'applicazione che riceve i messaggi di risposta da un partner DDE. Generalmente, questa è una finestra figlio della desktop ed è la finestra principale dell'applicazione. Quando la funzione DDE risponde a un messaggio DDE, questo parametro è lo pseudo parametro $Handle.
whdlPartner L'handle della finestra proveniente dalla finestra dell'applicazione del partner nella conversazione. Questa è la finestra a cui conduce la funzione DDE. Generalmente, questo è lo pseudo parametro $DDEWindow che fa parte di tutti i messaggi DDE.
topic La voce dati a cui la funzione DDE si riferisce nell'applicazione del partner. Entrambe le applicazioni impegnate in una conversazione DDE devono concordare sugli argomenti della conversazione e sulle azioni disponibili per un dato argomento. Se la stringa argomento è vuota, si suppone che tutti gli argomenti siano disponibili.
cmdString Una stringa comandi per il partner DDE. E' necessario che le applicazioni coinvolte nella conversazione concordino sul contenuto e sul formato della stringa comandi.

Esempio

 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 failed *)
      ELSE
 (* DDEExecute succeeded *)
      END;
 .
 .
 .
      END;

Codici di ritorno

Codice di ritorno Descrizione
1 Completamento riuscito.
-2 Valore sconosciuto.
-10 La chiamata ha avuto esito negativo al livello del sistema operativo. Questo può essere causato da una configurazione non corretta o da risorse inadeguate.

Consultare anche

Per informazioni consultare la pagina Messaggi TSD Script.

Per ulteriori esempi sull'utilizzo dei comandi DDE in TSD Script per comunicare con altre applicazioni, consultare i file ddetcli.kb e ddetsrv.kb nella directory EXAMPLES/DDE dove è stato installato TSD Developer's Toolkit.


DDEInitiate

Descrizione

Inizia una conversazione DDE con uno o più partner.

Sintassi

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

Note argomenti

Nome dell'argomento Descrizione
whdl L'handle della finestra della finestra dell'applicazione che riceve i messaggi di risposta da un partner DDE. Generalmente, questa è una finestra figlio della desktop ed è la finestra principale dell'applicazione. Quando la funzione DDE risponde a un messaggio DDE, questo parametro è lo pseudo parametro $Handle.
topic La voce dati a cui la funzione DDE si riferisce nell'applicazione del partner. Entrambe le applicazioni impegnate in una conversazione DDE devono concordare sugli argomenti della conversazione e sulle azioni disponibili per un dato argomento. Se la stringa argomento è vuota, si suppone che tutti gli argomenti siano disponibili.
appName Il nome di un'applicazione con cui questa applicazione desidera conversare. Se appName è una stringa vuota o $Unknown, si prevede che rispondano tutte le applicazioni che supportano l'argomento richiesto.

Note

DDEInitiate trasmette un messaggio iniziale a tutte le finestre figlio della desktop. Il messaggio iniziale è specifico per la piattaforma.

Se viene specificato un appName, risponderà qualsiasi applicazione con l'appName corrispondente. L'applicazione corrispondente invierà un $MsgDDEInitAcknowledge alla finestra iniziale. Se appName è una stringa vuota, può rispondere qualsiasi applicazione.

Se l'argomento ha una stringa di lunghezza zero, tutte le applicazioni corrispondenti riferiranno tutti gli argomenti disponibili. Ad esempio, la chiamata di DDEInitiate con un appName e una stringa argomento vuoti richiede tutti gli argomenti dalle applicazioni che sono server DDE.

Esempio

 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;

Codici di ritorno

Codice di ritorno Descrizione
1 Completamento riuscito.
-2 Valore sconosciuto.
-10 Una richiesta per un servizio del sistema operativo (necessario per completare la funzione) ha avuto esito negativo. Le probabili cause sono i valori non validi come argomenti per l'istruzione o le limitazioni delle risorse di sistema.

Consultare anche

Per informazioni consultare la pagina Messaggi TSD Script.

Per ulteriori esempi sull'utilizzo dei comandi DDE in TSD Script per comunicare con altre applicazioni, consultare i file ddetcli.kb e ddetsrv.kb nella directory EXAMPLES/DDE dove risiede TSD Developer's Toolkit.

Per ulteriori informazioni sull'interfaccia DDE, consultare la documentazione del rivenditore.


DDEPoke

Descrizione

Invia dati non richiesti a un partner DDE.

Sintassi

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

Note argomenti

Nome dell'argomento Descrizione
whdl L'handle della finestra della finestra dell'applicazione che riceve i messaggi di risposta da un partner DDE. Generalmente, questa è una finestra figlio della desktop ed è la finestra principale dell'applicazione. Quando la funzione DDE risponde a un messaggio DDE, questo parametro è lo pseudo parametro $Handle.
whdlPartner L'handle della finestra proveniente dalla finestra dell'applicazione del partner nella conversazione. Questa è la finestra a cui conduce la funzione DDE. Generalmente, questo è lo pseudo parametro $DDEWindow che fa parte di tutti i messaggi DDE.
topic La voce dati a cui la funzione DDE si riferisce nell'applicazione del partner. Entrambe le applicazioni impegnate in una conversazione DDE devono concordare sugli argomenti della conversazione e sulle azioni disponibili per un dato argomento. Se la stringa argomento è vuota, si suppone che tutti gli argomenti siano disponibili.
dati I dati non richiesti inviati a un partner DDE. E' necessario che l'applicazione ricevente conosca come accettare i dati sull'argomento specificato.

Esempio

 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;

Codici di ritorno

Codice di ritorno Descrizione
1 Completamento riuscito.
-2 Valore sconosciuto.
-10 La chiamata ha avuto esito negativo al livello del sistema operativo. Questo può essere causato da una configurazione non corretta o da risorse inadeguate.

Consultare anche

DDEData

Per informazioni consultare la pagina Messaggi TSD Script.

Per ulteriori esempi sull'utilizzo dei comandi DDE in TSD Script per comunicare con altre applicazioni, consultare i file ddetcli.kb e ddetsrv.kb nella directory EXAMPLES/DDE dove è stato installato TSD Developer's Toolkit.


DDERequest

Descrizione

Richiede dati da un partner DDE.

Sintassi

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

Note argomenti

Nome dell'argomento Descrizione
whdl L'handle della finestra della finestra dell'applicazione che riceve i messaggi di risposta da un partner DDE. Generalmente, questa è una finestra figlio della desktop ed è la finestra principale dell'applicazione. Quando la funzione DDE risponde a un messaggio DDE, questo parametro è lo pseudo parametro $Handle.
whdlPartner L'handle della finestra proveniente dalla finestra dell'applicazione del partner nella conversazione. Questa è la finestra a cui conduce la funzione DDE. Generalmente, questo è lo pseudo parametro $DDEWindow che fa parte di tutti i messaggi DDE.
topic La voce dati a cui la funzione DDE si riferisce nell'applicazione del partner. Entrambe le applicazioni impegnate in una conversazione DDE devono concordare sugli argomenti della conversazione e sulle azioni disponibili per un dato argomento. Se la stringa argomento è vuota, si suppone che tutti gli argomenti siano disponibili.

Note

L'applicazione del partner può rispondere inviando i dati richiesti o un riconoscimento negativo ($MsgDDEAcknowledge).

Esempio

 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;

Codici di ritorno

Codice di ritorno Descrizione
1 Completamento riuscito.
-2 Valore sconosciuto.
-10 La chiamata ha avuto esito negativo al livello del sistema operativo. Questo può essere causato da una configurazione non corretta o da risorse inadeguate.

Consultare anche

Per informazioni consultare la pagina Messaggi TSD Script.

Per ulteriori esempi sull'utilizzo dei comandi DDE in TSD Script per comunicare con altre applicazioni, consultare i file ddetcli.kb e ddetsrv.kb nella directory EXAMPLES/DDE dove è stato installato TSD Developer's Toolkit.


DDERespond

Descrizione

Invia una risposta a un messaggio $MsgDDEInitiate.

Sintassi

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

Note argomenti

Nome dell'argomento Descrizione
whdl L'handle della finestra della finestra dell'applicazione che riceve i messaggi di risposta da un partner DDE. Generalmente, questa è una finestra figlio della desktop ed è la finestra principale dell'applicazione. Quando la funzione DDE risponde a un messaggio DDE, questo parametro è lo pseudo parametro $Handle.
whdlPartner L'handle della finestra proveniente dalla finestra dell'applicazione del partner nella conversazione. Questa è la finestra a cui conduce la funzione DDE. Generalmente, questo è lo pseudo parametro $DDEWindow che fa parte di tutti i messaggi DDE.
topic La voce dati a cui la funzione DDE si riferisce nell'applicazione del partner. Entrambe le applicazioni impegnate in una conversazione DDE devono concordare sugli argomenti della conversazione e sulle azioni disponibili per un dato argomento. Se la stringa argomento è vuota, si suppone che tutti gli argomenti siano disponibili.
appName Il nome dell'applicazione che chiama. Questo nome identifica l'applicazione per i potenziali client DDE. Si consiglia, per le applicazioni TSD Developer's Toolkit, di utilizzare il nome del file .kb principale.

Note

DDERespond viene utilizzato in risposta a un $MsgDDEInitate. Ciò identifica l'applicazione come un server DDE per i potenziali client DDE (iniziatori). $MsgDDEInitiate contiene un nome applicazione necessario in $DDEData e un argomento necessario in $DDETopic. Per ogni corrispondenza di argomento o applicazione, si prevede che un server chiami DDERespond con quanto segue:

Si suppone che le stringhe vuote o $Unknown corrispondano a ogni appName o topic.

Esempio

 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;

Codici di ritorno

Codice di ritorno Descrizione
1 Completamento riuscito.
-2 Valore sconosciuto.

Consultare anche

Per informazioni consultare la pagina Messaggi TSD Script.

Per ulteriori esempi sull'utilizzo dei comandi DDE in TSD Script per comunicare con altre applicazioni, consultare i file ddetcli.kb e ddetsrv.kb nella directory EXAMPLES/DDE dove è stato installato TSD Developer's Toolkit.


DDETerminate

Descrizione

Termina una conversazione DDE.

Sintassi

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

Avvertenza: Le conversazioni DDE terminate in modo improprio possono provocare al programma l'interruzione dell'elaborazione.

Note argomenti

Nome dell'argomento Descrizione
whdl L'handle della finestra della finestra dell'applicazione che riceve i messaggi di risposta da un partner DDE. Generalmente, questa è una finestra figlio della desktop ed è la finestra principale dell'applicazione. Quando la funzione DDE risponde a un messaggio DDE, questo parametro è lo pseudo parametro $Handle.
whdlPartner L'handle della finestra proveniente dalla finestra dell'applicazione del partner nella conversazione. Questa è la finestra a cui conduce la funzione DDE.

Note

Una volta stabilita una connessione whdlPartner DDE, il valore della finestra dell'applicazione del partner deve essere memorizzato in un variabile locale di tipo WINDOW (DDEPartnerWindow, ad esempio). E' possibile trovare il valore dell'applicazione del partner nello pseudo parametro $DDEWindow immediatamente dopo aver stabilito la connessione DDE.

Ad esempio:

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

Quando il programma termina e mentre gestisce l'evento $MsgDestroy, chiamare DDETerminate con i parametri $Handle e l'handle della finestra dell'applicazione remota del partner (DDEPartnerWindow) per evitare perdite di memoria.

Ad esempio:

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

Esempio

   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; ...

Codici di ritorno

Codice di ritorno Descrizione
1 Completamento riuscito.
-10 La chiamata ha avuto esito negativo al livello del sistema operativo. Questo può essere causato da una configurazione non corretta o da risorse inadeguate.

Consultare anche

Per ulteriori esempi sull'utilizzo dei comandi DDE in TSD Script per comunicare con altre applicazioni, consultare i file ddetcli.kb e ddetsrv.kb nella directory EXAMPLES/DDE dove è stato installato TSD Developer's Toolkit.


DDEUnAdvise

Descrizione

Annulla una richiesta DDEAdvise.

Sintassi

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

Note argomenti

Nome dell'argomento Descrizione
whdl L'handle della finestra della finestra dell'applicazione che riceve i messaggi di risposta da un partner DDE. Generalmente, questa è una finestra figlio della desktop ed è la finestra principale dell'applicazione. Quando la funzione DDE risponde a un messaggio DDE, questo parametro è lo pseudo parametro $Handle.
whdlPartner L'handle della finestra proveniente dalla finestra dell'applicazione del partner nella conversazione. Questa è la finestra a cui conduce la funzione DDE. Generalmente, questo è lo pseudo parametro $DDEWindow che fa parte di tutti i messaggi DDE.
topic La voce dati a cui la funzione DDE si riferisce nell'applicazione del partner. Entrambe le applicazioni impegnate in una conversazione DDE devono concordare sugli argomenti della conversazione e sulle azioni disponibili per un dato argomento. Se la stringa argomento è vuota, si suppone che tutti gli argomenti siano disponibili.

Note

DDEUnAdvise annulla un DDEAdvise per un dato argomento su un server specificato. Se l'argomento è una stringa a lunghezza 0, vengono annullati tutti gli avvertimenti su quel server per il client richiedente.

Esempio

Per un esempio sull'utilizzo dei comandi DDE in TSD Script per comunicare con altre applicazioni, consultare i file ddetcli.kb e ddetsrv.kb nella directory EXAMPLES/DDE dove è stato installato TSD Developer's Toolkit.

Codici di ritorno

Codice di ritorno Descrizione
1 Completamento riuscito
-2 Valore sconosciuto
-10 La chiamata ha avuto esito negativo al livello del sistema operativo. Questo può essere causato da una configurazione non corretta o da risorse inadeguate.

Consultare anche


Riferimento Lingua del Tivoli Service Desk 6.0 Developer's Toolkit Script

Ritorna alla pagina principale

Copyright