Analise e gere arquivos de host de mainframes IBM para fluxos de trabalho padrão em Aplicativos Lógicos do Azure
Aplica-se a: Aplicativos Lógicos do Azure (Padrão)
Para analisar e gerar novos arquivos de host IBM e arquivos físicos do i Series a partir de fluxos de trabalho padrão no Azure Logic Apps, é possível usar o conector integrado baseado em provedor de serviços do IBM Host File . Desde a introdução dos sistemas de mainframe, arquivos de host ubíquos são usados para armazenar dados abundantes para sistemas de missão crítica. Embora esse conector não exija acesso a um mainframe IBM ou sistema midrange, você deve disponibilizar o arquivo host para um fluxo de trabalho Standard usando outros mecanismos, como FTP, armazenamento de blob, Host Integration Server ou um dispositivo de software parceiro. O IBM Host File connector está disponível em todas as regiões do Azure Logic Apps , exceto para o Azure Government e o Microsoft Azure operado pela 21Vianet.
Este guia de instruções descreve os seguintes aspetos sobre o conector do IBM Host File :
Por que usar o conector IBM Host File no Azure Logic Apps
Pré-requisitos e configuração para usar o IBM Host File connector
Etapas para adicionar as ações do conector do IBM Host File ao fluxo de trabalho do aplicativo lógico padrão
Porquê usar este conector?
Em mainframes IBM, os métodos de acesso, que são componentes especiais no sistema operacional, lidam com o processamento de arquivos. Na década de 1970, o Virtual Storage Access Method (VSAM) foi construído e tornou-se o método de acesso mais utilizado em mainframes IBM. O VSAM fornece os seguintes tipos de arquivos: conjuntos de dados seqüenciados de entrada, conjuntos de dados seqüenciados por chave e conjuntos de dados de registro relativos.
Hoje, o mercado tem várias soluções que se conectam diretamente a arquivos de host e executam operações de dados. Muitas soluções exigem a instalação de software no sistema de mainframe. Embora essa opção funcione bem para alguns clientes, outros querem evitar aumentar a pegada em seus sistemas de mainframe.
O Microsoft Host Integration Server (HIS) fornece um adaptador gerenciado para arquivos host e não requer a instalação de software no mainframe. No entanto, o HIS requer que você habilite o subsistema de mainframe IBM Distributed File Manager (DFM), que requer LU 6.2. Esse provedor gerenciado também requer que você configure um gateway SNA (Arquitetura de Rede do Sistema HIS) que forneça acesso ao DFM.
Na maioria das maneiras, o provedor gerenciado opera como um provedor de dados normal. Você pode se conectar a um sistema de arquivos host, executar comandos e recuperar dados. Embora seja uma ótima alternativa para alguns clientes, o IBM Host File connector requer que você disponibilize arquivos de host IBM em formato binário para fluxos de trabalho padrão no Azure Logic Apps. Esse requisito reduz a complexidade dessa solução e permite que você use suas ferramentas escolhidas para acessar e gerenciar dados em arquivos host. Depois de disponibilizar o arquivo host em um local onde o fluxo de trabalho Standard pode usar um gatilho para ler o arquivo, a operação IBM Host File connector pode analisar esse arquivo.
Para clientes interessados em acessar e usar bancos de dados, como SQL Server ou Cosmos DB, em seus ambientes de mainframe, o IBM Host File connector fornece a capacidade de gerar arquivos host no formato JSON. Dessa forma, você pode usar esses arquivos de host em seu banco de dados de nuvem de escolha e enviar os dados de volta como um arquivo de host para seus ambientes de mainframe ou midrange.
O diagrama a seguir mostra como o conector do IBM Host File no Azure Logic Apps interage com outros sistemas:
Para estender cenários de nuvem híbrida, o conector IBM Host File funciona com o HIS Designer for Logic Apps, que pode ser usado para criar uma definição de dados ou um mapa de dados do arquivo host de mainframe. Para esta tarefa, o HIS Designer converte esses dados em metadados que o IBM Host File connector usa ao executar uma ação em seu fluxo de trabalho. O conector executa as conversões de tipo de dados, que são necessárias para receber entrada de operações de fluxo de trabalho anteriores e para enviar saída para uso por ações de fluxo de trabalho subsequentes. O conector também fornece definição de dados tabulares e tradução de página de código.
Depois de gerar o arquivo de metadados como um arquivo HIDX (Host Integration Designer XML) do HIS Designer, você pode adicionar esse arquivo como um artefato de mapa ao recurso do aplicativo lógico padrão. Dessa forma, seu fluxo de trabalho pode acessar os metadados do seu aplicativo quando você adiciona uma ação do conector do IBM Host File . O conector lê o arquivo de metadados do recurso do aplicativo lógico e apresenta dinamicamente a estrutura do arquivo binário a ser usada com as ações do conector do IBM Host File em seu fluxo de trabalho.
Referência técnica do conector
A seção a seguir descreve as operações para o conector do IBM Host File , que atualmente inclui apenas as seguintes ações:
Ação Analisar Conteúdo do Arquivo Host
| Parâmetro | Necessário | Tipo | Description |
|---|---|---|---|
| Nome HIDX | Sim | String | Selecione o arquivo HIDX do arquivo host de mainframe que você deseja usar. |
| Nome do Esquema | Sim | String | Selecione o esquema de arquivo host no arquivo HIDX que você deseja usar. |
| Conteúdo binário | Sim | Binário | Selecione os dados binários com um registro de comprimento fixo extraído do mainframe. |
Ação Gerar Conteúdo do Arquivo Host
| Parâmetro | Necessário | Tipo | Description |
|---|---|---|---|
| Nome HIDX | Sim | String | Selecione o arquivo HIDX do arquivo host de mainframe que você deseja usar. |
| Nome do Esquema | Sim | String | Selecione o esquema de arquivo host no arquivo HIDX que você deseja usar. |
| Rows (Linhas) | Sim | JSON | Selecione a Matriz ou linhas individuais. Para inserir um objeto de dados inteiro no formato JSON, você pode selecionar a opção Alternar para inserir matriz inteira. |
Limitações
Atualmente, esse conector requer que você carregue seu arquivo HIDX diretamente no recurso do aplicativo lógico padrão, não em uma conta de integração.
Pré-requisitos
Uma conta e subscrição do Azure. Se não tiver uma subscrição do Azure, inscreva-se para obter uma conta do Azure gratuita.
O arquivo XML do Host Integration Designer (HIDX) que fornece os metadados necessários para que o conector do IBM Host File reconheça a estrutura de dados do arquivo host.
Para criar esse arquivo HIDX, baixe e instale o HIS Designer for Azure Logic Apps. O único pré-requisito é o Microsoft .NET Framework 4.8.
Para analisar e gerar arquivos host de forma eficaz, seu fluxo de trabalho precisa entender os metadados do arquivo host. No entanto, como uma diferença fundamental entre um arquivo host e uma tabela de banco de dados, o arquivo host não tem os metadados que descrevem a estrutura de dados. Para criar esses metadados, use o HIS Designer for Logic Apps. Com essa ferramenta, você pode criar manualmente a estrutura de arquivos do host que seu fluxo de trabalho usa. Você também pode importar definições de COBOL (copybooks) que fornecem essas estruturas de dados.
A ferramenta gera um arquivo HIDX (Host Integration Designer XML) que fornece os metadados necessários para que o conector reconheça a estrutura de dados do arquivo host. Se você estiver usando o HIS, poderá usar o TI Designer para criar o arquivo HIDX.
O fluxo de trabalho do aplicativo lógico padrão onde você deseja analisar ou gerar o arquivo host.
O conector do IBM Host File não tem gatilhos, portanto, use qualquer gatilho para iniciar seu fluxo de trabalho, como o gatilho de Recorrência ou o gatilho de Armazenamento de Blob do Azure. Em seguida, é possível adicionar as ações do conector do IBM Host File . Para começar, crie um fluxo de trabalho em branco no recurso do aplicativo lógico padrão.
Definir e gerar metadados
Depois de baixar e instalar o HIS Designer para Aplicativos Lógicos do Azure, siga estas etapas para gerar o arquivo HIDX a partir do artefato de metadados.
Carregue o arquivo HIDX
Para que seu fluxo de trabalho use o arquivo HIDX, siga estas etapas:
Vá para a pasta onde você salvou o arquivo HIDX e copie o arquivo.
No portal do Azure, carregue o arquivo HIDX como um mapa para seu recurso de aplicativo lógico padrão.
Agora, adicione uma ação do IBM Host File ao seu fluxo de trabalho.
Mais adiante neste guia, quando você adiciona a ação Analisar Conteúdo do Arquivo Host ao seu fluxo de trabalho pela primeira vez, você será solicitado a criar uma conexão. Depois de criar a conexão, você pode selecionar o arquivo HIDX adicionado anteriormente, o esquema e os parâmetros a serem usados.
Adicionar uma ação Analisar Conteúdo do Arquivo Host
No portal do Azure, abra o recurso e o fluxo de trabalho do aplicativo lógico padrão no designer.
Se você ainda não adicionou um gatilho para iniciar seu fluxo de trabalho, siga estas etapas gerais para adicionar o gatilho desejado.
Este exemplo continua com o gatilho interno baseado em provedor de serviços do Armazenamento de Blob do Azure chamado Quando um blob é adicionado ou atualizado.
Para obter o conteúdo do blob adicionado ou atualizado, siga estas etapas gerais para adicionar a ação de conector interna do Armazenamento de Blobs do Azure chamada Ler conteúdo de blob.
Depois que o painel de detalhes da conexão for exibido, forneça as seguintes informações:
Parâmetro Necessário Valor Description Nome da Ligação Sim <nome da conexão> O nome da sua ligação Página de código Não <página de código> O número de página de código a ser usado para converter texto Do iSeries Não <MF-iSeries> Se o ficheiro é originário de um servidor i Series Por exemplo:
Quando terminar, selecione Criar novo.
Depois que o painel de detalhes da ação for exibido, na seção Parâmetros , forneça as informações necessárias:
Parâmetro Necessário Valor Description Nome HIDX Sim <Nome do ficheiro HIDX> Selecione o arquivo HIDX do arquivo host de mainframe que você deseja usar. Nome do Esquema Sim <nome do esquema> Selecione o esquema no arquivo HIDX que você deseja usar. Conteúdo binário Sim <conteúdos-binários> Selecione os dados binários com um registro de comprimento fixo extraído do host. Por exemplo, a imagem a seguir mostra o Visual Studio com um arquivo de host de exemplo HIDX com uma tabela CUSTOMER e CUSTOMER_RECORD esquema no HIS Designer for Logic Apps:
Fornecer arquivo e esquema HIDX
Selecionar dados binários para ler do blob
Quando terminar, a ação Analisar Conteúdo do Arquivo Host se parecerá com o exemplo a seguir com uma ação subsequente que cria um arquivo em um servidor SFTP:
Quando terminar, salve seu fluxo de trabalho. Na barra de ferramentas do designer, selecione Salvar.
Adicionar uma ação Gerar Conteúdo do Arquivo Host
No portal do Azure, abra o recurso e o fluxo de trabalho do aplicativo lógico padrão no designer.
Se você ainda não adicionou um gatilho para iniciar seu fluxo de trabalho, siga estas etapas gerais para adicionar o gatilho desejado.
Este exemplo continua com o gatilho interno baseado em provedor de serviços do Armazenamento de Blob do Azure chamado Quando um blob é adicionado ou atualizado.
Para obter o conteúdo do blob adicionado ou atualizado, siga estas etapas gerais para adicionar a ação de conector interna do Armazenamento de Blobs do Azure chamada Ler conteúdo de blob.
Depois que o painel de detalhes da conexão for exibido, forneça as seguintes informações:
Parâmetro Necessário Valor Description Nome da Ligação Sim <nome da conexão> O nome da sua ligação Página de código Não <página de código> O número da página de código a ser usado para converter texto Do iSeries Não <MF-ISERIES> Se o ficheiro é originário de um servidor i Series Por exemplo:
Quando terminar, selecione Criar novo.
Depois que o painel de detalhes da ação for exibido, na seção Parâmetros , forneça as informações necessárias:
Parâmetro Necessário Valor Description Nome HIDX Sim <Nome do ficheiro HIDX> Forneça o nome para o arquivo HIDX do arquivo host de mainframe que você deseja usar. Nome do Esquema Sim <nome do esquema> Forneça o nome para o esquema no arquivo HIDX que você deseja usar. Rows (Linhas) Sim <linhas> Forneça uma matriz de registros para converter para o formato IBM. Para selecionar a saída de uma operação de fluxo de trabalho anterior, siga estas etapas:
1. Selecione dentro da caixa Linhas e, em seguida, selecione a opção de conteúdo dinâmico (raio).
2. Na lista de conteúdo dinâmico, selecione a saída de uma ação anterior. Por exemplo, na seção Ler conteúdo de blob, selecione Resposta da ação de blob de leitura Conteúdo.
Dica: Para inserir um objeto de dados inteiro no formato JSON, selecione a opção Alternar para inserir matriz inteira.Por exemplo, a imagem a seguir mostra o Visual Studio com um arquivo HIDX de exemplo no HIS Designer for Logic Apps:
Fornecer arquivo e esquema HIDX
Selecionar linhas do blob para ler e converter
Quando terminar, a ação Gerar Conteúdo do Arquivo Host se parece com o exemplo a seguir com uma ação subsequente que cria um arquivo em um servidor SFTP:
Quando terminar, salve seu fluxo de trabalho. Na barra de ferramentas do designer, selecione Salvar.
Testar o fluxo de trabalho
Para executar seu fluxo de trabalho, no menu de fluxo de trabalho, selecione Visão geral. Na barra de ferramentas Visão geral, selecione Executar>execução.
Depois que o fluxo de trabalho terminar de ser executado, o histórico de execução do fluxo de trabalho será exibido. As etapas bem-sucedidas mostram marcas de seleção, enquanto as etapas malsucedidas mostram um ponto de exclamação (!).
Para revisar as entradas e saídas de cada etapa, expanda essa etapa.
Para rever as saídas, selecione Ver saídas brutas.
Próximos passos
- Monitore o status de execução do fluxo de trabalho, revise o histórico de execução do gatilho e do fluxo de trabalho e configure alertas nos Aplicativos Lógicos do Azure
- Exibir métricas de integridade e desempenho do fluxo de trabalho nos Aplicativos Lógicos do Azure
- Monitorar e coletar dados de diagnóstico para fluxos de trabalho nos Aplicativos Lógicos do Azure
- Habilitar e exibir telemetria aprimorada em fluxos de trabalho do Application Insights for Standard em Aplicativos Lógicos do Azure