Definindo Pontos de Entrada do Aplicativo

Se seu projeto de pacote configurável do CICS fizer parte de um aplicativo do CICS, declare pontos de entrada do aplicativo adequados no manifesto do pacote configurável. Um ponto de entrada do aplicativo identifica um recurso que é um ponto de acesso para um aplicativo. Pontos de entrada do aplicativo são usados para controlar o acesso dos usuários a diferentes versões de um aplicativo que é implementado em uma plataforma.

Antes de Iniciar

Você deve ter um projeto de pacote configurável do CICS na visualização Explorador de Projetos.

Sobre Esta Tarefa

Os recursos PROGRAM e URIMAP podem ser identificados como pontos de entrada do aplicativo.

Para aplicativos que são implementados em uma plataforma, os pontos de entrada do aplicativo controlam o acesso dos usuários a diferentes versões do aplicativo. Os pontos de entrada do aplicativo podem ser configurados como disponíveis ou indisponíveis para os usuários. Você pode instalar o aplicativo e seus recursos nas regiões do CICS na plataforma em qualquer momento conveniente e, em seguida, ativar os pacotes configuráveis do CICS para verificar a instalação. Ao optar por fornecer a versão do aplicativo aos usuários, você torna os pontos de entrada do aplicativo e, portanto, os recursos que eles controlam para o aplicativo, disponíveis aos responsáveis pela chamada.

Cada ponto de entrada do aplicativo é declarado em um recurso e também nomeia uma operação. Por exemplo, você pode declarar pontos de entrada do aplicativo para criar, ler, atualizar ou excluir operações no aplicativo.
  • Um recurso para um aplicativo pode ser declarado apenas uma vez como um ponto de entrada do aplicativo, nomeando uma operação. Você não pode declarar vários pontos de entrada do aplicativo no mesmo recurso.
  • Um nome de operação deve ser exclusivo dentro de um aplicativo.
  • Os nomes de operações fazem distinção entre maiúsculas e minúsculas, portanto, você pode usar nomes de operações que são diferenciados apenas por maiúsculas e minúsculas.

O recurso para um ponto de entrada do aplicativo não tem que ser definido no mesmo pacote configurável do CICS que o ponto de entrada do aplicativo. O CICS inclui a operação do aplicativo no recurso especificado quando o aplicativo é instalado. Para recursos PROGRAM que são declarados como pontos de entrada do aplicativo, o ponto de entrada do aplicativo controla o acesso dos usuários ao programa independentemente do local do recurso PROGRAM. No entanto, para recursos URIMAP que são declarados como pontos de entrada do aplicativo, o ponto de entrada do aplicativo controla apenas o acesso ao recurso URIMAP se ele for declarado no mesmo pacote configurável do CICS em que o recurso URIMAP é definido.

Você pode declarar um ponto de entrada do aplicativo para um recurso que não é definido em nenhum pacote configurável do CICS, mas já existe nas regiões do CICS em que o pacote configurável será implementado. Você também pode declarar um ponto de entrada do aplicativo para um recurso PROGRAM que pode ser instalado automaticamente nas regiões do CICS em que o pacote configurável será implementado. Quando você instala um aplicativo, se o recurso destinado por um ponto de entrada do aplicativo não estiver presente e não puder ser instalado automaticamente, o pacote configurável do CICS que contém a declaração do ponto de entrada do aplicativo não será instalado e será marcado com um aviso.

Os pacotes configuráveis do CICS que são instalados como parte de pacotes configuráveis da plataforma ou incluídos em uma plataforma em execução não devem conter declarações de pontos de entrada do aplicativo no manifesto do pacote configurável. Os pontos de entrada do aplicativo não são suportados para pacotes configuráveis do CICS instalados diretamente nas plataformas e o CICS não ativa os pontos de entrada do aplicativo nessa situação, embora o pacote configurável do CICS e seus recursos sejam instalados. Os pacotes configuráveis do CICS independentes que são instalados diretamente em regiões do CICS podem conter declarações de pontos de entrada do aplicativo para ativar o escopo de políticas de nível de região.

Os pontos de entrada do aplicativo controlam apenas o acesso dos usuários aos recursos que são especificados nos pontos de entrada do aplicativo. Se um aplicativo incluir quaisquer recursos públicos que não sejam nomeados como pontos de entrada do aplicativo, quando o aplicativo for instalado e ativado, esses recursos poderão ser acessados por outros aplicativos instalados na plataforma ou na região do CICS independentemente do status de disponibilidade do aplicativo. Recursos privados para uma versão do aplicativo não podem ser acessados por outros aplicativos.

