Tivoli Service Desk 6.0 Developer's Toolkit - Referência de Linguagem do Script

Instruções do DDE

Retornar a Página Principal


DDEAdvise

Descrição

Solicita um servidor DDE para aconselhar a aplicativo quando a data associada a um tópico solicitado é alterada.

Sintaxe

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

Notas do Argumento

Nome do Argumento Descrição
whdl O parâmetro identificador de janela da janela do aplicativo que recebe mensagens de resposta a partir de um parceiro do DDE. Geralmente, esta janela é um filho do ambiente de trabalho e é a janela principal do aplicativo. Quando a função do DDE responde a uma mensagem do DDE, este parâmetro é ao parâmetro pseudo $Handle.
whdlPartner O parâmetro identificador do aplicativo do parceiro na conversação. Esta é a janela que a função do DDE envia. Tipicamente, este é o parâmetro pseudo $DDEWindow que é parte de todas as mensagens do DDE.
topic O item de dados endereçado no aplicativo do parceiro pela função do DDE. Os dois aplicativos empregados em uma conversação do DDE devem estar de acordo com os tópicos de conversação e com as ações disponíveis para um determinado tópico. Se a cadeia de tópico estiver vazia, todos os tópicos disponíveis serão assumidos.
Sinalizador Um sinalizador que indica o tipo de estudo solicitado. Os valores possíveis são:
  • $DDEack - Solicita um aviso de confirmação do parceiro
  • $DDENoData - Adverte quando dados foram alterados (pela Mensagem de Dados do DDE) mas não transmite os dados.

Notas

DDEAdvise solicita um servidor DDE envie um $MsgDDEData para o parâmetro identificador de janela, sempre que os dados associados ao tópico são alterados. As mensagens de dados enviadas de tal maneira que não tem o bit DDEResponse definido nos sinalizadores de status. Uma mensagem DDEAdvise pode ser cancelada por um DDEUnAdvise.

Exemplo

Para obter um exemplo sobre a utilização de comandos DDE em TSD Script para se comunicar com outros aplicativos, consulte os arquivos, ddetcli.kb e ddetsrv.kb no diretório EXAMPLES/DDE onde o Tivoli Service Desk Developer's Toolkit foi instalado.

Códigos de Retorno

Código de Retorno Descrição
1 Conclusão bem-sucedida
-2 Valor Desconhecido
-10 Uma chamada falhou no nível do sistema operacional. O motivo pode ser uma configuração imprópria ou recursos inadequados.

Consulte também

Para obter maiores informações, consulte a página Mensagens do TSD Script.


DDEData

Descrição

Envia dados através do DDE para um aplicativo de solicitação.

Sintaxe

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

Notas do Argumento

Nome do Argumento Descrição
whdl O parâmetro identificador de janela da janela do aplicativo que recebe mensagens de resposta a partir de um parceiro do DDE. Geralmente, esta janela é um filho do ambiente de trabalho e é a janela principal do aplicativo. Quando a função do DDE responde a uma mensagem do DDE, este parâmetro é ao parâmetro pseudo $Handle.
whdlPartner O parâmetro identificador de janela da janela do aplicativo do parceiro na conversação. Esta é a janela que a função do DDE envia. Tipicamente, este é o parâmetro pseudo $DDEWindow que é parte de todas as mensagens do DDE.
topic O item de dados endereçado no aplicativo do parceiro pela função do DDE. Os dois aplicativos empregados em uma conversação do DDE devem estar de acordo com os tópicos de conversação e com as ações disponíveis para um determinado tópico. Se a cadeia de tópico estiver vazia, todos os tópicos disponíveis serão assumidos.
data Os dados a serem enviados para o aplicativo do parceiro.
Sinalizador Um sinalizador que indica o tipo de estudo solicitado. Os valores possíveis são:
  • $DDEack - Solicita um aviso de confirmação do parceiro
  • $DDENoData - Adverte quando dados foram alterados (pela Mensagem de Dados do DDE) mas não transmite os dados.

Notas

DDEData envia os dados em resposta a um $MsgDDERequest. Ele também pode enviar os dados que um aplicativo solicitou. DDEPoke é utilizado para enviar dados não-solicitados para um aplicativo.

Exemplo

 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;

Códigos de Retorno

