AWS Il servizio di modernizzazione del mainframe (esperienza Managed Runtime Environment) non è più aperto a nuovi clienti. Per funzionalità simili a AWS Mainframe Modernization Service (esperienza Managed Runtime Environment), esplora AWS Mainframe Modernization Service (Self-Managed Experience). I clienti esistenti possono continuare a utilizzare il servizio normalmente. [Per ulteriori informazioni, consulta AWS Modifica della disponibilità di Mainframe Modernization.](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Utilità batch M2DFUTIL
<a name="m2dfutil"></a>

M2DFUTIL è un programma di utilità JCL che fornisce funzioni di backup, ripristino, eliminazione e copia su set di dati, simili al supporto fornito dall'utilità ADRDSSU del mainframe. Questo programma mantiene molti dei parametri SYSIN di ADRDSSU, il che semplifica il processo di migrazione a questa nuova utilità.

**Topics**
+ [

## Piattaforme supportate
](#m2dfutil-platforms)
+ [

## Requisiti della piattaforma
](#m2dfutil-platform)
+ [

## Supporto futuro pianificato
](#m2udfutil-future-support)
+ [

## Ubicazioni degli asset
](#mdfutil-assets)
+ [

## Configura M2DFUTIL o il runtime di modernizzazione AWS del mainframe su Amazon EC2 (incluso 2.0) AppStream
](#mdfutil-dependencies)
+ [

## Sintassi generale
](#mdfutil-syntax)
+ [

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

## Piattaforme supportate
<a name="m2dfutil-platforms"></a>

È possibile utilizzare M2DFUTIL su una delle seguenti piattaforme:
+ Rocket Software (precedentemente Micro Focus) ES su Windows (64 bit e 32 bit)
+ Rocket Software ES su Linux (64 bit)

## Requisiti della piattaforma
<a name="m2dfutil-platform"></a>

M2DFUTIL dipende dalla chiamata di uno script per eseguire un test di espressione regolare. In Windows, è necessario installare Windows Services for Linux (WSL) per eseguire questo script.

## Supporto futuro pianificato
<a name="m2udfutil-future-support"></a>

Le funzionalità che attualmente non sono disponibili nell'utilità ADRDSSU per mainframe, ma che rientrano nell'ambito futuro includono: 
+ M2 Managed
+ VSAM
+ Supporto COPY per la ridenominazione dei nomi dei file
+ Supporto RENAME per RESTORE 
+ INCLUDE ed ESCLUDE multipli
+ Clausola BY per la sottoselezione tramite DSORG, CREDT, EXPDT
+ Clausola MWAIT per ripetere gli errori di accodamento
+ Supporto di archiviazione S3 per DUMP/RESTORE

## Ubicazioni degli asset
<a name="mdfutil-assets"></a>

Il modulo di caricamento di questa utilità viene chiamato `M2DFUTIL.so` su Linux e `M2DFUTIL.dll` su Windows. Questo modulo di caricamento si trova nelle seguenti posizioni:
+ Linux: `/opt/aws/m2/microfocus/utilities/64bit`
+ Windows (32 bit): `C:\AWS\M2\MicroFocus\Utilities\32bit`
+ Windows (64 bit): `C:\AWS\M2\MicroFocus\Utilities\64bit`

Viene chiamato lo script utilizzato per il test delle espressioni regolari`compare.sh`. Questo script può essere trovato nelle seguenti posizioni:
+ Linux: `/opt/aws/m2/microfocus/utilities/scripts`
+ Windows (32 bit): `C:\AWS\M2\MicroFocus\Utilities\scripts`

## Configura M2DFUTIL o il runtime di modernizzazione AWS del mainframe su Amazon EC2 (incluso 2.0) AppStream
<a name="mdfutil-dependencies"></a>

Configura la tua regione Enterprise Server con quanto segue:
+ Aggiungere le seguenti variabili in **[ES-Environment**]
  + `M2DFUTILS_BASE_LOC`- La posizione predefinita per l'output DUMP
  + `M2DFUTILS_SCRIPTPATH`**- La posizione dello `compare.sh` script documentata in Asset Locations**
  + `M2DFUTILS_VERBOSE`- [VERBOSE o NORMAL]. Questo controlla il livello di dettaglio dell'output `SYSPRINT `
+ Verificate che il percorso del modulo di carico sia aggiunto all'`JES\Configuration\JES Program Path`impostazione
+ Verificate che gli script nella directory delle utilità dispongano delle autorizzazioni di esecuzione. È possibile aggiungere un'autorizzazione di esecuzione utilizzando il `chmod + x <script name>` comando, nell'ambiente Linux

## Sintassi generale
<a name="mdfutil-syntax"></a>

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

Offre la possibilità di copiare i file dall'attuale posizione catalogata a una posizione di backup. Attualmente questa posizione deve essere un file system.

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

DUMP eseguirà le seguenti operazioni:

1. Crea la directory della posizione di destinazione.

1. Cataloga la directory delle posizioni di destinazione come membro PDS.

1. Determinate i file da includere elaborando il parametro INCLUDE.

1. Deseleziona i file inclusi elaborando il parametro EXCLUDE.

1. Determina se i file scaricati devono essere ELIMINATI.

1. Metti in coda i file da elaborare.

1. Copia i file.

1. Esporta le informazioni DCB catalogate dei file copiati in un file laterale nella posizione di destinazione per facilitare le future operazioni di RESTORE.

#### Sintassi
<a name="mdfutil-dump-syntax"></a>

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

#### Parametri obbligatori
<a name="mdfutil-dump-requiredparam"></a>

Di seguito sono riportati i parametri richiesti per DUMP:
+ `SYSPRINT DD NAME`- Per contenere informazioni di registrazione aggiuntive
+ `TARGET`- Ubicazione dell'obiettivo. Può essere:
  + Percorso completo della posizione di scarico
  + **Nome della sottodirectory creato nella posizione definita nella variabile M2DFUTILS\$1BASE\$1LOC**
+ `INCLUDE`- Un singolo nome DSNAME o una stringa di ricerca DSN mainframe valida
+ `EXCLUDE`- Un solo nome DSNAME o una stringa di ricerca DSN mainframe valida

#### Parametri facoltativi
<a name="mdfutil-dump-optionalparam"></a>
+ ANNULLA - Annulla se si verifica un errore. I file che sono stati elaborati verranno conservati
+ (Impostazione predefinita) IGNORE: ignora qualsiasi errore e processo fino alla fine
+ ELIMINA: se non si verifica alcun errore ENQ, il file viene eliminato e non viene catalogato

### DELETE
<a name="mdfutil-delete"></a>

Offre la possibilità di eliminare e annullare la catalogazione in massa dei file. Non viene eseguito il backup dei file.

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

DELETE eseguirà le seguenti operazioni:

1. Determina i file da includere elaborando il parametro INCLUDE.

1. Deseleziona i file inclusi elaborando il parametro EXCLUDE.

1. Accoda i file da elaborare. Impostazione della disposizione su OLD, DELETE, KEEP.

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

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

#### Parametri obbligatori
<a name="mdfutil-delete-requiredparam"></a>

Di seguito sono riportati i parametri richiesti per DELETE:
+ `SYSPRINT DD NAME`- Per contenere informazioni di registrazione aggiuntive
+ `INCLUDE`- Un singolo nome DSNAME o una stringa di ricerca DSN mainframe valida 
+ `EXCLUDE`- Un solo nome DSNAME o una stringa di ricerca DSN mainframe valida 

#### Parametri facoltativi
<a name="mdfutil-delete-optionalparam"></a>
+ ANNULLA - Annulla se si verifica un errore. I file elaborati verranno conservati 
+ (Impostazione predefinita) IGNORE: ignora qualsiasi errore e processo fino alla fine

### RESTORE
<a name="mdfutil-restore"></a>

Offre la possibilità di ripristinare i file di cui è stato precedentemente eseguito il backup utilizzando DUMP. I file vengono ripristinati nella posizione originale catalogata a meno che non venga utilizzato RENAME per modificare il DSNAME ripristinato.

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

RESTORE eseguirà le seguenti operazioni:

1. Convalida la directory di posizione di origine.

1. Determinate i file da includere elaborando il file di esportazione del catalogo.

1. Deselezionate i file inclusi elaborando il parametro EXCLUDE.

1. Accoda i file da elaborare.

1. File di catalogo che non sono catalogati in base alle informazioni di esportazione.

1. Se un file è già catalogato e le informazioni del catalogo di esportazione sono le stesse, RESTORE sostituirà il set di dati catalogato se è impostata l'opzione REPLACE.

#### Sintassi
<a name="mdfutil-restore-syntax"></a>

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

#### Parametri obbligatori
<a name="mdfutil-restore-requiredparam"></a>

Di seguito sono riportati i parametri richiesti per RESTORE:
+ `SYSPRINT DD NAME`- Per contenere informazioni di registrazione aggiuntive 
+ `SOURCE`- Ubicazione della fonte. Può essere:
  + Percorso completo della posizione di scarico
  + **Nome della sottodirectory creato nella posizione definita nella variabile M2DFUTILS\$1BASE\$1LOC**
+ `INCLUDE`- Un singolo nome DSNAME o una stringa di ricerca DSN mainframe valida
+ `EXCLUDE`- Un solo nome DSNAME o una stringa di ricerca DSN mainframe valida

#### Parametri facoltativi
<a name="mdfutil-restore-optionalparam"></a>
+ ANNULLA - Annulla in caso di errore. I file elaborati vengono conservati
+ (Impostazione predefinita) IGNORE: ignora qualsiasi errore e processo fino alla fine
+ SOSTITUISCI: se il file da ripristinare è già catalogato e i record del catalogo sono gli stessi, sostituisci il file catalogato

## Esempio JCLs
<a name="mdfutil-sample-jcls"></a>

 **Lavoro DUMP**

Questo lavoro creerà una sottodirectory chiamata. `TESTDUMP` Questa è la posizione di backup predefinita specificata dalla variabile **M2DFUTILS\$1BASE\$1LOC**. Creerà una libreria PDS per questo backup chiamata. `M2DFUTILS.TESTDUMP` I dati del catalogo esportati vengono memorizzati in un file sequenziale di righe nella directory di backup denominata. `CATDUMP.DAT` Tutti i file selezionati verranno copiati in questa directory di 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
/*
//
```

 **CANCELLA il lavoro**

Questo processo eliminerà tutti i file dal catalogo che corrispondono al parametro 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
/*
 //
```

 **Processo RESTORE**

Questo processo ripristinerà i file che corrispondono al parametro INCLUDE dalla posizione `TESTDUMP` di backup. I file catalogati verranno sostituiti se il file catalogato è uguale a quello nell'esportazione CATDUMP e viene specificata l'opzione REPLACE.

```
//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
/*
//
```