Parâmetros de linha de comando do Kernel

O Kernel possui um conjunto de parâmetros que podem ser informados para a aplicação na sua ativação. Estes parâmetros são denominados “Parâmetros de linha de comando”. Estes parâmetros podem ser passados para o Kernel de duas formas básicas como descrito a seguir:

Ativação do Kernel via prompt de comando

Para passar parâmetros para o Kernel via prompt de comandos abra uma caixa de comando, digitando a palavra cmd.exe na caixa de diálogo apresentada no menu principal do windows .

Uma vez ativado o prompt de comando, utilizando o comando CD vá para o diretório onde está localizado o aplicativo a ser executado. Uma vez no diretório do aplicativo ative o mesmo especificando o seu nome seguido dos parâmetros de linha de comando desejados conforme apresentado no exemplo a seguir:

app.exe parm1 parm2 ...

Dependendo do tipo de comando a ser executado será necessário que o prompt de comandos seja aberto com privilégio de administrador. Veja a seção Registro do aplicativo no sistema operacional para mais informações.

Ativação do Kernel via link

Para passar parâmetros para o Kernel via link, crie um link do aplicativo no desktop utilizando o comando de “copiar” e “colar como link”. Uma vez criado o link para o aplicativo, clique com o botão direito do mouse no menu apresentado e selecione a opção “Propriedades”. Na aba Atalho, identifique o campo “Destino”, acrescentando no final do mesmo os parâmetros desejados conforme ilustrado na figura a seguir.

Fig. Definindo parâmetros de linha de comando em um link

Feche o diálogo através do botão OK e em seguida ative a aplicação pelo link criado.

As próximas sessões apresentam os parâmetros que podem ser utilizados com o Kernel com sua respectiva funcionalidade. Múltiplos parâmetros podem ser especificados na linha de comando quando necessário.

Registro do Kernel no sistema operacional [ -r ]

Este parâmetro especifica para a aplicação criar uma entrada no registro do windows informando sua localização no computador. Esta chave é criada em “HKEY_LOCAL_MACHINESoftwareCompanyApplicationV.M" onde:

Path parcial	Descrição |
HKEY_LOCAL_MACHINESoftware	Entrada de registro padrão do Windows |
Company	Especifica o nome do desenvolvedor da aplicação |
Application	Especifica o nome do pacote de software |
V.M	Especifica a versão “V” e revisão maior “M” do pacote de software

Nesta chave é salvo o path completo do arquivo executável principal do pacote.

Para executar este comando, abra um prompt de comando do windows. No caso do Windows Server 2003, 2008 e Windows 7, o prompt de comando deve ser aberto com privilégio de administrador conforme indicado na figura a seguir.

Fig. Ativação do prompt como adminstrador

Uma vez aberta a tela de comandos, vá para o diretório onde está instalado o arquivo Kernel.exe e digite:

Kernel -r

Após a execução deste comando o Kernel é fechado. O resultado do processo de registro é salvo no arquivo de log de Kernel.log. Para verificar o resultado, após executar o comando abra o arquivo Kernel.log e vá para o final do arquivo onde deverá estar registrado o resultado do tratamento do comando.

Remoção do registro do Kernel no sistema operacional [ -u ]

Este parâmetro especifica para a aplicação remover a entrada no registro do windows que identifica a localização da aplicação no computador. Esta chave é criada em “HKEY_LOCAL_MACHINESoftwareCompanyApplicationV.M" através do parâmetro -r.

Para executar este comando, abra um prompt de comando do windows. No caso do Windows Server 2003, 2008 e Windows 7, o prompt de comando deve ser aberto com privilégio de administrador conforme indicado na figura a seguir.

Fig. Ativação do prompt como administrador

Uma vez aberta a tela de comandos, vá para o diretório onde está instalado o arquivo Kernel.exe e digite:

Kernel -u

Após a execução deste comando o Kernel é fechado. O resultado do processo de registro é salvo no arquivo de log de Kernel.log. Para verificar o resultado, após executar o comando abra o arquivo Kernel.log e vá para o final do arquivo onde deverá estar registrado o resultado do tratamento do comando.

Ativação do Kernel em modo de depuração [ -d ]

Este parâmetro especifica para a kernel ativar a aplicação no modo depuração. Neste modo é possível abrir a interface do kernel habilitando o editor Lua para rodar scripts e acessar a base de dados da aplicação para teste. Quando o kernel é ativado através do IDE, este parâmetro é utilzado para permitir depuração da aplicação. Para executar este comando, abra um prompt de comando do windows, vá para o diretório onde está instalado o arquivo Viewer.exe e digite:

Kernel -d

Carrega projeto especificado sem alterar o projeto default [ -o ]

Este comando especifica o nome do projeto a ser carregado pelo Kernel para operação. A carga do projeto entretanto, não altera o projeto default a ser carregado quando o Kernel for ativado sem parâmetros de linha de comando. O IDE utiliza este parâmetro sempre que ativa remotamente o Kernel para teste de uma aplicação. O projeto default pode ser alterado através do IDE.

Exemplos de utilização:

Kernel -o MEU_PROJETO

O projeto especificado deve estar localizado no diretório definido como diretório de projetos na base de configuração do Kernel. Este diretório pode ser configurado no IDE.

Carrega projeto especificado salvando-o como projeto default [ -p ]

Este comando especifica o nome do projeto a ser carregado pelo Kernel para operação. Quando o comando for processado este define o projeto especificado como o projeto corrente e salva o mesmo no arquivo de configuração (.SXF) para que seja utilizado quando o Kernel for acionado novamente sem parâmetros de linha de comando.

Exemplos de utilização:

Kernel -p MEU_PROJETO  # MEU_PROJETO passa a ser o projeto default do Kernel

O projeto especificado deve estar localizado no diretório definido como diretório de projetos na base de configuração do Kernel. Este diretório pode ser configurado no IDE.