AWS El servicio de modernización de mainframes (experiencia en entornos de ejecución gestionados) ya no está abierto a nuevos clientes. Para obtener prestaciones similares a las del Servicio de Modernización de AWS Mainframe (experiencia en entornos de ejecución gestionados), explore el Servicio de Modernización de AWS Mainframe (experiencia autogestionada). Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte Cambio en la disponibilidad de la modernización del [AWS mainframe.](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Utilidad por lotes M2DFUTIL
<a name="m2dfutil"></a>

M2DFUTIL es un programa de utilidad de JCL que proporciona funciones de copia de seguridad, restauración, eliminación y copia en conjuntos de datos, de forma similar al soporte que proporciona la utilidad ADRDSSU del mainframe. Este programa conserva muchos de los parámetros SYSIN de ADRDSSU, lo que agiliza el proceso de migración a esta nueva utilidad.

**Topics**
+ [Plataformas admitidas](#m2dfutil-platforms)
+ [Requisitos de la plataforma](#m2dfutil-platform)
+ [Compatibilidad futura planificada](#m2udfutil-future-support)
+ [Ubicaciones de los activos](#mdfutil-assets)
+ [Configurar M2DFUTIL o el tiempo de ejecución de modernización de AWS mainframe en Amazon EC2 (incluida la versión 2.0) AppStream](#mdfutil-dependencies)
+ [Sintaxis general](#mdfutil-syntax)
+ [Ejemplo JCLs](#mdfutil-sample-jcls)

## Plataformas admitidas
<a name="m2dfutil-platforms"></a>

Puede utilizar M2DFUTIL en cualquiera de las siguientes plataformas:
+ Rocket Software (anteriormente Micro Focus) ES en Windows (64 y 32 bits)
+ Rocket Software ES en Linux (64 bits)

## Requisitos de la plataforma
<a name="m2dfutil-platform"></a>

M2DFUTIL depende de llamar a un script para realizar una prueba de expresión regular. En Windows, debe instalar los Windows Services for Linux (WSL) para que se ejecute este script.

## Compatibilidad futura planificada
<a name="m2udfutil-future-support"></a>

Entre las funciones que actualmente no están disponibles en la utilidad ADRDSSU del mainframe, pero que estarán disponibles en el futuro, se incluyen: 
+ M2 administrado
+ VSAM
+ Compatibilidad con COPY para cambiar el nombre de los archivos
+ Compatibilidad con RENAME para RESTORE 
+ Múltiples INCLUDE y EXCLUDE
+ Cláusula BY para la subselección mediante DSORG, CREDT, EXPDT
+ Cláusula MWAIT para reintentar errores en la cola
+ Compatibilidad con el almacenamiento de S3 para DUMP/RESTORE

## Ubicaciones de los activos
<a name="mdfutil-assets"></a>

El módulo de carga de esta utilidad se llama `M2DFUTIL.so` en Linux y `M2DFUTIL.dll` en Windows. Este módulo de carga se puede encontrar en las siguientes ubicaciones:
+ Linux: `/opt/aws/m2/microfocus/utilities/64bit`
+ Windows de 32 bits: `C:\AWS\M2\MicroFocus\Utilities\32bit`
+ Windows de 64 bits: `C:\AWS\M2\MicroFocus\Utilities\64bit`

El script utilizado para las pruebas de expresiones regulares se llama `compare.sh`. Este script se puede encontrar en las siguientes ubicaciones:
+ Linux: `/opt/aws/m2/microfocus/utilities/scripts`
+ Windows de 32 bits: `C:\AWS\M2\MicroFocus\Utilities\scripts`

## Configurar M2DFUTIL o el tiempo de ejecución de modernización de AWS mainframe en Amazon EC2 (incluida la versión 2.0) AppStream
<a name="mdfutil-dependencies"></a>

Configure su región de Enterprise Server con lo siguiente:
+ Agregue las siguientes variables en **[ES-Environment]**
  + `M2DFUTILS_BASE_LOC`: la ubicación predeterminada para la salida de DUMP
  + `M2DFUTILS_SCRIPTPATH`: la ubicación del script `compare.sh` documentada en **Ubicaciones de activos**
  + `M2DFUTILS_VERBOSE`: [DETALLADO o NORMAL]. Esto controla el nivel de detalle de la salida `SYSPRINT `
+ Compruebe que la ruta del módulo de carga se haya agregado a la configuración de `JES\Configuration\JES Program Path`
+ Compruebe que los scripts del directorio de utilidades tengan permisos de ejecución. Puede agregar un permiso de ejecución mediante el comando `chmod + x <script name>`, en el entorno de Linux

## Sintaxis general
<a name="mdfutil-syntax"></a>

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

Ofrece la posibilidad de copiar archivos desde la ubicación catalogada actual a una ubicación de copia de seguridad. Actualmente, esta ubicación debe ser un sistema de archivos.

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

DUMP realizará las siguientes tareas:

1. Crear el directorio de ubicaciones de destino.

1. Catalogar el directorio de ubicaciones de destino como miembro del PDS.

1. Determinar los archivos que se van a incluir procesando el parámetro INCLUDE.

1. Anular la selección de los archivos incluidos procesando el parámetro EXCLUDE.

1. Determinar si los archivos que se van a volcar deben eliminarse con DELETED.

1. Colocar en la cola los archivos que se procesarán.

1. Copiar los archivos.

1. Exportar la información DCB catalogada de los archivos copiados a un archivo lateral en la ubicación de destino para facilitar las futuras operaciones de RESTORE.

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

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

#### Parámetros necesarios
<a name="mdfutil-dump-requiredparam"></a>

A continuación se enumeran los parámetros necesarios para el DUMP:
+ `SYSPRINT DD NAME`: para contener información de registro adicional
+ `TARGET`: ubicación de destino. Puede ser alguno de los siguientes:
  + Ruta completa de la ubicación del volcado
  + Nombre del subdirectorio creado en la ubicación definida en la variable **M2DFUTILS\$1BASE\$1LOC**
+ `INCLUDE`: una cadena de búsqueda DSNAME única con nombre o una cadena de búsqueda DSN de mainframe válida
+ `EXCLUDE`: una cadena de búsqueda DSNAME única con nombre o una cadena de búsqueda DSN de mainframe válida

#### Parámetros opcionales
<a name="mdfutil-dump-optionalparam"></a>
+ CANCEL: se cancela si se produce algún error. Los archivos que se procesaron se conservarán
+ (Predeterminado) IGNORE: ignora cualquier error y proceso hasta el final
+ DELETE: si no se produce ningún error de ENQ, el archivo se elimina y no se cataloga

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

Ofrece la posibilidad de eliminar y descatalogar archivos de forma masiva. No se hace una copia de seguridad de los archivos.

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

DELETE realizará las siguientes tareas:

1. Determinar los archivos que se van a incluir procesando el parámetro INCLUDE.

1. Anular la selección de los archivos incluidos procesando el parámetro EXCLUDE.

1. Colocar en la cola los archivos que se procesarán. Establecer la disposición como OLD, DELETE, KEEP.

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

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

#### Parámetros necesarios
<a name="mdfutil-delete-requiredparam"></a>

A continuación aparecen los parámetros necesarios para DELETE:
+ `SYSPRINT DD NAME`: para contener información de registro adicional
+ `INCLUDE`: una cadena de búsqueda DSNAME única con nombre o una cadena de búsqueda DSN de mainframe válida 
+ `EXCLUDE`: una cadena de búsqueda DSNAME única con nombre o una cadena de búsqueda DSN de mainframe válida 

#### Parámetros opcionales
<a name="mdfutil-delete-optionalparam"></a>
+ CANCEL: se cancela si se produce algún error. Los archivos que se procesen se conservarán 
+ (Predeterminado) IGNORE: ignora cualquier error y proceso hasta el final

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

Ofrece la posibilidad de restaurar archivos de los que se haya hecho una copia de seguridad previa mediante DUMP. Los archivos se restauran en la ubicación catalogada original, a menos que se utilice RENAME para modificar el DSNAME restaurado.

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

RESTORE realizará las siguientes tareas:

1. Valide el directorio de ubicaciones de origen.

1. Determine los archivos que se van a incluir procesando el archivo de exportación del catálogo.

1. Anular la selección de los archivos incluidos procesando el parámetro EXCLUDE.

1. Colocar en la cola los archivos que se procesarán.

1. Archivos de catálogo que no están catalogados en función de su información de exportación.

1. Si un archivo ya está catalogado y la información del catálogo de exportación es la misma, RESTORE reemplazará el conjunto de datos catalogado si se ha activado la opción REPLACE.

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

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

#### Parámetros necesarios
<a name="mdfutil-restore-requiredparam"></a>

Los siguientes son los parámetros necesarios para RESTORE:
+ `SYSPRINT DD NAME`: para contener información de registro adicional 
+ `SOURCE`: ubicación del origen. Puede ser alguno de los siguientes:
  + Ruta completa de la ubicación del volcado
  + Nombre del subdirectorio creado en la ubicación definida en la variable **M2DFUTILS\$1BASE\$1LOC**
+ `INCLUDE`: una cadena de búsqueda DSNAME única con nombre o una cadena de búsqueda DSN de mainframe válida
+ `EXCLUDE`: una cadena de búsqueda DSNAME única con nombre o una cadena de búsqueda DSN de mainframe válida

#### Parámetros opcionales
<a name="mdfutil-restore-optionalparam"></a>
+ CANCEL: se cancela si hay algún error. Archivos procesados retenidos
+ (Predeterminado) IGNORE: ignora cualquier error y proceso hasta el final
+ REPLACE: si el archivo que se está restaurando ya está catalogado y los registros del catálogo son los mismos, sustituye el archivo catalogado

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

 **Trabajo DUMP**

Este trabajo creará un subdirectorio llamado `TESTDUMP`. Esta es la ubicación de copia de seguridad predeterminada especificada por la variable **M2DFUTILS\$1BASE\$1LOC**. Creará una biblioteca PDS para esta copia de seguridad llamada `M2DFUTILS.TESTDUMP`. Los datos del catálogo exportados se almacenan en un archivo secuencial de líneas en el directorio de copias de seguridad denominado `CATDUMP.DAT`. Todos los archivos seleccionados se copiarán en este directorio de copia de seguridad.

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

 **Trabajo DELETE**

Este trabajo eliminará todos los archivos del catálogo que coincidan con el 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
/*
 //
```

 **Trabajo RESTORE**

Este trabajo restaurará los archivos que coincidan con el parámetro INCLUDE desde la ubicación de la copia de seguridad de `TESTDUMP`. Los archivos catalogados se reemplazarán si el archivo catalogado es el mismo que el de la exportación a CATDUMP y se especifica la opción 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
/*
//
```