Código de Retorno Descrição
1 Conclusão bem-sucedida
-2 Valor Desconhecido
-10 Uma chamada falhou no nível do sistema operacional. O motivo pode ser uma configuração imprópria ou recursos inadequados.

Consulte também

Consulte a página Mensagens do TSD Script para obter maiores informações.

Para obter um exemplo sobre a utilização de comandos DDE em TSD Script para se comunicar com outros aplicativos, consulte os arquivos, ddetcli.kb e ddetsrv.kb no diretório EXAMPLES/DDE onde o Tivoli Service Desk Developer's Toolkit foi instalado.


DDEExecute

Descrição

Envia uma cadeia de comandos para execução por um parceiro do DDE.

Sintaxe

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

Notas do Argumento

Nome do Argumento Descrição
whdl O parâmetro identificador de janela da janela do aplicativo que recebe mensagens de resposta a partir de um parceiro do DDE. Geralmente, esta janela é um filho do ambiente de trabalho e é a janela principal do aplicativo. Quando a função do DDE responde a uma mensagem do DDE, este parâmetro é ao parâmetro pseudo $Handle.
whdlPartner O parâmetro identificador de janela da janela do aplicativo do parceiro na conversação. Esta é a janela que a função do DDE envia. Tipicamente, este é o parâmetro pseudo $DDEWindow que é parte de todas as mensagens do DDE.
topic O item de dados endereçado no aplicativo do parceiro pela função do DDE. Os dois aplicativos empregados em uma conversação do DDE devem estar de acordo com os tópicos de conversação e com as ações disponíveis para um determinado tópico. Se a cadeia de tópico estiver vazia, todos os tópicos disponíveis serão assumidos.
cmdString Um comando de cadeia para o parceiro do DDE. O conteúdo e o formato da cadeia de comando deve estar de acordo com os aplicativos engajados na conversação do DDE.

Exemplo

 VARIABLES
  rc :INTEGER;
 partner_whdl: WINDOW;
 partner_topic: STRING;
ACTIONS
 .
 . (* Assumir um a sessão DDE foi iniciado, o tópico está
 definido. *)
 .
 rc := DDEExecute ( $Handle, partner_whdl, partner_topic,
                    "del *.*" );
IF (rc <> 1) THEN
 (* DDEExecute falhou *)
ELSE
 (* DDEExecute foi sucedido *)
              END;
 .
 .
 .
              END;

Códigos de Retorno

Código de Retorno Descrição
1 Conclusão bem-sucedida.
-2 Valor desconhecido.
-10 Uma chamada falhou no nível do sistema operacional. O motivo pode ser uma configuração imprópria ou recursos inadequados.

Consulte também

Para obter informações, consulte a página Mensagens do TSD Script.

Para obter exemplos adicionais sobre a utilização de comandos DDE em TSD Script para se comunicar com outros aplicativos, consulte os arquivos, ddetcli.kb e ddetsrv.kb no diretório EXAMPLES/DDE, onde o Tivoli Service Desk Developer's Toolkit foi instalado.


DDEInitiate

Descrição

Inicia uma conversação do DDE com um ou mais parceiros.

Sintaxe

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

Notas do Argumento

Nome do Argumento Descrição
whdl O parâmetro identificador de janela da janela do aplicativo que recebe mensagens de resposta a partir de um parceiro do DDE. Geralmente, esta janela é um filho do ambiente de trabalho e é a janela principal do aplicativo. Quando a função do DDE responde a uma mensagem do DDE, este parâmetro é ao parâmetro pseudo $Handle.
topic O item de dados endereçado no aplicativo do parceiro pela função do DDE. Os dois aplicativos empregados em uma conversação do DDE devem estar de acordo com os tópicos de conversação e com as ações disponíveis para um determinado tópico. Se a cadeia de tópico estiver vazia, todos os tópicos disponíveis serão assumidos.
appName O nome de um aplicativo com o qual este aplicativo deseja conversar. Se appName for uma cadeia vazia ou $Unknown, todos os aplicativos que suportam o tópico solicitado serão esperadas responderem.

Notas

DDEInitiate difunde uma mensagem de iniciação para todas as janelas filhas do ambiente de trabalho. A mensagem de iniciação é específica da plataforma.

