Adicionar um membro de um conjunto de dados externo usando a ação Adicionar elementos

Para controlar e gerenciar um membro de um conjunto de dados externo, você usa a ação Adicionar Elementos (disponível em primeiro plano, lote e em pacotes).
O membro pode ser qualquer um dos seguintes:

• Um conjunto de dados sequencial
• Arquivos Hierarchical File System (HFS) (CA CM Enterprise Workbench apenas)
• Membros da biblioteca PDS ou PDSE
• Membros da biblioteca CA Panvalet
• Membros da biblioteca CA Librarian
• Módulos de carga (RECFM = U)
• Arquivos binários

Você pode adicionar membros apenas ao estágio de entrada e somente quando não houver outro elemento com o mesmo nome no estágio de entrada de destino.

Nota: Se você tiver um elemento com o mesmo nome no estágio de entrada de destino, use a ação Atualizar Elementos.

Esta seção contém informações para executar esta tarefa de desenvolvimento apenas em primeiro plano.

Nota:
Para obter mais informações sobre como executar essa ação de elemento em lote, consulte o Guia de Referência SCL.
Para obter mais informações sobre como executar esta ação de elemento usando pacotes, consulte o Guia de Pacotes.
As ações Adicionar, Mover, Gerar e Assinar podem ser executadas no painel Opção de edição rápida, se a opção Edição rápida do CA Endevor SCM estiver ativada em seu site.
Para obter mais informações sobre a Edição rápida, consulte o Guia do usuário da opção de edição rápida.

Considerações ao adicionar um membro de um conjunto de dados externo

Antes de permitir que o produto controle um membro de um conjunto de dados externo usando a ação Adicionar Elementos, considere as seguintes informações para garantir seu sucesso:

Important!
Se você não seguir essas considerações e continuar adicionando o elemento, a ação Adicionar Elementos falhará.

• Certifique-se de que um elemento com o mesmo nome ainda não esteja no estágio de entrada de destino.
  Nesse caso, primeiro entre em contato com o proprietário do elemento atual, ou o administrador do site, para discutir a ação mais apropriada.
  Então, considere estas soluções alternativas:
  • Aguarde até que o elemento tenha sido movido para fora do estágio de entrada e, em seguida, adicione o membro.
  • Adicione o membro usando a opção ATUALIZAR SE PRESENTE.
  • Adicione o membro usando a ação Atualizar Elementos.


• Certifique-se de que o elemento correspondente ao membro que você deseja adicionar esteja desconectado para você.
  Se o elemento for desconectado para outra pessoa de sua equipe, primeiro entre em contato com o proprietário do elemento atual, ou o administrador do site, para ver se eles podem desconectar o elemento para você.
  Então, considere estas soluções alternativas:
  • Assine o elemento usando a opção SIGNOUT TO.
  • Adicione o membro usando a opção OVERRIDE SIGNOUT.
    
    Nota: Se o administrador do site restringiu as permissões para a opção OVERRIDE SIGNOUT, você não poderá usar a opção.

Como funciona a adição de um membro de um conjunto de dados externo

Quando você permite que o produto controle um membro de um conjunto de dados externo usando a ação Adicionar Elementos, o produto executa as seguintes ações e causa estes efeitos:

1. Verifica se o elemento está desconectado para você e não existe no estágio de entrada.


2. Pesquisa além do estágio de entrada por um elemento com o mesmo nome.

   Nota: Nota: Cada estágio na rota mapeada é pesquisado por uma correspondência.
   Se o elemento for encontrado em um estágio no mapa, o produto copia a versão atual do elemento para o estágio de entrada de destino, junto com o último nome do grupo de processadores usado para o elemento.

3. Se você codificar a opção de nova versão, o elemento não será copiado de volta para o estágio de entrada.
   O produto atribui o número da versão que você inserir.

   Importante! Se o elemento for encontrado em um estágio que não está incluído no mapa, você receberá uma mensagem de aviso.
   A busca continua por um elemento em um estágio que está incluído no mapa.

4. Compara o membro que está sendo adicionado com a base do estágio de entrada.
   Se o elemento não for encontrado ao longo do mapa, o elemento é criado no estágio de entrada com um número de versão 01 e nível de base 00 (zero).


5. Se o produto construiu uma base de estágio de entrada, o membro que está sendo adicionado é comparado a essa base e constrói um novo nível com quaisquer mudanças.
   Se nenhuma mudança for detectada, você receberá uma mensagem de aviso.


6. Atualiza o arquivo de controle mestre (MCF).

   Importante!
   O valor especificado para Signout Upon Fetch (o parâmetro SOFETCH) na Tabela de Padrões (C1DEFLTS) afeta como o MCF será atualizado para o elemento copiado de volta (obtido).
   Se Signout Upon Fetch estiver em vigor, o elemento será desconectado para você, a menos que já tenha sido desconectado para outra pessoa.
   Se Signout Upon Fetch não estiver em vigor, o elemento não será desconectado para você.

   Observação: para obter mais informações sobre Signout Upon Fetch, consulte o Guia de Administração.

