AWS Le service de modernisation du mainframe (expérience de l'environnement d'exécution géré) n'est plus ouvert aux nouveaux clients. Pour des fonctionnalités similaires au service de modernisation AWS du mainframe (expérience de l'environnement d'exécution géré), explorez le service de modernisation AWS du mainframe (expérience autogérée). Les clients existants peuvent continuer à utiliser le service normalement. Pour plus d'informations, consultez la section Modification de la disponibilité de la modernisation du AWS mainframe.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

utilitaires de base de données

Cette section concerne les utilitaires liés aux bases de données. Sur les plateformes existantes, ces programmes fonctionnent généralement sur des DB2 bases de données, tandis que des bases de données alternatives sont choisies (AWS Aurora étant un choix populaire) dans les environnements modernes.

DSNTEP2/DSNTEP4

DSNTEP2/DSNTEP4 Objectif

L'utilitaire DNSTEP exécute des requêtes SQL à partir de jeux de données en entrée et écrit les résultats dans des ensembles de données en sortie. Il réécrit automatiquement les requêtes SQL existantes pour les bases de données cibles modernisées (au-delà DB2) et prend en charge plusieurs types de jeux de SYSIN données : flux, ensembles de données Blusam, fichiers plats, générations GDG et concaténations d'ensembles de données.

DSNTEP2/DSNTEP4 Signature

L'utilitaire ne prend aucun argument et utilise deux ensembles de données :

DSNTEP2/paramètres de configuration DSNTEP4 associés

Le comportement de l'utilitaire est influencé par les paramètres de configuration suivants :

Consultez Propriétés disponibles pour les applications Web facultatives pour plus de détails sur la configuration de ces paramètres.

DSNTEP2/DSNTEP4 Contrôles/Gestion des erreurs

DSNTEP2/DSNTEP4 Exemples d'utilisations

Voici un exemple d'utilisation JCL de DNSTEP4 :

//********************************************************************
//* RETRIEVE DATA FROM TABLE AP_JBI7_INVOICE                      *
//********************************************************************
//*
//DSNTEP03 EXEC PGM=DSNTEP4,DYNAMNBR=20
//SYSPRINT DD DSN=output(out012.txt),
//            DISP=SHR,DCB=(RECFM=FB,LRECL=1152)
//SYSIN    DD *
  SELECT * FROM BUR000.AP_JBI7_INVOICE WITH UR;

et l'extrait de script groovy modernisé correspondant :

def stepDSNTEP03(Object shell, Map params, Map programResults){
    shell.with {
        if (checkValidProgramResults(programResults)) {
            return execStep("DSNTEP03", "DSNTEP4", programResults, {
                    mpr
                        .withFileConfigurations(new FileConfigurationUtils()
                        .withJobContext(jobContext)
                        .fileSystem("SYSPRINT")
                        .path("output(out012.txt)").recordSize(1152)
                        .disposition("SHR")
                        .build()
                        .fileSystem("SYSIN")
                        .stream(
"""  SELECT * FROM BUR000.AP_JBI7_INVOICE WITH UR;  
  """, getEncoding())
                        .build()
                        .getFileConfigurations(fcmap))
                        .withParameters(params)
                    .runProgram("DSNTEP4")
                })
        }
    }
}

Notez que la requête SQL est fournie « telle quelle » à l'utilitaire DSNTEP2 /4, sans aucune modification.

DSNUTILB

Objectif du DSNUTILB

Utilitaire de base de données pour le chargement, la copie et la gestion des données. Fonctionne généralement sur des DB2 bases de données existantes ; la version modernisée prend en charge AWS Aurora et d'autres bases de données cibles.

Signature DSNUTILB

Par nature, DSNUTILB est plutôt destiné à être appelé par des scripts de travail modernisés.

Ne prend aucun argument ; lit les commandes depuis l'SYSINensemble de données.

Les commandes prises en charge sont les suivantes :

Pour plus de détails sur les commandes, veuillez consulter la documentation existante correspondante.

Paramètres de configuration associés à DSNUTILB

Le comportement de l'utilitaire est influencé par les paramètres de configuration suivants :

Consultez Propriétés disponibles pour les applications Web facultatives pour plus de détails sur la configuration de ces paramètres.

Contrôles DSNUTILB/Gestion des erreurs

Exemples d'utilisations de DSNUTILB

Voici un exemple d'utilisation de DSNUTILB dans un script JCL :