Programas que são definidos como um ponto de entrada do aplicativo devem ter um nome de recurso PROGRAM exclusivo em seu ambiente. Para permitir que esses programas sejam chamados de fora do aplicativo, eles devem ser recursos públicos. Quando você ativa um aplicativo que contém um ponto de entrada do aplicativo para um recurso PROGRAM privado, o recurso PROGRAM que é nomeado como o ponto de entrada do aplicativo é alterado de um recurso privado para um recurso público. O recurso PROGRAM, portanto, pode ter o mesmo nome que um programa público que é instalado na região do CICS ou o mesmo nome que um programa público que é definido como um ponto de entrada do aplicativo por outro aplicativo instalado. Várias versões do mesmo programa que é definido como um ponto de entrada do aplicativo podem ser carregadas para várias versões do mesmo aplicativo.

Ao definir um recurso URIMAP em um pacote configurável do CICS, você pode usar uma declaração de ponto de entrada do aplicativo para controlar o acesso dos usuários ao serviço fornecido pelo recurso URIMAP. Para esta função, declare o ponto de entrada do aplicativo e defina o recurso URIMAP no mesmo pacote configurável do CICS. Neste caso, quando você instala e ativa o aplicativo, o serviço fornecido pelo recurso URIMAP ainda não está disponível para os responsáveis pela chamada. Quando você opta por fornecer o serviço aos usuários, você torna o pacote configurável do CICS que contém o ponto de entrada do aplicativo e o recurso URIMAP disponíveis usando o CICS Explorer ou o comando EXEC CICS SET BUNDLE. Esta ação torna o ponto de entrada do aplicativo e, portanto, o serviço fornecido pelo recurso URIMAP, disponíveis para os responsáveis pela chamada.

Se você não quiser que o ponto de entrada do aplicativo controle o acesso ao serviço fornecido pelo recurso URIMAP, declare o ponto de entrada do aplicativo e defina o recurso URIMAP em diferentes pacotes configuráveis do CICS. Você também pode declarar como um ponto de entrada do aplicativo um recurso URIMAP que é definido fora do aplicativo e declarado como uma dependência ou importação para o aplicativo. Em qualquer um desses casos, o serviço fica disponível aos usuários assim que você instalar e ativar o recurso URIMAP.

Procedimento

  1. Expanda o projeto de pacote configurável do CICS e a pasta META-INF.
  2. Abra o arquivo cics.xml para visualizar o editor de manifesto do pacote configurável do CICS.
  3. Clique na guia Pontos de Entrada para abrir a lista de pontos de entrada do aplicativo para o pacote configurável.
  4. Clique em Incluir para definir um ponto de entrada do aplicativo para o aplicativo. O diálogo Criar Ponto de Entrada do Aplicativo é exibido.
    1. Insira o nome da operação do aplicativo. O nome da operação faz distinção entre maiúsculas e minúsculas. Ele pode incluir os caracteres a-z, A-Z, 0-9._#@- e tem um comprimento máximo de 64 caracteres. Certifique-se de que o nome da operação seja exclusivo dentro de seu aplicativo. Se um aplicativo contiver nomes de operação duplicados, ele não poderá ser disponibilizado.
    2. Selecione o tipo de recurso.
    3. Insira o nome do recurso do CICS.
  5. Clique em OK para salvar o ponto de entrada do aplicativo.

Resultados

Assim como controlar o acesso dos usuários a diferentes versões de um aplicativo, os pontos de entrada do aplicativo são usados para criar um contexto de aplicativos para as tarefas. Quando o aplicativo for implementado, o nome da operação será incluído no recurso especificado, e os dados de contexto de aplicativos serão produzidos para tarefas que usam o recurso.

Quando uma tarefa chama um recurso que tem um ponto de entrada do aplicativo, o CICS cria um contexto de aplicativos que se torna o contexto de aplicativos inicial associado à tarefa e com todos os programas subsequentes que ele chama e as tarefas que ele inicia. O contexto de aplicativos identifica a plataforma, o aplicativo, a versão do aplicativo e a operação. Se uma tarefa já tiver um contexto de aplicativo, este se tornará o contexto de aplicativo atual, embora o contexto de aplicativo da tarefa de chamada possa ser usado para monitorar e definir o escopo de políticas. Você pode usar os dados do contexto de aplicativo para os seguintes propósitos:
  • O contexto de aplicativo inicial é usado para monitorar e medir quanto recurso um aplicativo ou uma operação de aplicativo particular está usando em regiões do CICS e em várias tarefas.
  • O contexto de aplicativo inicial é usado para aplicar uma política a tarefas que fazem parte de um aplicativo, para definir as condições de limite para gerenciar o comportamento das tarefas.
  • O contexto de aplicativo inicial ou atual pode ser usado com o recurso de rastreamento de transação no CICS Explorer para identificar rapidamente e diagnosticar problemas relacionados ao aplicativo.