Variáveis de ambiente do Mainframe Connector

Esta página lista todas as variáveis de ambiente suportadas pelo Mainframe Connector. Consoante a versão do Mainframe Connector, algumas variáveis podem não ser suportadas. Para mais detalhes, consulte a coluna Disponível a partir da versão na tabela seguinte.

Nome Valor predefinido Disponível a partir da versão Descrição
True 5.8.0 Remove os espaços em branco no final das strings. Tenha em atenção que as strings que consistem apenas em espaços em branco são tratadas como strings vazias.
cp037 5.8.0 Especifica a codificação de carateres usada para codificar e descodificar.
False 5.10.0 Configura o bq query para ser executado no modo remoto.
False 5.11.0 Ativa o suporte para strings de carateres de comprimento variável quando definido como Verdadeiro.
-LEN 5.11.0 Relevante se BQSH_FEATURE_VARIABLE_LENGTH_ENABLED estiver definido. Representa o sufixo do primeiro parâmetro na estrutura de carateres de comprimento variável. Por predefinição, o sufixo é -LEN. Se quiser usar um sufixo diferente, defina esta variável de ambiente para o sufixo da sua escolha.
-TEXT 5.11.0 Relevante se BQSH_FEATURE_VARIABLE_LENGTH_ENABLED estiver definido. Representa o sufixo do segundo parâmetro na estrutura de carateres de comprimento variável. Por predefinição, o sufixo é -TEXT. Se quiser usar um sufixo diferente, defina esta variável de ambiente para o sufixo da sua escolha.
- 5.11.0/5.13.0 (5.13.0 e posteriores) Define os valores para os tipos de dados de data, indicação de tempo e indicador nulo.

Use o seguinte formato para definir o indicador nulo: SUFFIX_NULL_INDICATOR_NAME="command --null-value NULL_VALUE --not-null-value NOT_NULL_VALUE"

Use o seguinte formato para definir a data e a data/hora: SUFFIX_SUFFIX_NAME="command --format FORMAT --timezone TIMEZONE"

Para mais informações, consulte os artigos Suporte para campos de data e data/hora e Suporte para campos de indicadores nulos.

(5.11.0 e posteriores) Define os valores para os tipos de dados de data e hora. Pode definir esta variável de ambiente para qualquer valor no seguinte formato: SUFFIX_SUFFIX_STRING="--bqtype TYPE --format FORMAT --timezone TIMEZONE"
True 5.12.0 Substitui os hífenes nos nomes dos campos no COPYBOOK por sublinhados nos nomes dos campos correspondentes no BigQuery.
True 5.12.0 Exporta strings com um comprimento de 0 como nulas para o BigQuery. Se definir BQSH_FEATURE_EMPTY_STRING_AS_NULL como falso, uma string vazia permanece como uma string vazia quando é exportada para o BigQuery (uma string vazia não é definida como nula).
Falso 5.12.1/5.13.0 (5.13.0 e posteriores) Permite aplicar um processamento de erros mais rigoroso, da seguinte forma:
  • Gera um erro ao analisar tipos de data e hora que contêm espaços (ou são datas ou horas inválidas).
  • Gere um erro ao descodificar um byte inválido num tipo decimal compactado ou num tipo decimal zonado. Isto inclui valores que contêm apenas nulos, espaços ou bytes elevados.

(5.12.1 e posteriores) Permite aplicar um processamento de erros mais rigoroso, da seguinte forma:
  • Gera um erro ao analisar tipos de data e hora que contêm espaços (ou são datas ou horas inválidas).
  • Gere um erro quando descodifica um byte inválido num tipo decimal compactado. Se um valor contiver apenas nulos (0x00) ou espaços (0x40), é descodificado para nulo e não gera um erro para o decimal compactado, mesmo que este sinalizador esteja definido como verdadeiro.
True 5.13.0 Especifica que os valores que contêm apenas nulos (0x00), espaços (0x40) ou bytes altos (0xFF) devem ser descodificados como nulos e não gerar um erro para os tipos decimal compactado e decimal zonado. Esta flag só tem efeito se BQSH_FEATURE_FAIL_ON_INVALID_DATA estiver definida como verdadeira. Caso contrário, não afeta o comportamento dos descodificadores nem dos codificadores.
Falso 5.13.0 Aumenta ou diminui o tamanho da janela do controlo de fluxo HTTP/2.
True 5.14.0 Se não estiver definido ou se for verdadeiro, os campos DISPLAY, NATIONAL, DBCS e UTF8 interpretam os bytes nulos como um indicador de fim de string e ignoram os bytes restantes. Se estiver definido como falso, os bytes nulos são descodificados de acordo com o conjunto de carateres usado.
String vazia 5.14.0 Definir o caminho para um conjunto de carateres personalizado. Se quiser usar vários conjuntos de carateres, pode indicar os caminhos para vários conjuntos de carateres separados pelo delimitador ponto e vírgula. Por exemplo, export BQSH_FEATURE_CUSTOM_CHARSET=path1;path2.
Falso 5.15.0 Desative o Google Analytics.
Falso 5.15.1 Preencha os campos FILLER numa operação de exportação do BigQuery. Se definir BQSH_FEATURE_RESPECT_FILLER_ON_EXPORT como verdadeiro, o Mainframe Connector atribui valores FILLER com base nos resultados da consulta do BigQuery. Por exemplo, SELECT f1, '|', f2 … from TABLE. Neste caso, o valor de FILLER vai ser definido como |.