Riferimento Lingua del Tivoli Service Desk 6.0 Developer's Toolkit Script
Ritorna alla pagina principale
Richiede a un server DDE di avvisare l'applicazione quando i dati associati a un argomento vengono modificati.
FUNCTION DDEAdvise(VAL whdl, whdlPartner: WINDOW, VAL topic:STRING,VAL Flag: INTEGER) : INTEGER;
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:
|
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.
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.
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. |
Per ulteriori informazioni consultare la pagina Messaggi TSD Script.
Invia dati tramite DDE a un'applicazione richiedente.
FUNCTION DDEData(VAL whdl, whdlPartner: WINDOW, VAL topic,data: STRING, VAL Flag: INTEGER): INTEGER;
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:
|
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.
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;
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. |
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.
Invia una stringa comandi per l'esecuzione da parte di un partner DDE.
FUNCTION DDEExecute(VAL whdl, whdlPartner: WINDOW, VAL topic, cmdString: STRING) : INTEGER;
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. |
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;
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. |
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.
Inizia una conversazione DDE con uno o più partner.
FUNCTION DDEInitiate(VAL whdl: WINDOW, VAL topic, appName: STRING): INTEGER;
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. |
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.
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;
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. |
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.
Invia dati non richiesti a un partner DDE.
FUNCTION DDEPoke(VAL whdl, whdlPartner: WINDOW, VAL topic, data: STRING): INTEGER;
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. |
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;
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. |
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.
Richiede dati da un partner DDE.
FUNCTION DDERequest(VAL whdl, whdlPartner: WINDOW, VAL topic: STRING): INTEGER;
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. |
L'applicazione del partner può rispondere inviando i dati richiesti o un riconoscimento negativo ($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;
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. |
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.
Invia una risposta a un messaggio $MsgDDEInitiate.
FUNCTION DDERespond(VAL whdl, whdlPartner: WINDOW, VAL topic, VAL appName: STRING): INTEGER;
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. |
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.
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;
Codice di ritorno | Descrizione |
1 | Completamento riuscito. |
-2 | Valore sconosciuto. |
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.
Termina una conversazione DDE.
FUNCTION DDETerminate(VAL whdl, VAL whdlPartner: WINDOW):INTEGER;
Avvertenza: Le conversazioni DDE terminate in modo improprio possono provocare al programma l'interruzione dell'elaborazione.
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. |
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); ...
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; ...
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. |
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.
Annulla una richiesta DDEAdvise.
FUNCTION DDEUnAdvise(VAL whdl, whdlPartner: WINDOW, VAL topic: STRING): INTEGER;
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. |
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.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.
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. |
Riferimento Lingua del Tivoli Service Desk 6.0 Developer's Toolkit Script
Ritorna alla pagina principale