Utilità batch M2DFUTIL

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

Piattaforme supportate

È 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

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

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

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 regolaricompare.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 del AWS mainframe su Amazon EC2 (incluso il 2.0) AppStream

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 Pathimpostazione

• 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

DUMP

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

DUMP eseguirà le seguenti operazioni:

1. Crea la directory della posizione di destinazione.

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

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

4. Deseleziona i file inclusi elaborando il parametro EXCLUDE.

5. Determina se i file scaricati devono essere ELIMINATI.

6. Metti in coda i file da elaborare.

7. Copia i file.

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

Sintassi

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

Parametri obbligatori

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_BASE_LOC

• 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

• 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

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

Processo

DELETE eseguirà le seguenti operazioni:

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

2. Deseleziona i file inclusi elaborando il parametro EXCLUDE.

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

Sintassi

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

Parametri obbligatori

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

• ANNULLA - Annulla se si verifica un errore. I file elaborati verranno conservati

• (Impostazione predefinita) IGNORE: ignora qualsiasi errore e processo fino alla fine

RESTORE

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

RESTORE eseguirà le seguenti operazioni:

1. Convalida la directory di posizione di origine.

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

3. Deselezionate i file inclusi elaborando il parametro EXCLUDE.

4. Accoda i file da elaborare.

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

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

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

Parametri obbligatori

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_BASE_LOC

• 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

• 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

Lavoro DUMP

Questo lavoro creerà una sottodirectory chiamata. TESTDUMP Questa è la posizione di backup predefinita specificata dalla variabile M2DFUTILS_BASE_LOC. 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
/*
//