Tivoli Service Desk 6.0 Developer's Toolkit - Referência de Linguagem do Script
Retornar a Página Principal
Solicita um servidor DDE para aconselhar a aplicativo quando a data associada a um tópico solicitado é alterada.
FUNCTION DDEAdvise(VAL whdl, whdlPartner: WINDOW, VAL topic:STRING,VAL Flag: INTEGER) : INTEGER;
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:
|
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.
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ó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. |
Para obter maiores informações, consulte a página Mensagens do TSD Script.
Envia dados através do DDE para um aplicativo de solicitação.
FUNCTION DDEData(VAL whdl, whdlPartner: WINDOW, VAL topic,data: STRING, VAL Flag: INTEGER): INTEGER;
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:
|
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.
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ó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 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.
Envia uma cadeia de comandos para execução por um parceiro do DDE.
FUNCTION DDEExecute(VAL whdl, whdlPartner: WINDOW, VAL topic, cmdString: STRING) : INTEGER;
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. |
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ó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. |
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.
Inicia uma conversação do DDE com um ou mais parceiros.
FUNCTION DDEInitiate(VAL whdl: WINDOW, VAL topic, appName: STRING): INTEGER;
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. |
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.
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ó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. |
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.
Envia dados não-solicitados para um parceiro do DDE.
FUNCTION DDEPoke(VAL whdl, whdlPartner: WINDOW, VAL topic, data: STRING): INTEGER;
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. |
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ó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. |
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.
Solicita dados a partir de um parceiro do DDE.
FUNCTION DDERequest(VAL whdl, whdlPartner: WINDOW, VAL topic: STRING): INTEGER;
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. |
O aplicativo do parceiro pode responder ao envio de dados solicitados ou ao envio de uma confirmação negativa ($MsgDDEAcknowledge).
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ó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. |
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.
Envia uma resposta para uma mensagem $MsgDDEInitiate.
FUNCTION DDERespond(VAL whdl, whdlPartner: WINDOW, VAL topic, VAL appName: STRING): INTEGER;
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. |
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.
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ódigo de Retorno | Descrição |
1 | Conclusão bem-sucedida. |
-2 | Valor desconhecido. |
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.
Termina uma conversação do DDE.
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.
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. |
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); ...
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ó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. |
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.
Cancela um pedido DDEAdvise.
FUNCTION DDEUnAdvise(VAL whdl, whdlPartner: WINDOW, VAL topic: STRING): INTEGER;
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. |
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.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ó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. |
Tivoli Service Desk 6.0 Developer's Toolkit - Referência de Linguagem do Script