Objetivo

A Ferramenta por linha de comando embutida no

Inclusão de trecho

	Application Server
	Application Server
nopanel	true

permite diversas operações relacionadas a manipulação do RPO e execução de rotinas em batch. A ferramenta pode ser utilizada em processos de automação com a plataforma TOTVSTEC.

Principais características

Não tem comunicação cliente/server TCP, os comandos são executados diretamente no AppServer.
Ambiente simples que necessita apenas do appre, binário do appserver e arquivo de configuração "appserver.ini".
Compilação mais rápida.
Suporte a atual chave de compilação utilizada pelo TDS e TDSCli.
Chave de compilação para Linux utilizando criptografia AES 256bits.
Compatível com Sistemas Operacionais Windows e Linux.

Funcionalidades

Compilação de fontes e resources
Geração e aplicação de patches
Inspetor de Objetos
Execução de rotinas, sem interface

Geral

Parâmetros

Parâmetros de linha do

Inclusão de trecho

	Application Server
	Application Server
nopanel	true

Parâmetro de Linha

Sistema Operacional

Descrição

Observações

-console

ou

-debug

Windows

Executa o

Inclusão de trecho

	Application Server
	Application Server
nopanel	true

em modo console.

-daemon

ou

daemon

Linux

Executa o

Inclusão de trecho

	Application Server
	Application Server
nopanel	true

como um daemon no Linux.

Ambas as formas, com ou sem o hífen, são aceitas para este parâmetro, obtendo o mesmo resultado final.

-version

Linux / Windows

Exibe a versão do Application Server.

Disponível a partir da versão 17.0.0.1.

-fullversion

Linux / Windows

Exibe informações mais completas sobre a versão do Application Server. tais como: Build Version, Profile (Debug, Release ou Release com Debug), Arquitetura, Plataforma, data de geração e demais informações.

Disponível a partir da versão 20.3.2.8.

-ini=<config_file.ini>

ou

-ini <config_file.ini>

Linux / Windows

Define um arquivo de configuração alternativo ao padrão do

Inclusão de trecho

	Application Server
	Application Server
nopanel	true

.

Pode ser usado em conjunto com um dos parâmetros -daemon, ou daemon, ou -console, ou -debug, ou -install, conforme o sistema operacional.
Deve ser usado ou com '=' sem espaços entre o parâmetro e o nome do arquivo, ou com apenas um espaço entre o parâmetro e o nome do arquivo.
O arquivo de configuração alternativo <config_file.ini> deverá ter as mesmas características do arquivo padrão:
1. estar no mesmo diretório do arquivo de configuração padrão;
2. nome contendo apenas letras minúsculas, sem espaços, caracteres especiais, caminho do arquivo, etc.
3. exemplos:
  1. -ini=newconfig.ini
  2. -ini alternative_file.ini
Disponível a partir da versão 131227A NG 2.2.0.

-install

Windows

Instalar o

Inclusão de trecho

	Application Server
	Application Server
nopanel	true

como um serviço do Windows.

-remove

Windows

Remover o serviço do Windows do

Inclusão de trecho

	Application Server
	Application Server
nopanel	true

.

-compile

Windows / Linux

Operações relacionadas ao acesso e alteração do repositório (RPO)

Opção de linha do comando para operações de alteração e manutenção do RPO. Detalhes do comando disponível em: AppServer Command Line - Compilação por linha de comando

-run

Windows / Linux

Operações relacionadas a execução de rotinas diretamente no Application Server.

Opção de linha do comando para operações de execução de rotinas RPO. Detalhes do comando disponível em: AppServer Command Line - Execução por linha de comando

-help

Windows / Linux

Exibe no console uma ajuda com as opções disponíveis no

Inclusão de trecho

	Application Server
	Application Server
nopanel	true

Command Line

Opção Compile

Estado
colour Green
title Disponível a partir da versão 17.3.0.9

Compilação

Parâmetros:

Nome

Descrição

Obrigatório

Observações

-compile

Necessário para inicialização da ferramenta

Sim

-files

Informa quais fontes serão compilados podendo ser informado das seguintes formas:

Arquivo

Lst
Pastas (Diretórios e sub-diretórios).

Obs:

O que não é programa será compilado como resource. Arquivo único (fonte ou resource).	Sim
-includes	Informa o diretório de includes usado durante a o pré-processamento dos fontes.	Sim

-src


-env	Informa o ambiente que deverá ser acessado para compilação.	Sim
-nodelfiles	Utilizado para debug, caso informado, não deleta os arquivos gerados durante o pré-processamento e também mantem os arquivos temporários

