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.
Você deve ter um projeto de pacote configurável do CICS na visualização Explorador de Projetos.
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.
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.
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.