//********************************************************************
//* LOAD DATA IN TABLE AP_JBI7_INVOICE.                           *
//********************************************************************
//DSN01  EXEC PGM=DSNUTILB,DYNAMNBR=20
//SYSREC DD  DSN=input(input021.data),
//           DISP=SHR
//           DCB=(RECFM=FB,LRECL=76)
//SYSIN  DD  DSN=input(dsn01.card),
//           DISP=SHR

avec le contenu de la carte de commandes (dsn01.card) -- utilisé pour charger des données dans la base de données, à partir d'un fichier plat exporté depuis l'ancienne plateforme -- :

  LOAD         DATA 
               INDDN         SYSREC
               RESUME        NO
               LOG           YES
               NOCOPYPEND
               SORTDEVT      SYSDA
               SORTNUM       12
               SORTKEYS      100000
               DISCARDS      0
               INTO TABLE    BUR000.AP_JB17_INVOICE
               WHEN (76:76) = 'L'
 ( IDENTIFIER        POSITION(1:1)        SMALLINT
  ,CUST_ID           POSITION(10)         VARCHAR
                                          NULLIF(39) = '?'
  ,CUST_KD           POSITION(40:43)      CHAR 
  ,INVC_AMNT         POSITION(44:49)      NUMERIC
  ,INVC_DAT          POSITION(50:75)      TIMESTAMP EXTERNAL(26)
 )

et l'extrait de script modernisé groovy correspondant :

// STEP DSN01 - PGM - DSNUTILB****************************************************
def stepDSN01(Object shell, Map params, Map programResults){
    shell.with {
        if (checkValidProgramResults(programResults)) {
            return execStep("DSN01", "DSNUTILB", programResults, {
                mpr
                    .withFileConfigurations(new FileConfigurationUtils()
                        .withJobContext(jobContext)
                        .fileSystem("SYSREC")
                        .path("input(input021.data)").recordSize(76)
                        .disposition("SHR")
                        .build()
                        .fileSystem("SYSIN")
                        .path("input(dsn01.card)")
                        .disposition("SHR")
                        .build()
                        .getFileConfigurations(fcmap))
                    .withParameters(params)
                    .runProgram("DSNUTILB")
                    })
            }
    }
}

INFUTILB/ INZUTILB

Objectif d'INFUTILB

INFUTILB/INZUTILB sont des programmes utilitaires utilisés pour extraire des données de bases de données (décharger) (dans un environnement existant) et DB2 les convertir en différents formats de sortie.

Les anciennes requêtes SQL sont automatiquement adaptées on-the-fly aux exigences des bases de données cibles modernes (moteurs pris en charge : PostgreSQL, Oracle et). DB2

Signature d'INUTILB/INZUTILB

Les alias de programme suivants peuvent être utilisés (et correspondent au nom des anciens utilitaires de tri correspondants) :

L'utilitaire ne prend aucun argument mais lit les commandes à exécuter à partir de l'SYSINensemble de données (une « carte de contrôle »). Les enregistrements extraits de la base de données sont écrits dans l'SYSRECensemble de données et l'ensemble de SYSPUNCH données facultatif est utilisé pour stocker la carte de contrôle qui peut être utilisée pour recharger les données (à l'aide d'autres utilitaires, par DSNUTILB exemple).

Par nature, INFUTILB/INZUTILB ils sont principalement destinés à être appelés par des scripts de travail modernisés.

Pour en savoir plus sur les commandes prises en charge, reportez-vous à la documentation existante appropriée. Ils INFUTILB/INZUTILB utilisent les anciens ensembles de données « cartes de contrôle » « tels quels ».

Paramètres de configuration associés à INFUTILB/INZUTILB

Le comportement de l'utilitaire est influencé par les paramètres de configuration suivants :

Consultez Propriétés disponibles pour les applications Web facultatives pour plus de détails sur la configuration de ces paramètres.

INFUTILB/ Contrôles INZUTILB/Gestion des erreurs

Exemples d'utilisations d'INFUTILB/INZUTILB

Voici un exemple d'extrait de script JCL existant :

//********************************************************************
//* UNLOAD DATA FROM TABLE AP_JBI7_INVOICE.                       *
//********************************************************************
//INF1   EXEC PGM=INFUTILB
//SYSREC DD  DSN=output(out032.data),
//           DISP=SHR
//           DCB=(RECFM=FB,LRECL=90)
//SYSIN  DD  DSN=input(inf12.card),
//           DISP=SHR