.Lst

gerados durante o processo.

Não

-authorization

Informa a chave de compilação no formato de arquivo

.aut, padrão TDS / TDSCli ou, o token de compilação no formato de arquivo

.token, no padrão JWT.

Não

A PARTIR DA VERSÃO

Estado

colour	Blue
title	A partir da versão 20.3.2.0,

NÃO SERÁ MAIS UTILIZADA A AUTORIZAÇÃO DA CHAVE DE COMPILAÇÃO

não será mais utilizada a autorização da chave de compilação.

-outreport

Gera os arquivos

compile_sucess.log, que contem a lista de fontes compilados com sucesso no

formato do arquivo .lst, e

compile_errors.log, que contem a lista de fontes não compilados e os erros de compilação.

A partir da versão 17.3.0.19, também é possível definir o diretório de saída

para esses arquivos.Não

DISPONÍVEL A PARTIR DA VERSÃO 17.3.0.15

Arquivo .Lst

Tipo de arquivo com extensão .lst que pode conter uma lista de fontes e resources no formato de path absoluto, ou diretórios para compilação. Quando houverem diretórios, um novo arquivo .lst temporário com prefixo _generated será gerado

para

a extração dos arquivos contidos no diretório informado, compondo assim uma nova lista de arquivos a serem compilados. Por meio do parâmetro nodelfiles, é possível manter também

esses

arquivos temporários para análise.

O conteúdo do arquivo deverá respeitar as seguintes regras:

Usar separador ' ; '

Todos caminhos de

arquivos

ou diretórios devem ser inseridos em uma única linha com separador no final.

Veja o exemplo de arquivo anexado: exemplo.lst

Exemplos:

appserver.exe -compile -files=D:\totvs\lobo-guara\cmdline\teste.prw -includes=C:\totvs\lobo-guara\Include -src=D:\totvs\lobo-guara\cmdline -env=environment

appserver.exe -compile -files=D:\totvs\lobo-guara\cmdline -includes=C:\totvs\lobo-guara\Include -src=D:\totvs\lobo-guara\cmdline-env=environment

appserver.exe -compile -files=D:\totvs\lobo-guara\cmdline\lista.lst -includes=C:\totvs\lobo-guara\Include -src=D:\totvs\lobo-guara\cmdline -env=environment

Chave de compilação

Observação:

A partir da versão 20.3.2.0, os recursos de geração e de autenticação por meio de uma chave de compilação foram descontinuados. Será utilizado somente o token de compilação.

Compatível com a chave de compilação gerada e utilizada no TDS e TDSCli. Para a utilização da ferramenta Compile, é preciso exportar as informações de uma nova ou já existente chave criando um arquivo com extensão .aut. No Linux, é utilizado o mesmo padrão de criação de chave realizando o controle pelo UUID do disco porem, a chave é criada e criptografada utilizando algoritmo AES 256bits.

Exemplos:

Windows

[AUTHORIZATION]
ID=FA15-EB7C
GENERATION=12/02/2019
VALIDATION=13/05/2019
PERMISSION=1
KEY=042MQC032QYIQ74A1E7671302

Baixar exemplo.

Linux

[AUTHORIZATION]
ID=d40f3aa2-d5ae-4a0b-a0f5-a44e29bcd344
GENERATION=20/02/2019
VALIDATION=21/05/2019
PERMISSION=1
KEY=gjvqs3U7vInn/VcX9Hl0Av2is+mLrr4j/BxHMdyR7uPaOcQC7OVtTIWhIMU0/5AkfipUxQukozs121WVNafNyQ==

Baixar exemplo.

Para criação de uma nova chave no Linux, será necessário a coleta do UUID onde a ferramenta está instalada e posteriormente entrar em contato com a Tecnologia - AppServer.

Comando para obtenção do UUID no linux:

./appsrvlinux -compile -uuid

Patch

Geração de Patch

Recurso para geração de path. Por default, os patchs serão gerados na pasta "cmdgenpatch" dentro do Environment.

Parâmetros

Nome

Descrição

Obrigatório

-compileNecessário para inicialização da ferramentaSim-genpatchIndica geração de PatchSim-files

Informa os programas que irão compor o patch da seguinte forma:

Arquivo .lst contendo os programas que deverão compor o Patch. Neste arquivo, apenas os nomes dos programas respeitando:
- Usar separador ' ; '
- Todos nomes de programas devem ser inseridos em uma unica linha com separador no final.
Um único nome de programa ou mais, separados por ";"

