RpcSetEnv - Abertura do ambiente em rotinas automáticas

Função: RpcSetEnv - Abertura do ambiente em rotinas automáticas

Descrição:

A função RpcSetEnv() é utilizada para abertura de ambiente em rotinas automáticas, permitindo definir a empresa e filial no qual desejamos fazer a inicialização do ambiente, especificando o usuário e senha para determinar os direitos e ações a serem realizadas. É possível também especificar quais as tabelas que serão abertas para uso no ambiente e qual módulo será utilizado.

Sintaxe:

RpcSetEnv - Abertura do ambiente em rotinas automáticas ( [ cRpcEmp ] [ cRpcFil ] [ cEnvUser ] [ cEnvPass ] [ cEnvMod ] [ cFunName ] [ aTables ] [ lShowFinal ] [ lAbend ] [ lOpenSX ] [ lConnect ] ) --> lRet

Retorno:

lRet

Retorna .T. se setou corretamente o ambiente com a empresa e filial. Se .F. não conseguiu setar.

Exemplos

Local aTables := {"CT1","CT2","CT3","CT4","CT5","CTF","CTE"}
//seta o ambiente com a empresa 99 filial 01 com os direitos do usuário administrador, módulo CTB
RpcSetEnv( "99","01", "Administrador", " ", "CTB", "CTBA102", aTables, , , ,  )
/****** COMANDOS *************/
RpcClearEnv() //Limpa o ambiente, liberando a licença e fechando as conexões

Parâmetros:

Nome	Tipo	Descrição	Default	Obrigatório
cRpcEmp	Caracter	Código da empresa.
cRpcFil	Caracter	Código da filial.
cEnvUser	Caracter	Nome do usuário.
cEnvPass	Caracter	Senha do usuário.
cEnvMod	Caracter	Código do módulo.	'FAT'
cFunName	Caracter	Nome da rotina que será setada para retorno da função FunName(). É também utilizado na gravação da rotina que executou as inclusões/alterações na tabela de auditoria	'RPC'
aTables	Vetor	Array contendo as tabelas a serem abertas.	{}
lShowFinal	Lógico	Alimenta a variável publica lMsFinalAuto.	.F.
lAbend	Lógico	Se .T., gera mensagem de erro ao ocorrer erro ao checar a licença para a estação.	.T.
lOpenSX	Lógico	SE .T. pega a primeira filial do arquivo SM0 quando não passar a filial e realiza a abertura dos SXs.	.T.
lConnect	Lógico	Se .T., faz a abertura da conexão com servidor As400, SQL Server etc.	.T.

Observação:

O ambiente não deve ser inicializado ou encerrado em rotinas de menu do Protheus, o Protheus já entrega o ambiente aberto e preparado para a correta execução da rotina, caso o ambiente seja aberto ou fechado em rotinas de menu erros diversos podem ocorrer.

Atalhos

Páginas filhas