COBOL - Endevor - Add Element - www.cadcobol.com.br



Desenvolvido por DORNELLES Carlos Alberto - Analista de Sistemas - Brasília DF. - cad_cobol@hotmail.com

COBOL - Endevor - Add Element

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.


© Copyright CA Technologies