Conteúdo de Arquivo de Entrada de Personalização

Este tópico descreve detalhadamente o conteúdo do Arquivo de Entrada de Personalização (mqsicompcif), que contém os dados de configuração necessários para a personalização do componente. Consulte Exemplo de Arquivo de Entrada de Personalização (mqsicompcif) e utilize-o para coletar informações de configuração.

Todas as variáveis de ambiente precisam se tornar explícitas em mqscompcif. Por exemplo, não utilize $JAVAHOME; grave o caminho completo do diretório home Java. Isso ocorre porque ENVFILE é analisado por BPXBATCH antes que o ambiente de shell para a tarefa iniciada tenha sido criado e o BPXBATCH não reconhece a utilização de $ para indicar variáveis de ambiente.

Nome e Chave do Componente

Cada componente deve ter um nome de componente e uma chave de componente.

Ao decidir sobre nomes e chaves de componentes, utilize o nome do gerenciador de filas anexado a BRK para um intermediário ou UNS para um como a chave do componente. Quando seguir essa convenção de nomenclatura, você pode ter, por exemplo:
Nome do Componente Broker Servidor de Nome de Usuário
Chave do Componente MQP1BRK MQP1UNS

Crie o procedimento de tarefa iniciado com o mesmo nome de seu intermediário para evitar confusão. Embora a tarefa iniciada e o intermediário possam ter nomes diferentes, será mais fácil gerenciar se o nome do componente do intermediário e a chave do componente tiverem o mesmo nome que o procedimento da tarefa iniciada. No entanto, você pode escolher seus próprios valores, desde que eles estejam de acordo com os requisitos abaixo. Além disso, é recomendável escolher nomes apenas em maiúsculas.

O nome do componente é utilizado no no Windows para identificar diferentes intermediários. O sempre tem o nome do componente UserNameServer que não pode ser alterado. O nome do intermediário deve seguir as seguintes restrições de nomenclatura:
  • O nome não deve exceder 64 caracteres.
  • Ele deve iniciar com um caractere alfanumérico.
  • Pode conter caracteres alfanuméricos. Os seguintes caracteres também são aceitos:

    = (igual)

    - (traço)

    _ (sublinhado)

    . (ponto)

Se você espera rastrear a operação de um grupo de execução, deverá restringir o nome do grupo de execução para incluir apenas os caracteres alfabéticos e numéricos válidos listados acima (apenas o alfabeto em inglês americano). Os comandos de rastreio não suportam a utilização de caracteres especiais para um nome de grupo de execução.

Os caracteres aceitáveis são representações na página de código 1047. Como os nomes de componentes fazem parte das mensagens exibidas no log do sistema, assegure que os nomes dos intermediários contenham apenas caracteres que o log do sistema possa exibir. É recomendável utilizar dígitos e letras maiúsculas.

Inclua o nome do componente e a chave do componente à sua cópia de Lista de Verificação de Planejamento de Personalização para z/OS.
Nome do gerenciador de filas
O nome do gerenciador de filas utilizado. Geralmente, o nome do gerenciador de filas faz parte do nome do intermediário.
Brokername
Se você tornar este nome igual ao da tarefa iniciada, o gerenciamento será mais fácil. Este nome é utilizado pelo Configuration Manager.
ComponentDirectory
Este é um diretório em um HFS. Você cria o diretório do componente manualmente no início da personalização. Para obter informações adicionais sobre o tamanho do diretório, consulte Requisitos de Espaço em Disco (). Além disso, inclua esse nome a Criar Lista de Verificação de Comandos.
UserNameServerQueueManagerName
Se planeja utilizar uma autenticação do para , este será o nome do gerenciador de filas no qual o intermediário reside. Observe que em plataformas não-, esse poderá ser um nome longo.

Informações sobre o DB2

