AWS O Mainframe Modernization Service (experiência em Managed Runtime Environment) não está mais aberto a novos clientes. Para recursos semelhantes ao AWS Mainframe Modernization Service (experiência em Managed Runtime Environment), explore o AWS Mainframe Modernization Service (experiência autogerenciada). Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte Alteração na [disponibilidade AWS da modernização do mainframe](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html).

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á.

# Utilitário em lote M2DFUTIL
<a name="m2dfutil"></a>

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.

**Topics**
+ [

## Plataformas compatíveis
](#m2dfutil-platforms)
+ [

## Requisitos da plataforma
](#m2dfutil-platform)
+ [

## Suporte futuro planejado
](#m2udfutil-future-support)
+ [

## Locais dos ativos
](#mdfutil-assets)
+ [

## Configure o tempo de execução do M2DFUTIL ou da modernização do AWS mainframe no Amazon EC2 (incluindo 2.0) AppStream
](#mdfutil-dependencies)
+ [

## Sintaxe geral
](#mdfutil-syntax)
+ [

## Amostra JCLs
](#mdfutil-sample-jcls)

## Plataformas compatíveis
<a name="m2dfutil-platforms"></a>

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
<a name="m2dfutil-platform"></a>

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
<a name="m2udfutil-future-support"></a>

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
<a name="mdfutil-assets"></a>

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 modernização do AWS mainframe no Amazon EC2 (incluindo 2.0) AppStream
<a name="mdfutil-dependencies"></a>

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 script `compare.sh` documentado em **Locais dos ativos**
  + `M2DFUTILS_VERBOSE`: [VERBOSO ou NORMAL]. Isso controla o nível de detalhe na saída `SYSPRINT `
+ 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
<a name="mdfutil-syntax"></a>

### DUMP
<a name="mdfutil-dump"></a>

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
<a name="mdfutil-dump-process"></a>

DUMP executará o seguinte:

1. Crie o diretório do local de destino.

1. Catalogue o diretório do local de destino como membro do PDS.

1. Determine os arquivos a serem incluídos processando o parâmetro INCLUDE.

1. Desmarque os arquivos incluídos processando o parâmetro EXCLUDE.

1. Determine se os arquivos que estão sendo despejados devem ser EXCLUÍDOS.

1. Coloque em fila os arquivos a serem processados.

1. Copie os arquivos.

1. 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
<a name="mdfutil-dump-syntax"></a>

```
DUMP
TARGET ( TARGET LOCATION  )    -
INCLUDE ( DSN. )
[ EXCLUDE ( DSN ) ]
[ CANCEL | IGNORE ]
[ DELETE ]
```

#### Parâmetros necessários
<a name="mdfutil-dump-requiredparam"></a>

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\$1BASE\$1LOC**
+ `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
<a name="mdfutil-dump-optionalparam"></a>
+ 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
<a name="mdfutil-delete"></a>

Oferece a possibilidade de excluir e não catalogar arquivos em massa. Os arquivos não têm backup.

#### Processo
<a name="mdfutil-delete-process"></a>

DELETE executará o seguinte:

1. Determine os arquivos a serem incluídos processando o parâmetro INCLUDE.

1. Desmarque os arquivos incluídos processando o parâmetro EXCLUDE.

1. Coloque em fila os arquivos a serem processados. Definindo a disposição como OLD, DELETE, KEEP.

#### Sintaxe
<a name="mdfutil-delete-syntax"></a>

```
DELETE
INCLUDE ( DSN )
[ EXCLUDE ( DSN ) ]
[ CANCEL | IGNORE ]
[ DELETE ]
```

#### Parâmetros necessários
<a name="mdfutil-delete-requiredparam"></a>

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
<a name="mdfutil-delete-optionalparam"></a>
+ 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
<a name="mdfutil-restore"></a>

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
<a name="mdfutil-restore-process"></a>

RESTORE executará o seguinte:

1. Valide o diretório do local de origem.

1. Determine os arquivos a serem incluídos processando o arquivo de exportação do catálogo.

1. Desmarque os arquivos incluídos processando o parâmetro EXCLUDE.

1. Coloque em fila os arquivos a serem processados.

1. Arquivos de catálogo que não são catalogados com base em suas informações de exportação.

1. 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
<a name="mdfutil-restore-syntax"></a>

```
RESTORE
SOURCE ( TARGET LOCATION ) 
INCLUDE ( DSN )
[ EXCLUDE ( DSN ) ]
[ CANCEL | IGNORE ]
[ REPLACE]
```

#### Parâmetros necessários
<a name="mdfutil-restore-requiredparam"></a>

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\$1BASE\$1LOC**
+ `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
<a name="mdfutil-restore-optionalparam"></a>
+ 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
<a name="mdfutil-sample-jcls"></a>

 **Trabalho de DUMP**

Esse trabalho criará um subdiretório chamado `TESTDUMP`. Esse é o local de backup padrão especificado pela variável **M2DFUTILS\$1BASE\$1LOC**. 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
/*
//
```