Se um appName for especificado, qualquer aplicativo com o appName correspondente deverá responder. O aplicativo correspondente deve enviar um $MsgDDEInitAcknowledge à janela inicial. Se appName for uma cadeia vazia, qualquer aplicativo poderá responder.

Se o tópico tiver uma cadeia de comprimento zero, todos os aplicativos correspondentes devem relatar todos os tópicos disponíveis. Por exemplo, chamar DDEInitiate com um appName vazio e uma cadeia de tópico vazia solicita todos os tópicos a partir de aplicativos que são servidores DDE.

Exemplo

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

(* Variáveis do parceiro assumidas foram enviadas. *)

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

Códigos de Retorno

Código de Retorno Descrição
1 Conclusão bem-sucedida.
-2 Valor desconhecido.
-10 Um pedido para um serviço do sistema operacional (requerido para completar a função) falhou. Provavelmente, as causas são valores inválidos como argumentos para a instrução ou limitações de recurso do sistema.

Consulte também

Para obter informações, consulte a página Mensagens do TSD Script.

Para obter um exemplo sobre a utilização de comandos DDE em TSD Script para se comunicar com outros aplicativos, consulte os arquivos, ddetcli.kb e ddetsrv.kb no diretório EXAMPLES/DDE onde o Tivoli Service Desk Developer's Toolkit foi instalado.

Para obter maiores informações sobre a interface do DDE, consulte a documentação de seu fornecedor.


DDEPoke

Descrição

Envia dados não-solicitados para um parceiro do DDE.

Sintaxe

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

Notas do Argumento

Nome do Argumento Descrição
whdl O parâmetro identificador de janela da janela de aplicativo que recebe mensagens de resposta a partir de um parceiro do DDE. Geralmente, esta janela é um filho do ambiente de trabalho e é a janela principal do aplicativo. Quando a função do DDE responde a uma mensagem do DDE, este parâmetro é ao parâmetro pseudo $Handle.
whdlPartner O parâmetro identificador de janela da janela do aplicativo do parceiro na conversação. Esta é a janela que a função do DDE envia. Tipicamente, este é o parâmetro pseudo $DDEWindow que é parte de todas as mensagens do DDE.
topic O item de dados endereçado no aplicativo do parceiro pela função do DDE. Os dois aplicativos empregados em uma conversação do DDE devem estar de acordo com os tópicos de conversação e com as ações disponíveis para um determinado tópico. Se a cadeia de tópico estiver vazia, todos os tópicos disponíveis serão assumidos.
data Envia dados não-solicitados para um parceiro do DDE. O aplicativo de recepção deve saber como aceitar dados no tópico especificado.

Exemplo

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

ACTIONS

(* Assumir a sessão Iniciada, as variáveis de parceiros foram
 definidas. *)

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

Códigos de Retorno

Código de Retorno Descrição
1 Conclusão bem-sucedida.
-2 Valor desconhecido.
-10 Uma chamada falhou no nível do sistema operacional. O motivo pode ser uma configuração imprópria ou recursos inadequados.

Consulte também

DDEData

Para obter informações, consulte a página Mensagens do TSD Script.

Para obter exemplos adicionais sobre a utilização de comandos DDE em TSD Script para se comunicar com outros aplicativos, consulte os arquivos, ddetcli.kb e ddetsrv.kb no diretório EXAMPLES/DDE, onde o Tivoli Service Desk Developer's Toolkit foi instalado.


DDERequest

Descrição

Solicita dados a partir de um parceiro do DDE.

Sintaxe

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

Notas do Argumento

Nome do Argumento Descrição
whdl O parâmetro identificador de janela da janela de aplicativo que recebe mensagens de resposta a partir de um parceiro do DDE. Geralmente, esta janela é um filho do ambiente de trabalho e é a janela principal do aplicativo. Quando a função do DDE responde a uma mensagem do DDE, este parâmetro é ao parâmetro pseudo $Handle.
whdlPartner O parâmetro identificador de janela da janela do aplicativo do parceiro na conversação. Esta é a janela que a função do DDE envia. Tipicamente, este é o parâmetro pseudo $DDEWindow que é parte de todas as mensagens do DDE.
topic O item de dados endereçado no aplicativo do parceiro pela função do DDE. Os dois aplicativos empregados em uma conversação do DDE devem estar de acordo com os tópicos de conversação e com as ações disponíveis para um determinado tópico. Se a cadeia de tópico estiver vazia, todos os tópicos disponíveis serão assumidos.