Especifique os seguintes valores relacionados ao no Customization Input File.Pode ser necessário falar com o administrador do para coletar estes valores.Você também pode incluir esses nomes à Lista de Verificação de Planejamento de Personalização para z/OS.
DB2_SAMPLE_PGMNAME
Nome do programa de amostra do , utilizado para executar instruções do em batch. Geralmente ele é DSNTIAD ou DSNTEP2, mas sua instalação pode o ter alterado. Se você utilizar SPUFI, execute a consulta select name a partir de SYSIBM.SYSPLAN. Isto mostra todos os planos definidos. Assegure que tenha incluído a biblioteca que contém este programa na concatenação STEPLIB.
DB2_SAMPLE_PGMPLAN
Nome do plano do programa de amostra do .
DB2_DSNACLI_PLANNAME
Nome do plano DSNACLI utilizado pelo .
DB2_SUBSYSTEM
Nome do subsistema . Ele é utilizado pelo JCL de personalização. Você pode utilizar o nome de compartilhamento de dados globais do ou o nome do próprio subsistema .
DB2_LOCATION
Nome do local do . Quando o sistema for inicializado, você obterá uma mensagem DSNL004I DDF START COMPLETE. O local necessário durante a configuração está logo após esta mensagem.
DB2_TABLE_OWNER
Proprietário da tabela do (CURRENTSQLID). Este prefixo é utilizado para criar e acessar tabelas do . Cada intermediário deve possuir seu próprio conjunto de tabelas do DB2. Este proprietário de tabela é utilizado para qualificar as diferentes tabelas, semelhantes a um qualificador de alto nível do conjunto de dados. Isto é referido na documentação do ODBC como o CurrentSQLID. Consulte Configurando o DB2 para obter informações adicionais.
DB2_STORAGE_GROUP
Nome do grupo de armazenamento do .
DB2_STOR_GROUP_VCAT
Nome do catálogo ICF. Os conjuntos de dados do para o intermediário estão catalogados aqui.Se o nome do catálogo tiver mais de 8 caracteres, utilize então um alias.
DB2_STOR_GROUP_VOL
Volume do grupo de armazenamento ou '*' do para volumes gerenciados pelo SMS. Utilizado apenas para o intermediário. Isto identifica os volumes DASD a serem utilizados para as tabelas do .
DB2_DATABASE
O nome do banco de dados do , que pode ser o nome do intermediário.
DB2_BUFFER_POOL
Nome do conjunto de buffers do .

Informações do para

PDSE do Componente
É necessário alocar um conjunto de dados particionado (PDSE) para cada componente para conter todos os jobs necessários, procedimentos e dados de entrada para personalizar e administrar o componente. Você cria o componente PDSE manualmente no início da personalização. Você pode utilizar um PDS em vez de um PDSE. No entanto, os PDSs não reutilizam automaticamente o espaço livre e você pode ter problemas durante uma nova personalização e pode ser necessário compactar manualmente o conjunto de dados.

Selecione um nome que se ajuste com a convenção de nomenclatura de instalação e faça com que o nome do intermediário faça parte do nome do conjunto de dados. Por exemplo, utilize WMQI.MQP1BRK.CNTL ou MQ.MQP1BRK.BIPCNTL, em que MQP1 é o gerenciador de filas que está sendo utilizado. Os administradores do , , e do precisam de acesso UPDATE para este PDSE.

Adicione o nome do PDSE à cópia da Lista de Verificação de Planejamento de Personalização para z/OS.

Chave do Componente
A chave do componente deve ser exclusiva para cada intermediário e, geralmente, recebe o nome desse intermediário.
STPN (Started Task Procedure Name)
Cada componente é iniciado utilizando o JCL e é executado como uma tarefa iniciada. O nome do procedimento de tarefa iniciada pode ter, no máximo, 7 caracteres e não deve começar com os caracteres BIP. É recomendável dar à tarefa iniciada o mesmo nome que o intermediário para evitar confusão.

Inclua o nome do procedimento da tarefa iniciada na cópia do Lista de Verificação de Planejamento de Personalização para z/OS

