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

Tivoli Service Desk Developer's Toolkit - Internos

Retornar a Página Principal


Abort

Descrição

Sai o aplicativo do TSD Script imediatamente.

Sintaxe

PROCEDURE Abort;

Exemplo

ACTIONS
IF NOT FExists('F:\DATA\MYFILE.DAT') THEN
 WinMessageBox($Desktop,'Error',$MBOK,'I can't live without
               this file');
 Abort;
              END;

BreakPoint

Descrição

Suspende a função atual e ativa o Depurador do TSD Script.

Sintaxe

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.

Notas

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.

Consulte também

Tivoli Service Desk 6.0 - Guia de Programação do Script do Conjunto de Ferramentas do Desevolvedor


CallFunction

Descrição

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.

Sintaxe

FUNCTION CallFunction (VAL func: STRING [, arg: ANY ...] ): INTEGER;

Atenção

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.

Notas do Argumento

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.

Notas

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.

Exemplo

CallFunction('SERVICES:DISPLAYINFO');

Códigos de Retorno

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.

ErrorFilter

Descrição

Define o limiar de gravidade para o relatório de erro do sistema.

Sintaxe

FUNCTION ErrorFilter [ (VAL level: INTEGER) ] : INTEGER;

Notas do Argumento

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.

Notas

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.

Exemplo

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ódigos de Retorno

Código de Retorno Descrição
ErrorFilter Retorna o nível de gravidade anterior

SetUnknown

Descrição

Define o valor de uma variável como $Unknown.

Sintaxe

FUNCTION SetUnknown (REF var: ANY): INTEGER;

Notas do Argumento

Nome do Argumento Descrição
var Uma variável cujo valor deve ser definido como $Unknown.

Notas

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.

Exemplo

VARIABLES
  r: EmployeeRecord;
ACTIONS
 REPEAT
 IF NOT DataEntryForm(r) THEN
         ExitLoop;
              END;
 StoreRecord(r);
 SetUnknown(r);
 UNTIL FALSE;

Códigos de Retorno

Código de Retorno Descrição
1 Nenhum erro
-1 Nenhuma variável

Consulte também

Sin


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

Retornar à Página Principal

Copyright