qui utilise la carte de commandes suivante (inf12.card) pour décharger certaines données de la base de données (ici, les enregistrements sont sélectionnés en fonction de leur date) :

  UNLOAD                                                                        
      SELECT * FROM BUR000.AP_JB17_INVOICE                                  
      WHERE INVC_DAT >= 
      CONCAT(STRIP(CHAR(YEAR(CURRENT DATE - 100 YEAR))),'-01-01-00.00.00.000000')
      AND INVC_DAT >= 
      CONCAT('2025-01-01-',CONCAT((CURRENT TIME),'.000000'))
      AND INVC_DAT >= (CURRENT TIMESTAMP - 100 YEAR)
      ORDER BY identifier ASC                                                          
        OUTDDN (SYSREC)                                                         
        FORMAT DSNTIAUL

et l'extrait de script groovy correspondant, résultat de la modernisation automatique de JCL :

// STEP INF1 - PGM - INFUTILB*****************************************************
def stepINF1(Object shell, Map params, Map programResults){
    shell.with {
        if (checkValidProgramResults(programResults)) {
            return execStep("INF1", "INFUTILB", programResults, {
                mpr
                    .withFileConfigurations(new FileConfigurationUtils()
                        .withJobContext(jobContext)
                        .fileSystem("SYSREC")
                        .path("output(out032.data)").recordSize(90)
                        .disposition("SHR")
                        .build()
                        .fileSystem("SYSIN")
                        .path("input(inf12.card)")
                        .disposition("SHR")
                        .build()
                        .getFileConfigurations(fcmap))
                    .withParameters(params)
                    .runProgram("INFUTILB")
                })
        }
    }
}

JXHDBCLR

Objectif du JXHDBCLR

JXHDBCLR est un utilitaire de suppression de base de données, présent sur les GS21 plateformes, qui tronque les tables en fonction des instructions spécifiques fournies dans une carte de commandes.

Signature JXHDBCLR

Il ne prend aucun argument mais lit les instructions de l'SYSINensemble de données (la carte de commandes).

En raison de sa nature, il est principalement destiné à être appelé par des scripts de tâches modernisés.

paramètres de configuration associés à JXHDBCLR

Le comportement de l'utilitaire est influencé par les paramètres de configuration suivants :

Consultez Propriétés disponibles pour les applications Web facultatives pour plus de détails sur la configuration de ces paramètres.

Vérifications JXHDBCLR//Gestion des erreurs

Si aucune table à tronquer n'est trouvée, un message d'avertissement sera enregistré, mais l'exécution du programme ne sera pas interrompue.

En cas d'échec lors de la troncature des tables, le code de retour du programme sera défini sur 4, les messages d'erreur seront enregistrés, mais l'exécution du programme ne sera pas interrompue.

Pour l'une des conditions suivantes, le code de retour du programme sera défini sur 8 et un AbendException sera émis (arrêt de l'exécution du programme) :

Exemples d'utilisations du JXHDBCLR

Exemple d'utilisation de JXHDBCLR avec une carte de commandes intégrée :

//*******************************************************************
//**  Step 1 - JXHDBCLR UTILITY - DBCLEAR TYPE=2/3
//*******************************************************************
//STEP01  EXEC PGM=JXHDBCLR,REGION=256K,PARM='LINECNT=0'
//SYSPRINT DD SYSOUT=*
//SYSIN    DD *
    DBCLEAR    SCHEMA=MUSICSCH,TYPE=3,CHECK=YES
    DEFINE     RANGE=(SINGERDEST)
END

et l'extrait de script groovy modernisé correspondant :

// STEP STEP01 - PGM - JXHDBCLR***************************************************
def stepSTEP01(Object shell, Map params, Map programResults){
 shell.with {
        if (checkValidProgramResults(programResults)) {
            return execStep("STEP01", "JXHDBCLR", programResults, {
                mpr
                    .withFileConfigurations(new FileConfigurationUtils()
                        .withJobContext(jobContext)
                        .systemOut("SYSPRINT")
                        .output("*")
                        .build()
                        .fileSystem("SYSIN")
                        .stream(
"""    DBCLEAR    SCHEMA=MUSICSCH,TYPE=3,CHECK=YES
    DEFINE     RANGE=(SINGER)
END""", getEncoding())
                        .build()
                        .getFileConfigurations())
                    .withArguments(getParm("LINECNT=0"))
                    .withParameters(params)
                    .runProgram("JXHDBCLR")
                })
        }
    }
}

La carte intégrée de Legacy est conservée « telle quelle », à l'aide d'un stream.