Notas

O aplicativo do parceiro pode responder ao envio de dados solicitados ou ao envio de uma confirmação negativa ($MsgDDEAcknowledge).

Exemplo

 VARIABLES
  rc :INTEGER;
 partner_whdl: WINDOW;
 partner_topic: STRING;
 partner_data: STRING;
ACTIONS
(* Assumir a sessão Iniciada, as variáveis de parceiros foram
 definidas. *)
 DDERequest ( $Handle, partner_whdl, partner_topic );

 (* O Parceiro do DDE irá responder aos Dados ou Confirmação de Recebimento *)

EVENT DDEWindow( REF DDEDataRec: DDEREC ) IS
 ...
ACTIONS
 WHEN $Event IS $MsgCreate THEN
 ...
 ELSWHEN $MsgDDEAcknowledge THEN
 (* Olhe em $DDETopic, $DDEData e $DDEStatus para obter
 informações. *)
 ...
 ELSWHEN $MsgDDEData THEN
 (* Olhe em $DDETopic e $DDEData para obter informações. *)
 ...
 END;
END;

Códigos de Retorno

Código de Retorno Descrição
1 Conclusão bem-sucedida.
-2 Valor desconhecido.
-10 Uma chamada falhou no nível do sistema operacional. O motivo pode ser uma configuração imprópria ou recursos inadequados.

Consulte também

Para obter informações, consulte a página Mensagens do TSD Script.

Para obter um exemplo sobre a utilização de comandos DDE em TSD Script para se comunicar com outros aplicativos, consulte os arquivos, ddetcli.kb e ddetsrv.kb no diretório EXAMPLES/DDE onde o Tivoli Service Desk Developer's Toolkit foi instalado.


DDERespond

Descrição

Envia uma resposta para uma mensagem $MsgDDEInitiate.

Sintaxe

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

Notas do Argumento

Nome do Argumento Descrição
whdl O parâmetro identificador de janela da janela de aplicativo que recebe mensagens de resposta a partir de um parceiro do DDE. Geralmente, esta janela é um filho do ambiente de trabalho e é a janela principal do aplicativo. Quando a função do DDE responde a uma mensagem do DDE, este parâmetro é ao parâmetro pseudo $Handle.
whdlPartner O parâmetro identificador de janela da janela do aplicativo do parceiro na conversação. Esta é a janela que a função do DDE envia. Tipicamente, este é o parâmetro pseudo $DDEWindow que é parte de todas as mensagens do DDE.
topic O item de dados endereçado no aplicativo do parceiro pela função do DDE. Os dois aplicativos empregados em uma conversação do DDE devem estar de acordo com os tópicos de conversação e com as ações disponíveis para um determinado tópico. Se a cadeia de tópico estiver vazia, todos os tópicos disponíveis serão assumidos.
appName O nome do aplicativo de chamada. Este nome identifica o aplicativo para clientes DDE potenciais. É recomendado que os aplicativos Tivoli Service Desk Developer's Toolkit utilizam o nome da base de informações principal.

Notas

DDERespond é utilizado em resposta a um $MsgDDEInitate. Ele identifica o aplicativo como um servidor DDE para clientes DDE potenciais (iniciadores). $MsgDDEInitiate contém um nome de aplicativo solicitado em $DDEData e um tópico solicitado em $DDETopic. Para cada aplicativo ou tópico correspondente, um servidor é esperado chamar DDERespond com o seguinte:

Cadeias vazias ou $Unknown são supostas corresponderem a qualquer appName ou topic.

Exemplo

 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
 (* Olhe em $DDETopic, $DDEData e $DDEWindow para
 obter informações. *)
 WHEN $DDETopic IS '' THEN
 (* Indica todos os tópicos aos quais esta app irá responder *)
 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;

Códigos de Retorno

Código de Retorno Descrição
1 Conclusão bem-sucedida.
-2 Valor desconhecido.

Consulte também

Para obter informações, consulte a página Mensagens do TSD Script.

