As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
O M2DFUTIL é um programa utilitário em JCL que fornece funções de backup, restauração, exclusão e cópia em conjuntos de dados, semelhantes ao suporte fornecido pelo utilitário ADRDSSU de mainframe. Esse programa retém muitos dos parâmetros SYSIN do ADRDSSU, o que simplifica o processo de migração para esse novo utilitário.
Tópicos
Plataformas compatíveis
Você pode usar o M2DFUTIL em qualquer uma das seguintes plataformas:
-
Rocket Software (anteriormente Micro Focus) ES no Windows (64 bits e 32 bits)
-
Rocket Software ES em Linux (64 bits)
Requisitos da plataforma
O M2DFUTIL depende da chamada de um script para realizar um teste de expressão regular. No Windows, você deve instalar o Windows Services for Linux (WSL) para que esse script seja executado.
Suporte futuro planejado
Os recursos que atualmente não estão disponíveis no utilitário ADRDSSU de mainframe, mas que estão no escopo futuro, incluem:
-
M2 gerenciado
-
VSAM
-
Suporte a COPY para a renomeação de nomes de arquivos
-
Suporte a RENAME para RESTORE
-
INCLUDE e EXCLUDE vários
-
Cláusula BY para subseleção por DSORG, CREDT, EXPDT
-
Cláusula MWAIT para tentar novamente falhas de enfileiramento
-
Suporte ao armazenamento do S3 para DUMP/RESTORE
Locais dos ativos
O módulo de carregamento desse utilitário é chamado M2DFUTIL.so no Linux e M2DFUTIL.dll no Windows. Esse módulo de carregamento pode ser encontrado em um dos seguintes locais:
-
Linux:
/opt/aws/m2/microfocus/utilities/64bit -
Windows (32 bits):
C:\AWS\M2\MicroFocus\Utilities\32bit -
Windows (64 bits):
C:\AWS\M2\MicroFocus\Utilities\64bit
O script usado para testes de expressão regular é chamado compare.sh. O script pode ser encontrado em um dos seguintes locais:
-
Linux:
/opt/aws/m2/microfocus/utilities/scripts -
Windows (32 bits):
C:\AWS\M2\MicroFocus\Utilities\scripts
Configure o tempo de execução do M2DFUTIL ou da AWS modernização do mainframe na Amazon (incluindo 2.0) EC2 AppStream
Configure sua região do Enterprise Server com o seguinte:
-
Adicione as seguintes variáveis em [ES-Environment]:
-
M2DFUTILS_BASE_LOC: o local padrão para a saída DUMP -
M2DFUTILS_SCRIPTPATH: o local do scriptcompare.shdocumentado em Locais dos ativos -
M2DFUTILS_VERBOSE: [VERBOSO ou NORMAL]. Isso controla o nível de detalhe na saídaSYSPRINT
-
-
Verificar se o caminho do módulo de carregamento foi adicionado à configuração
JES\Configuration\JES Program Path -
Verifique se os scripts no diretório de utilitários têm permissões de execução. É possível adicionar uma permissão de execução usando o comando
chmod + x <script name>, no ambiente Linux
Sintaxe geral
DUMP
Fornece a possibilidade de copiar arquivos do local catalogado atual para um local de backup. No momento, esse local deve ser um sistema de arquivos.
Processo
DUMP executará o seguinte:
-
Crie o diretório do local de destino.
-
Catalogue o diretório do local de destino como membro do PDS.
-
Determine os arquivos a serem incluídos processando o parâmetro INCLUDE.
-
Desmarque os arquivos incluídos processando o parâmetro EXCLUDE.
-
Determine se os arquivos que estão sendo despejados devem ser EXCLUÍDOS.
-
Coloque em fila os arquivos a serem processados.
-
Copie os arquivos.
-
Exporte as informações do DCB catalogadas dos arquivos copiados para um arquivo secundário no local de destino para auxiliar nas futuras operações de RESTORE.
Sintaxe
DUMP
TARGET ( TARGET LOCATION ) -
INCLUDE ( DSN. )
[ EXCLUDE ( DSN ) ]
[ CANCEL | IGNORE ]
[ DELETE ]Parâmetros necessários
Veja abaixo os parâmetros necessários para DUMP:
-
SYSPRINT DD NAME: para conter as informações adicionais de registro -
TARGET: local de destino Pode ser um ou outro.-
Caminho completo do local de despejo
-
Nome do subdiretório criado no local definido na variável M2DFUTILS_BASE_LOC
-
-
INCLUDE: um único DSNAME nomeado ou uma string de pesquisa de DSN do mainframe válida -
EXCLUDE: um único DSNAME nomeado ou uma string de pesquisa de DSN do mainframe válida
Parâmetros opcionais
-
CANCEL: cancele se ocorrer algum erro. Os arquivos que foram processados serão retidos
-
(Padrão) IGNORE: ignore qualquer erro e processo até o final
-
DELETE: se nenhum erro ENQ ocorrer, o arquivo será excluído e não será catalogado
DELETE
Oferece a possibilidade de excluir e não catalogar arquivos em massa. Os arquivos não têm backup.
Processo
DELETE executará o seguinte:
-
Determine os arquivos a serem incluídos processando o parâmetro INCLUDE.
-
Desmarque os arquivos incluídos processando o parâmetro EXCLUDE.
-
Coloque em fila os arquivos a serem processados. Definindo a disposição como OLD, DELETE, KEEP.
Sintaxe
DELETE
INCLUDE ( DSN )
[ EXCLUDE ( DSN ) ]
[ CANCEL | IGNORE ]
[ DELETE ]Parâmetros necessários
Veja abaixo os parâmetros necessários para DELETE:
-
SYSPRINT DD NAME: para conter as informações adicionais de registro -
INCLUDE: um único DSNAME nomeado ou uma string de pesquisa de DSN do mainframe válida -
EXCLUDE: um único DSNAME nomeado ou uma string de pesquisa de DSN do mainframe válida
Parâmetros opcionais
-
CANCEL: cancele se ocorrer algum erro. Os arquivos que foram processados serão retidos
-
(Padrão) IGNORE: ignore qualquer erro e processo até o final
RESTORE
Fornece a possibilidade de restaurar arquivos que tiveram backup previamente DUMP. Os arquivos são restaurados no local catalogado original, a menos que RENAME seja usado para alterar o DSNAME restaurado.
Processo
RESTORE executará o seguinte:
-
Valide o diretório do local de origem.
-
Determine os arquivos a serem incluídos processando o arquivo de exportação do catálogo.
-
Desmarque os arquivos incluídos processando o parâmetro EXCLUDE.
-
Coloque em fila os arquivos a serem processados.
-
Arquivos de catálogo que não são catalogados com base em suas informações de exportação.
-
Se um arquivo já estiver catalogado e as informações do catálogo de exportação forem as mesmas, RESTORE substituirá o conjunto de dados catalogado se a opção REPLACE estiver definida.
Sintaxe
RESTORE
SOURCE ( TARGET LOCATION )
INCLUDE ( DSN )
[ EXCLUDE ( DSN ) ]
[ CANCEL | IGNORE ]
[ REPLACE]Parâmetros necessários
Veja abaixo os parâmetros necessários para RESTORE:
-
SYSPRINT DD NAME: para conter as informações adicionais de registro -
SOURCE: local de origem. Pode ser um ou outro.-
Caminho completo do local de despejo
-
Nome do subdiretório criado no local definido na variável M2DFUTILS_BASE_LOC
-
-
INCLUDE: um único DSNAME nomeado ou uma string de pesquisa de DSN do mainframe válida -
EXCLUDE: um único DSNAME nomeado ou uma string de pesquisa de DSN do mainframe válida
Parâmetros opcionais
-
CANCEL: cancele se houver algum erro. Arquivos processados retidos
-
(Padrão) IGNORE: ignore qualquer erro e processo até o final
-
REPLACE: se o arquivo que está sendo restaurado já estiver catalogado e os registros do catálogo forem os mesmos, substitua o arquivo catalogado
Amostra JCLs
Trabalho de DUMP
Esse trabalho criará um subdiretório chamado TESTDUMP. Esse é o local de backup padrão especificado pela variável M2DFUTILS_BASE_LOC. Ele criará uma biblioteca PDS para esse backup chamada M2DFUTILS.TESTDUMP. Os dados do catálogo exportado são armazenados em um arquivo sequencial de linhas no diretório de backup chamado CATDUMP.DAT. Todos os arquivos selecionados serão copiados para esse diretório de backup.
//M2DFDMP JOB 'M2DFDMP',CLASS=A,MSGCLASS=X
//STEP001 EXEC PGM=M2DFUTIL
//SYSPRINT DD DSN=TESTDUMP.SYSPRINT,
// DISP=(NEW,CATLG,DELETE),
// DCB=(RECFM=LSEQ,LRECL=256)
//SYSIN DD *
DUMP TARGET(TESTDUMP) -
INCLUDE(TEST.FB.FILE*.ABC) -
CANCEL
/*
//Trabalho DELETE
Esse trabalho excluirá todos os arquivos do catálogo que correspondam ao parâmetro INCLUDE.
/M2DFDEL JOB 'M2DFDEL',CLASS=A,MSGCLASS=X
//STEP001 EXEC PGM=M2DFUTIL
//SYSPRINT DD DSN=TESTDEL.SYSPRINT,
// DISP=(NEW,CATLG,DELETE),
// DCB=(RECFM=LSEQ,LRECL=256)
//SYSPRINT DD SYSOUT=A
//SYSIN DD *
DELETE -
INCLUDE(TEST.FB.FILE*.ABC) -
CANCEL
/*
//Trabalho RESTORE
Esse trabalho restaurará os arquivos que correspondem ao parâmetro INCLUDE do local de backup de TESTDUMP. Os arquivos catalogados serão substituídos se o arquivo catalogado for o mesmo da exportação de CATDUMP e a opção REPLACE for especificada.
//M2DFREST JOB 'M2DFREST',CLASS=A,MSGCLASS=X
//STEP001 EXEC PGM=M2DFUTIL
////SYSPRINT DD DSN=TESTREST.SYSPRINT,
// DISP=(NEW,CATLG,DELETE),
// DCB=(RECFM=LSEQ,LRECL=256)
//SYSPRINT DD SYSOUT=A
//SYSIN DD *
RESTORE SOURCE(TESTDUMP) -
INCLUDE(TEST.FB.FILE*.ABC) -
IGNORE
REPLACE
/*
//