Variáveis de ambiente do Mainframe Connector

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

Nome Valor padrão Disponível na versão Descrição
True 5.8.0 Remove os espaços em branco no final das strings. As strings que consistem apenas de espaços em branco são tratadas como strings vazias.
False 5.10.0 Configura bq query para execução no modo remoto.
False 5.11.0 Ativa o suporte a strings de caracteres de comprimento variável quando definido como "True".
-LEN 5.11.0 Relevante se BQSH_FEATURE_VARIABLE_LENGTH_ENABLED estiver definido. Representa o sufixo do primeiro parâmetro na estrutura de caracteres de comprimento variável. Por padrão, o sufixo é -LEN. Se você quiser usar um sufixo diferente, defina essa variável de ambiente como o sufixo de 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 caracteres de comprimento variável. Por padrão, o sufixo é -TEXT. Se você quiser usar um sufixo diferente, defina essa variável de ambiente como o sufixo de sua escolha.
- 5.11.0/5.13.0 (5.13.0 e versões mais recentes) Define os valores para os tipos de dados de data, carimbo de data/hora e indicador nulos.

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 o carimbo de data/hora: SUFFIX_SUFFIX_NAME="command --format FORMAT --timezone TIMEZONE"

Para mais informações, consulte Suporte para campos de data e carimbo de data/hora e Suporte para campos de indicador nulo.

(5.11.0 e versões mais recentes) Define os valores dos tipos de dados de data e carimbo de data/hora. É possível definir essa variável de ambiente como qualquer valor no seguinte formato: SUFFIX_SUFFIX_STRING="--bqtype TYPE --format FORMAT --timezone TIMEZONE"
Verdadeiro 5.12.0 Substitui hifens nos nomes de campos no COPYBOOK por sublinhados nos nomes de campos correspondentes no BigQuery.
Verdadeiro 5.12.0 Exporta strings com comprimento 0 como nulos para o BigQuery. Se você definir BQSH_FEATURE_EMPTY_STRING_AS_NULL como falso, uma string vazia permanecerá como uma string vazia quando for exportada para o BigQuery. Uma string vazia não será definida como nula.
Falso 5.12.1/5.13.0 (5.13.0 e versões mais recentes) Permite aplicar um tratamento de erros mais rigoroso, conforme mostrado abaixo:
  • Gerar um erro ao analisar tipos de data e carimbo de data/hora que contêm espaços (ou são datas ou carimbos de data/hora inválidos).
  • Gerar um erro ao decodificar um byte inválido em um tipo decimal compactado ou um tipo decimal com zona. Isso inclui valores que contêm apenas nulos, espaços ou bytes altos.

(5.12.1 e versões mais recentes) permite aplicar um tratamento de erros mais rigoroso, conforme mostrado a seguir:
  • Gerar um erro ao analisar tipos de data e carimbo de data/hora que contêm espaços (ou são datas ou carimbos de data/hora inválidos).
  • Gerar um erro ao decodificar um byte inválido em um tipo decimal compactado. Se um valor tiver apenas valores nulos (0x00) ou espaços (0x40), ele será decodificado como nulo e não gerará um erro para decimal empacotado, mesmo que essa flag esteja definida como "true".
Verdadeiro 5.13.0 Especifica que valores que contêm apenas nulos (0x00), espaços (0x40) ou high bytes (0xFF) devem ser decodificados como nulos e não gerar um erro para tipos de decimal empacotado e decimal com zona. Essa flag só tem efeito se BQSH_FEATURE_FAIL_ON_INVALID_DATA estiver definida como verdadeira. Caso contrário, não afeta o comportamento dos decodificadores ou codificadores.
Falso 5.13.0 Aumenta ou diminui o tamanho da janela do controle de fluxo HTTP/2.
Verdadeiro 5.14.0 Se não for definido ou se for verdadeiro, os campos DISPLAY, NATIONAL, DBCS e UTF8 vão interpretar bytes nulos como um indicador de fim de string e ignorar os bytes restantes. Se definido como "false", os bytes nulos são decodificados de acordo com o conjunto de caracteres usado.
String em branco 5.14.0 Defina o caminho para um conjunto de caracteres personalizado. Se você quiser usar vários conjuntos de caracteres, forneça os caminhos para vários conjuntos de caracteres separados pelo delimitador ponto e vírgula. Por exemplo, export BQSH_FEATURE_CUSTOM_CHARSET=path1;path2.