USER_PROCLIB_PDS
O procedimento de tarefa iniciada será copiado para um PDS de concatenação SYS1.PROCLIB. A personalização cria um job que executa esta cópia. Especifique o nome do PDS que será utilizado. Você também pode copiar o procedimento manualmente.
STEPLIB_NAME
Os nomes dos conjuntos de dados para as bibliotecas de co-requisito, , e LE (Language Environment). O JCL produzido pela personalização faz referência a este nome. Consulte Configurando o JCL para Produtos Co-requisitos.
JAVAHOME
Aponta para o diretório raiz da instalação do Java.
Verifique se você possui a versão correta de Java instalada (consulte Verificando o Nível de Java). Nesse caso, emita o comando whence java. O resultado será semelhante ao seguinte:
/usr/lpp/java/IBM/J1.4/bin/java
Utilize o caminho até, mas não incluindo, o diretório bin, como seu JAVAHOME. Adicione esse caminho à cópia da Lista de Verificação de Planejamento de Personalização para z/OS.
CLASSPATH
Utilize o padrão, a menos que deseje instalar os plug-ins. Consulte a documentação relevante para obter essas informações.
PATH
Utilize o padrão, a menos que deseje instalar os plug-ins. Consulte a documentação relevante para obter essas informações.
LIBPATH
Utilize o padrão, a menos que deseje instalar os plug-ins. Consulte a documentação relevante para obter essas informações.
LILPATH
Utilize o padrão, a menos que deseje instalar os plug-ins. Consulte a documentação relevante para obter essas informações.
DISTHUB_PATH
O local dos executáveis do hub de distribuição. Utilize o padrão, a menos que você tenha instalado o hub de distribuição em um local não-padrão.
LANG
Uma variável de ambiente do . Especifica o valor de idioma internacional para que as mensagens do sejam exibidas no idioma do código do idioma. O padrão é En_US e você pode alterá-lo para Ja_JP ou Zh_CN. Adicione o valor de LANG à cópia da Lista de Verificação de Planejamento de Personalização para z/OS.
LC_ALL
A variável de ambiente do utilizada em conjunto com LANG. Permite substituir outras variáveis de ambiente que começam com LC_. O padrão é En_US e você pode alterá-lo para Ja_JP ou Zh_CN. Inclua o valor do LC_ALL em sua cópia do Lista de Verificação de Planejamento de Personalização para z/OS.
TZ
As configurações de Fuso Horário que contêm a configuração de fuso horário, na qual você está localizado. Consulte o UNIX System Services User's Guide para obter informações adicionais.Inclua o valor de TZ à cópia de Lista de Verificação de Planejamento de Personalização para z/OS.
NLSPATH
Utilize o padrão, a menos que deseje instalar os plug-ins. Consulte a documentação relevante para obter essas informações.
CONSOLE_NLSPATH
Utilize o padrão, a menos que deseje instalar os plug-ins. Consulte a documentação relevante para obter essas informações.
MC_MESSAGES
Se as mensagens do console aparecerem em letras maiúsculas e minúsculas misturadas ou em letras maiúsculas. Adicione o valor de MC_MESSAGES à cópia da Lista de Verificação de Planejamento de Personalização para z/OS.
DB2_CONVERSION
O conversor do DB2; siga as instruções no CIF para adaptar sua configuração de DB2_CONVERSION.
JOBCARDBEGIN e JOBCARDEND
Siga as instruções no CIF para ajustar seu JOBCARD. A sintaxe dos parâmetros do cartão job é igual à descrita em MVS JCL Reference.
ENVIRONMENTBEGIN e ENVIRONMENTEND
Siga as instruções no CIF para ajustar suas variáveis de ambiente.

Planejamento do Gerenciador de Reinicialização Automática

O para permite registrar um componente para o ARM (Automatic Restart Manager).

Ao personalizar um intermediário pela primeira vez, você pode permitir que USE_ARM assuma como padrão NO. Visite-o novamente quando preparar seu sistema de produção. Para ativar o ARM, você pode alterar este valor e personalizar novamente

Para ativar a reinicialização automática:
  • Configurar um conjunto de dados duplo ARM.
  • Definir as ações do novo início automático que deseja que o execute em um critério de ARM.
  • Inicie um critério de ARM.
Os manuais a seguir fornecem informações detalhadas sobre data sets associados ARM, incluindo amostras:
  • z/OS MVS Programming: Sysplex Services Guide
  • z/OS MVS Programming: Sysplex Services Reference
  • z/OS MVS Setting up a Sysplex

Para registrar um componente no ARM na inicialização, defina USE_ARM como YES. Em seguida, você deve fornecer valores para as variáveis ARM_ELEMENTNAME e ARM_ELEMENTTYPE.

ARM_ELEMENTNAME pode ter no máximo 8 caracteres de comprimento, porque inclui um prefixo de SYSWMQI. Por exemplo, se você fornecer o valor MQP1BRK para ARM_ELEMENTNAME, o elemento definido em sua política ARM será SYSWMQI_MQP1BRK.

Especifique os seguintes valores no Customization Input File:
Descrição Nome
Opção que determina se o ARM será utilizado (YES ou NO). USE_ARM
Nome do elemento ARM ARM_ELEMENTNAME
Tipo de elemento ARM ARM_ELEMENTTYPE

Inclua esses valores no Lista de Verificação de Planejamento de Personalização para z/OS.

Conceitos relacionados
Intermediário
Domínio do Intermediário

Tarefas relacionadas
Editando o Arquivo de Entrada de Personalização (mqsicompcif) para um Intermediário
Editando o Arquivo de Entrada de Personalização (mqsicompcif) para um
Verificando o Nível de Java

Referências relacionadas
Lista de Verificação de Planejamento de Personalização para z/OS
Exemplo de Arquivo de Entrada de Personalização (mqsicompcif)