Definição de variáveis e arquivos de propriedades

Ao definir as variáveis e seus arquivos de propriedades associados, use essas regras para assegurar que a substituição de variável possa ocorrer com êxito.

Definindo variáveis em um arquivo de propriedades

As regras a seguir se aplicam à definição de variáveis em um arquivo de propriedades:
  • Os caracteres válidos em um nome de variável são letras maiúsculas e minúsculas, números de 0 a 9, pontos, sublinhados e hifens. Os nomes de variáveis são limitados a 255 caracteres.
  • Arquivos de propriedade podem existir em um pacote configurável do CICS ou em uma ligação de aplicativos. Eles devem estar na raiz do projeto e devem ser denominados variables.properties.
  • É possível fornecer um arquivo de propriedades separado para resolver pacotes configuráveis independentes, mas essa opção não é suportada para aplicativos. Não há nenhuma restrição no nome de um arquivo de propriedades quando usado com um pacote configurável independente.
  • Arquivos de propriedades seguem o formato padrão para arquivos de propriedades Java™ e devem ser codificados em ISO-8859-1. Para obter informações adicionais, consulte Os arquivos de propriedades Java na especificação de API do Java Platform, Standard Edition 7.
  • Qualquer variável usada em um pacote configurável deve ser definida no arquivo de propriedades desse pacote configurável. Quando substituído na definição de recurso, o valor fornecido no pacote configurável deve resultar em um valor válido para esse atributo.
  • Os valores das variáveis não devem se referir a outras variáveis. Por exemplo, hlq=${prod.hlq} não é válido.
  • Se uma variável for definida mais de uma vez em um arquivo de propriedades, a última instância será usada.

Referenciando variáveis em partes do pacote configurável

As regras a seguir se aplicam à referência de variáveis em partes do pacote configurável:
  • Os nomes de variáveis são delimitados por caracteres ${ e }.
  • As variáveis são permitidas em qualquer parte do pacote configurável do CICS, incluindo nos atributos ou elementos de uma parte do pacote configurável.
  • Não há limite para o número de variáveis que podem ser colocadas em um atributo ou tag.
  • As variáveis não podem ser aninhadas e elas não devem ser usadas como parte de um nome de definição de recurso do CICS.