Arquivar dados do mainframe no Cloud Storage

Nesta página, descrevemos como arquivar e restaurar dados do mainframe no Cloud Storage usando o Mainframe Connector.

Antes de começar

• Começar a usar o Mainframe Connector
• Instalar o Mainframe Connector no mainframe

Arquivar arquivos do mainframe no Cloud Storage

Para arquivar arquivos do mainframe no Cloud Storage, siga estas etapas:

1. Crie um bucket de armazenamento para seus arquivos. Ao criar o bucket, escolha a classe de armazenamento Arquivo.

2. É possível arquivar os dados binários do mainframe como estão em um bucket do Cloud Storage. Para fazer isso, use o comando scp da seguinte maneira:

   scp --inDD=INPUT_DD
   --gcsOutUri=URI
   --encoding=ENCODING
   –-noConvert

   Substitua:

   • INPUT_DD: o arquivo de definição de dados (DD) a ser copiado. O valor padrão é DD INFILE.
   • URI: o identificador uniforme de recursos (URI) do Cloud Storage de destino do arquivo a ser copiado.
   • ENCODING: a codificação de caracteres de entrada. O valor padrão é CP037.
   Observação: também é possível converter os dados binários do mainframe em um arquivo ORC, CSV ou JSON para um bucket do Cloud Storage usando o comando qsam decode.

Restaurar um arquivo do Cloud Storage para o mainframe

Use o comando gsutil cp para restaurar um arquivo do Cloud Storage para um conjunto de dados do mainframe. Não é possível copiar conjuntos de dados particionados (PDS).

Observação: só é possível restaurar dados binários de mainframe arquivados sem conversão para outro formato de arquivo usando o comando gsutil cp. O Mainframe Connector não é compatível com a restauração de dados do mainframe convertidos para outros formatos de arquivo.

Para restaurar um arquivo do Cloud Storage para um conjunto de dados do mainframe, siga estas etapas:

1. Especifique o DSN e os requisitos de espaço do arquivo que você quer baixar para o mainframe em JCL. No exemplo a seguir, o formato de registro (RECFM) no arquivo de saída é FB. Modifique o DD OUTFILE para atender aos seus requisitos.

   //OUTFILE  DD DSN=MAINFRAME.DSN.FILE,DISP=(,CATLG),
   //            RECFM=FB,DSORG=PS,
   //            SPACE=(10,(2,1),RLSE),
   //            AVGREC=M,
   //            UNIT=SYSDA
   //SYSPRINT DD SYSOUT=*
   //SYSDUMP  DD SYSOUT=*
   //STDIN DD *
   

2. Execute o comando gsutil cp no seguinte formato. Se o arquivo já existir no mainframe, adicione a flag --replace ao comando.

   gsutil cp GCS_URI DSN --recfm=RECFM --lrecl=LRECL --blksize=BLKSIZE --noseek
   

   Substitua:

   • GCS_URI: o URI do Cloud Storage do arquivo. Por exemplo, gs://bucket/sample.mainframe.dsn.
   • DSN: o local de destino do DSN no mainframe.
   • RECFM: o formato do registro (RECFM) do arquivo do mainframe. Os valores válidos são F, FB e U. Esses valores não diferenciam maiúsculas de minúsculas.
   • LRECL: (opcional) o comprimento do registro (LRECL) do arquivo. O valor precisa ser um número inteiro maior ou igual a zero. Se LRECL não for especificado, o arquivo será considerado no formato de registro de comprimento indefinido (U).
   • BLKSIZE: (opcional) o tamanho do bloco do arquivo. Se definido como 0, o sistema vai determinar o tamanho ideal do bloco. O valor precisa ser um número inteiro >= 0. Se você não especificar um valor, o arquivo será tratado como um arquivo desbloqueado.
   • noseek: (opcional) inclua esse parâmetro se quiser melhorar o desempenho do download. Por padrão, essa flag é definida como "false", ou seja, as operações de busca são ativadas.