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 manifest 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. Pontos de entrada do aplicativo também podem ser definidos em pacotes configuráveis que são implementados em regiões independentes do CICS. Neste caso, se os pontos de entrada do aplicativo forem definidos em conjunto com um escopo da política, eles poderão ser usados para restringir o escopo de uma política que define regras de tarefa para tarefas do usuário específicas.

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, TRANSACTION 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 em 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 sejam diferenciados somente 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. Quando um recurso para um ponto de entrada do aplicativo e o ponto de entrada são ambos definidos como parte de um aplicativo, o ponto de entrada controla o acesso ao serviço fornecido pelo recurso. Por exemplo, um TRANSACTION definido como um ponto de entrada do aplicativo não pode ser chamado até o aplicativo se tornar disponível.

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. Ao instalar um aplicativo, se o recurso que um ponto de entrada do aplicativo destina 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 poderá ser ativado, e a parte do pacote configurável do ponto de entrada permanecerá desativada.

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 manifest 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, não pode ter o mesmo nome que um programa público que está instalado na região CICS ou um programa público que é definido como um ponto de entrada do aplicativo por um outro aplicativo instalado. No entanto, várias versões do mesmo recurso PROGRAM que é definido como um ponto de entrada do aplicativo podem ser instaladas para várias versões do mesmo aplicativo.

Ao definir um recurso URIMAP ou TRANSACTION em um pacote configurável do aplicativo CICS, é possível usar uma declaração de ponto de entrada do aplicativo para controlar o acesso dos usuários ao serviço fornecido pelo recurso URIMAP ou TRANSACTION. Nesta situação, quando você instala e ativa o aplicativo, o serviço fornecido pelo recurso URIMAP ou TRANSACTION ainda não está disponível para os responsáveis pela chamada. Ao escolher fornecer o serviço para usuários, você disponibiliza o pacote configurável do CICS que contém o ponto de entrada do aplicativo e o recurso URIMAP ou TRANSACTION usando a visualização Pacotes configuráveis no CICS Explorer ou no comando EXEC CICS SET BUNDLE. Esta ação torna o ponto de entrada do aplicativo e, portanto, o serviço fornecido pelo recurso URIMAP ou TRANSACTION, disponível para os responsáveis pela chamada.

Também é possível declarar como um ponto de entrada do aplicativo um recurso URIMAP ou TRANSACTION que está definido fora do aplicativo. Nesta situação, o serviço se torna disponível aos usuários assim que você instala e ativa o recurso URIMAP ou TRANSACTION.

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 manifest 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. Assegure que o nome da operação seja exclusivo em 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 específica, está usando em regiões 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 e diagnosticar problemas relacionados ao aplicativo.