Tivoli Service Desk 6.0 Developer's Toolkit - Referência de Linguagem do Script
Retornar a Página Principal
Sai o aplicativo do TSD Script imediatamente.
PROCEDURE Abort;
ACTIONS IF NOT FExists('F:\DATA\MYFILE.DAT') THEN WinMessageBox($Desktop,'Error',$MBOK,'I can't live without this file'); Abort; END;
Suspende a função atual e ativa o Depurador do TSD Script.
PROCEDURE BreakPoint;
Atenção: Se o Interpretador do TSD Script não conseguir encontrar o arquivo da biblioteca do Depurador, esta instrução não terá efeito.
O procedimento BreakPoint é fornecido primeiramente para ajudar os programadores do TSD Script em aplicativos de depuração. Utilizando o Depurador do TSD Script, o programador pode inspecionar o estado atual do aplicativo e monitorar seu progresso de uma instrução de uma vez.
Tivoli Service Desk 6.0 - Guia de Programação do Script do Conjunto de Ferramentas do Desevolvedor
Chama uma função ou procedimento cujo nome e função de base de informações ou nome do procedimento são incorporados em uma expressão de cadeia.
FUNCTION CallFunction (VAL func: STRING [, arg: ANY ...] ): INTEGER;
Nenhum tipo de verificação ocorre nos argumentos adicionais para CallFunction. Um argumento com um tipo inadequado pode causar um procedimento inesperado, incluindo a finalização prematura do aplicativo.
CallFunction retorna somente um sucesso ou código de falha. Qualquer valor retornado pela rotina chamada é descartado.
Ao especificar os argumentos a serem transmitidos para a função de destino, cujos argumentos devem ser variáveis, sem valores. Do contrário, o Analisador do TSD Script exibe uma mensagem de erro. Por exemplo, o item a seguir não é válido:
CallFunction ('mykb:myfunc', 1, 'foo');
Em vez do usuário declarar as variáveis temporárias para armazenar os valores que devem ser transmitidos para a função:
i:=1; s:='foo'; CallFunction ('mykb:myfunc', i,s);
A base de informações que contém a função chamada deve ser carregada para CallFunction funcionar. Tipicamente, a base de informações é carregada durante a inicialização de programa normal porque é mencionada na seção USES de uma ou mais das bases de informaçoes. Também pode ser carregada transmitindo-a na linha de comandos para o Interpretador do TSD Script com o argumento /F. Por exemplo:
KML /F=EA.KBC /F=CUSTOM.KBC
Neste exemplo, duas bases de informações foram transmitidas para o Interpretador do TSD Script em um comando. Esta técnica da linha de comandos pode ser utilizada para personalizar um aplicativo sem alterar o código de origem original.
Nome do Argumento | Descrição |
func | Uma expressão de cadeia que contém um nome de base de informações e um procedimento ou ou nome de função separado por dois pontos no format:kbase.func |
arg | Zero ou mais argumentos de qualquer tipo. Consulte a seção Atenção para obter maiores informações sobre este argumento. |
Esta função é útil para criação de recursos especiais como barras de ícones personalizáveis. Por exemplo, você pode criar uma tabela de ícones e ações do banco de dados. Quando o usuário dá um clique sobre um ícone,a ação associada a ele é executada. Como a ação deve ser armazenada na tabela como uma cadeia, você utiliza um método para chamar uma rotina do TSD Script. CallFunction fornece esta funcionalidade.
CallFunction obtém um número arbitrário de argumentos que é transmitido para a rotina de chamada.
CallFunction('SERVICES:DISPLAYINFO');
Código de Retorno | Descrição |
1 | Conclusão bem-sucedida. |
-1 | O primeiro argumento é desconhecido. A chamada foi abortada sem ativar a rotina porque um ou mais parâmetros formais não puderam ser ligados ao argumento correspondente. Geralmente, isso resulta de um erro de índice fora de limites em um dos parâmetros. |
-2 | O sistema de tempo de execução não conseguiu encontrar a rotina especificada. |
-3 | Memória insuficiente. |
Define o limiar de gravidade para o relatório de erro do sistema.
FUNCTION ErrorFilter [ (VAL level: INTEGER) ] : INTEGER;
Nome do Argumento | Descrição |
level | Se fornecido, este argumento torna-se o novo limiar de relatório de erro de amplo sistema. |
Atenção: Mensagens de erro fatal não podem ser suprimidas.
Em geral, o TSD Script exibe caixas de erro sempre que ocorre um erro. Cada erro é atribuído a um nível de erro predefinido:
Código de Retorno | Descrição |
0 | Erro fatal |
1 | Erro |
2 | Aviso |
3 | Mensagem |
O valor padrão de ErrorLevel exibe todos os níveis de erro.
ErrorFilter permite que você defina um nível de erro de limiar, para que erros (diferentes daqueles fatais) com níveis maiores do que este limiar não sejam exibidos.
VARIABLES oldLevel, err: INTEGER; employee: EmployeeRecord;
ACTIONS oldLevel := ErrorFilter(2); -- Suppress all warnings. err := SQLSelectInto('SELECT * FROM EMPLOYEES WHERE SALARY > ' & limit, employee); ErrorFilter(oldLevel); IF err > 0 THEN ...
Código de Retorno | Descrição |
ErrorFilter | Retorna o nível de gravidade anterior |
Define o valor de uma variável como $Unknown.
FUNCTION SetUnknown (REF var: ANY): INTEGER;
Nome do Argumento | Descrição |
var | Uma variável cujo valor deve ser definido como $Unknown. |
SetUnknown descarta valores associados à variável indicada. As variáveis com os tipos diferentes de RECORD, como membros de RECORDs, são definidas como $Unknown. Listas e matrizes são definidas como zero.
VARIABLES r: EmployeeRecord;
ACTIONS REPEAT IF NOT DataEntryForm(r) THEN ExitLoop; END; StoreRecord(r); SetUnknown(r); UNTIL FALSE;
Código de Retorno | Descrição |
1 | Nenhum erro |
-1 | Nenhuma variável |
Sin
Tivoli Service Desk 6.0 Developer's Toolkit - Referência de Linguagem do Script