7. Continua executando a ação com base no valor da opção GENERATE ELEMENT.
   Se esta opção for definida como N, o elemento não será gerado.
   Se esta opção for definida como Y, o produto executa as seguintes ações:
   • Lê a definição de tipo para uma especificação de biblioteca de saída de origem e grava uma cópia do nível atual do elemento nessa biblioteca.
     Se a opção EXPAND INCLUDES for definida como Y, o produto expandirá as instruções INCLUDE na origem.
   • Determina qual grupo de processadores usar e executa o processador de geração nesse grupo (se um tiver sido especificado).
     Depois que o processador de geração foi executado para o elemento, o produto atualiza as informações do processador no Arquivo de controle mestre.

     Observação: para obter mais informações sobre processadores, consulte o apêndice Selecionando o grupo correto de processadores.

8. Exclui o membro da biblioteca FROM (se a opção DELETE INPUT SOURCE estiver definida como Y).

Como a adição de um membro de um conjunto de dados externo afeta o status de desconexão

O administrador do site pode habilitar o recurso de logout sistema a sistema.
Quando você permite que o produto controle um membro de um conjunto de dados externo usando a ação Adicionar Elementos, o produto executa as seguintes ações e causa estes efeitos:

• Se o elemento existir no mapa, uma busca será executada.
  • Se o administrador do site ativou Signout Upon Fetch, o elemento buscado (fonte) é desconectado para você, se o elemento não for desconectado para outra pessoa.
    Além disso, o elemento de destino é desconectado para você.
  • Se o administrador do seu site não habilitou Signout Upon Fetch, não há mudança no status de logout e o elemento de destino é desconectado para você.


• Se o elemento não existir no mapa, uma busca não será executada.
  • Se o administrador do seu site habilitou Signout Upon Fetch, o elemento de destino é desconectado para você.
  • Se o administrador do site não habilitou Signout Upon Fetch, o elemento de destino é desconectado para você.
  Observação: para obter mais informações sobre Signout Upon Fetch, consulte o Guia de Administração.

Como adicionar um membro de um conjunto de dados externo afeta CCIDs e comentários

Ao permitir que o produto controle um membro de um conjunto de dados externo usando a ação Adicionar Elementos, você pode inserir um CCID e um comentário.

Se você gerencia um novo elemento:

• Fonte atual CCID / Comentário
• Gerar CCID / Comentário (se alterado)
• Última ação CCID / Comentário
• Fonte Delta CCID / Comentário
• Componente Delta CCID / Comentário (se gerado)

Se você gerencia um elemento existente:

• Fonte atual CCID / Comentário (se alterado)
• Gerar CCID / Comentário (se gerado)
• Última ação CCID / Comentário
• Fonte Delta CCID / Comentário
• Componente Delta CCID / Comentário (se a geração criar um delta)

Nota: Se você definir a opção GERAR ELEMENTO como N, a ação Adicionar Elementos não definirá os CCIDs e comentários de delta de geração ou componente.

Adicionar um membro de um conjunto de dados externo (External Data Set)

Para controlar e gerenciar um membro de um conjunto de dados externo (membro PDS ou PDS / E, CA Panvalet, CA Librarian ou conjunto de dados sequencial ou módulo de carregamento), você usa a ação Adicionar Elementos.

Siga as etapas abaixo para adicionar um elemento ao estágio de entrada do endevor.

1. Inicie o produto usando as instruções fornecidas pelo administrador do site.

   O painel Opções primárias é exibido.

   

2. Digite 2 (primeiro plano) e pressione Enter.

   O menu Opções de primeiro plano é exibido.

   

3. Digite 2 (Adicionar/Atualizar (Add/Update)) e pressione Enter.

   O painel Adicionar/Atualizar (Add/Update) Elementos é exibido.

   

   Observação: para obter mais informações sobre um campo ou opção no painel, pressione PF1.

   Observação: para obter mais informações sobre como adicionar ou atualizar um elemento com a opção Autogen, consulte Como funciona a geração de elementos com Autogen.

4. Escolha uma das etapas a seguir.

   1. Para adicionar um membro, insira as informações para a ação, insira A no campo Opção e pressione Enter.

      Nota: Se você quiser que o nome do elemento seja diferente do nome do membro, altere o nome na opção ELEMENT.
      Além disso, se você estiver adicionando um elemento pela primeira vez, o comentário se tornará a descrição do elemento no Arquivo de controle mestre.

   2. Para adicionar vários membros, deixe o campo Opção em branco e pressione Enter.

      A Lista de Seleção de Membros é exibida.
      Esta lista aparece quando o conjunto de dados de origem é uma biblioteca, você deixa o campo Opção em branco, a opção DISPLAY LIST é definida como Y e quando as opções ELEMENT e MEMBER estão em branco ou têm uma máscara de nome.
      O comando ISPF Localizar é compatível com listas de Seleção de Membros.

5. (Opcional) Se a Lista de Seleção de Membros aparecer, insira A à esquerda de cada membro que deseja adicionar e pressione Enter.

   Os membros são adicionados e você retorna ao painel Adicionar / Atualizar Elementos.
   Você pode navegar no conjunto de dados da lista para obter mais informações sobre cada membro selecionado.