Sim-envInforma o ambiente que deverá ser acessado para compilação.Sim-patchtypeExtensão de patch: ptm, upd ou pak. Por default, é gerado com extensão ptm.Não-outgenpatchPermite a definição de um diretório de output

.

Não

DISPONÍVEL A PARTIR DA VERSÃO 17.3.0.19

Exemplos:

appserver.exe -compile -genpatch -files=D:\totvs\lobo-guara\sources\mainfunc.prw -env=environment -patchtype=ptm

appserver.exe -compile -genpatch -files=D:\totvs\lobo-guara\sources\mainfunc.prw;teste.prw -env=environment -patchtype=ptm

appserver.exe -compile -genpatch -files=D:\totvs\lobo-guara\patch.lst -env=environment -patchtype=ptm

appserver.exe -compile -genpatch -files=D:\totvs\lobo-guara\patch.lst -env=environment -patchtype=ptm -outgenpatch=d:\patchs\teste1

Validação de Patch-cbfilesInterno. Não é possível utilizar sem o token interno da TOTVS.Não

DISPONÍVEL A PARTIR DA VERSÃO 20.3.1.3

Exemplo:

appserver.exe -compile -applypatch -files=D:\totvs\patch\tttp120.ptm -env=advplc -applyoldprogram

Desfragmentação RPO

DISPONÍVEL A PARTIR DA VERSÃO

Estado
colour Green
title

DISPONÍVEL A PARTIR DA VERSÃO 17.3.0.20

Este recurso permite ao desenvolvedor adicionar uma etapa de verificação do Patch antes de aplicá-lo. O resultado dessa verificação pode ser armazenado em um arquivo Log e analisado posteriormente.

Parâmetros

Nome

Descrição

Obrigatório

-compileNecessário para inicialização da ferramentaSim-validatePatchIndica Validação de PatchSim-files

Informa o patch a ser aplicado com extensão ("PTM", "UPD" E "PAK").

Sim-envInforma o ambiente que deverá ser acessado para compilação.Sim-outreportGera o arquivo patch_errors.log contendo o resultado da verificação de patch. Também é possível definir o diretório de saída para esse arquivo.Não

Exemplo:

appserver.exe -compile -validatepatch -files=D:\totvs\patch\tttp120.ptm -env=advplc -outreport

Aplicação de Patch

Recurso para aplicação de Patch.

Parâmetros

Nome

Descrição

Obrigatório

-compileNecessário para inicialização da ferramentaSim-applypatchIndica aplicação de PatchSim-files

Informa o patch a ser aplicado com extensão ("PTM", "UPD" E "PAK").

Sim-envInforma o ambiente que deverá ser acessado para compilação.Sim-applyoldprogramInforma que serão aceitos fontes mais antigos que o RPO. Por default, aceita somente os fontes mais novos.Não

Disponível a partir da versão 17.3.0.15

Recurso DefragRPO para desfragmentação de RPO.

Parâmetros

Nome

Descrição

Obrigatório

-compileInicialização da ferramenta.Sim-defragrpoIndica desfragmentação de RPO.Sim-envInforma o ambiente que deverá ser desfragmentado.Sim

Exemplo:

appserver.exe -console -compile -defragrpo -env=advplc

Inspetor de Objetos

Run

Índice

printable	false

HTML
<style>.toc-macro {position: fixed; float: right}</style>

Árvore de páginas

Versões comparadas

Versão antiga 2

Nova versão 3

Chave

Objetivo

Principais características

Funcionalidades

Geral

Parâmetros

Opção Compile

Estado
colour Green
title Disponível a partir da versão 17.3.0.9

Compilação

Parâmetros:

Arquivo .Lst

Chave de compilação

Patch

Geração de Patch

Parâmetros

Desfragmentação RPO

Estado
colour Green
title

Parâmetros

Aplicação de Patch

Parâmetros

Disponível a partir da versão 17.3.0.15

Parâmetros

Inspetor de Objetos

Árvore de páginas

Histórico da Página

Versões comparadas

Versão antiga 2

Nova versão 3

Chave

Objetivo

Principais características

Funcionalidades

Geral

Parâmetros

Opção Compile

EstadocolourGreentitleDisponível a partir da versão 17.3.0.9

Compilação

Parâmetros:

Arquivo .Lst

Chave de compilação

Patch

Geração de Patch

Parâmetros

Desfragmentação RPO

EstadocolourGreentitle

Parâmetros

Aplicação de Patch

Parâmetros

Disponível a partir da versão 17.3.0.15

Parâmetros

Inspetor de Objetos

Estado
colour Green
title Disponível a partir da versão 17.3.0.9

Estado
colour Green
title