Para obter um exemplo sobre a utilização de comandos DDE em TSD Script para se comunicar com outros aplicativos, consulte os arquivos, ddetcli.kb e ddetsrv.kb no diretório EXAMPLES/DDE onde o Tivoli Service Desk Developer's Toolkit foi instalado.


DDETerminate

Descrição

Termina uma conversação do DDE.

Sintaxe

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

Atenção: As conversações do DDE terminadas de forma incorreta, podem fazer com que o programa interrompa o processamento.

Notas do Argumento

Nome do Argumento Descrição
whdl O parâmetro identificador de janela da janela de aplicativo que recebe mensagens de resposta a partir de um parceiro do DDE. Geralmente, esta janela é um filho do ambiente de trabalho e é a janela principal do aplicativo. Quando a função do DDE responde a uma mensagem do DDE, este parâmetro é ao parâmetro pseudo $Handle.
whdlPartner O parâmetro identificador de janela da janela do aplicativo do parceiro na conversação. Esta é a janela que a função do DDE envia.

Notas

Após uma conexão whdlPartner ao DDE ser estabelecida, o valor da janela de aplicativo do parceiro deverá ser armazenado em uma variável local do tipo WINDOW (DDEPartnerWindow, por exemplo). O valor do aplicativo do parceiro pode ser encontrado no parâmetro pseudo $DDEWindow imediatamente após a conexão ao DDE ser estabelecida.

Por exemplo:

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

Quando o programa termina e enquanto ele está manipulando o evento $MsgDestroy, chame DDETerminate com os parâmetros $Handle e o parâmetro identificador de janela do aplicativo do parceiro remota (DDEPartnerWindow) para evitar perda de memória.

Por exemplo:

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

Exemplo

 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

 (* É necessário terminar as sessões para todos os
 parceiros iniciados. *)

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

Códigos de Retorno

Código de Retorno Descrição
1 Conclusão bem-sucedida.
-10 Uma chamada falhou no nível do sistema operacional. O motivo pode ser uma configuração imprópria ou recursos inadequados.

Consulte também

Para obter um exemplo sobre a utilização de comandos DDE em TSD Script para se comunicar com outros aplicativos, consulte os arquivos, ddetcli.kb e ddetsrv.kb no diretório EXAMPLES/DDE onde o Tivoli Service Desk Developer's Toolkit foi instalado.


DDEUnAdvise

Descrição

Cancela um pedido DDEAdvise.

Sintaxe

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

Notas do Argumento

Nome do Argumento Descrição
whdl O parâmetro identificador de janela da janela de aplicativo que recebe mensagens de resposta a partir de um parceiro do DDE. Geralmente, esta janela é um filho do ambiente de trabalho e é a janela principal do aplicativo. Quando a função do DDE responde a uma mensagem do DDE, este parâmetro é ao parâmetro pseudo $Handle.
whdlPartner O parâmetro identificador de janela da janela do aplicativo do parceiro na conversação. Esta é a janela que a função do DDE envia. Tipicamente, este é o parâmetro pseudo $DDEWindow que é parte de todas as mensagens do DDE.
topic O item de dados endereçado no aplicativo do parceiro pela função do DDE. Os dois aplicativos empregados em uma conversação do DDE devem estar de acordo com os tópicos de conversação e com as ações disponíveis para um determinado tópico. Se a cadeia de tópico estiver vazia, todos os tópicos disponíveis serão assumidos.

Notas

DDEUnAdvise cancela um DDEAdvise para obter um tópico fornecido em um servidor determinado. Se o tópico for uma cadeia de comprimento 0, todas as opiniões são canceladas neste servidor para o cliente solicitante.

Exemplo

Para obter um exemplo sobre a utilização de comandos DDE em TSD Script para se comunicar com outros aplicativos, consulte os arquivos, ddetcli.kb e ddetsrv.kb no diretório EXAMPLES/DDE onde o Tivoli Service Desk Developer's Toolkit foi instalado.

Códigos de Retorno

Código de Retorno Descrição
1 Conclusão bem-sucedida
-2 Valor Desconhecido
-10 Uma chamada falhou no nível do sistema operacional. O motivo pode ser uma configuração imprópria ou recursos inadequados.

Consulte também


Tivoli Service Desk 6.0 Developer's Toolkit - Referência de Linguagem do Script

Retornar à Página Principal

Copyright