View a markdown version of this page

Tutorial: Distribuisci l'applicazione su NTT DATA CardDemo - AWS Modernizzazione del mainframe

AWS L'esperienza autogestita di Mainframe Modernization non è più aperta a nuovi clienti. Per funzionalità simili all'esperienza autogestita di AWS Mainframe Modernization, esplora le funzionalità offerte direttamente dai fornitori e da. AWS Transform I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta Modifica della disponibilità di Mainframe Modernization. AWS

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

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 (Experience). Self-Managed I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta Modifica della disponibilità di AWS Mainframe Modernization.

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

Tutorial: Distribuisci l'applicazione su NTT DATA CardDemo

Questa pagina guida l'utente nella procedura dettagliata per la distribuzione dell'applicazione di CardDemo esempio sulla repiattaforma AWS Mainframe Modernization con runtime NTT DATA Unikix.

L'applicazione CardDemo di esempio è un'applicazione mainframe semplificata progettata e sviluppata per testare e mostrare la tecnologia e collaborare per i casi d'uso della migrazione e della modernizzazione del mainframe. AWS

Per ulteriori informazioni su questa applicazione, vedere, repository for. GitHub CardDemo

Diagramma del flusso di distribuzione

Il diagramma seguente mostra ogni fase del flusso di lavoro per la distribuzione di un'applicazione sul runtime NTT DATA Unikix.

Il flusso di lavoro complessivo di distribuzione dell'applicazione sul runtime NTT DATA Unikix.

Prerequisiti

Fase 1: Preparare l'ambiente

Dopo aver completato i prerequisiti, il primo passaggio consiste nel preparare l'ambiente in cui si desidera distribuire l' CardDemo applicazione.

  1. Accedere all'istanza EC2 in UniKix fase di esecuzione come. ec2-user

  2. Osserva l'elenco dei UniKix software preconfezionati all'interno dell'AMI, come TPE, BPE e COBOL, insieme ad altri software presenti nella posizione del UniKix prodotto NTT DATA utilizzando il seguente comando nell'istanza EC2:

    ls -l /opt/software/
  3. Esamina l'applicazione migrata. CardDemo Vedrai tutto il codice sorgente, comprese le mappe BMS, i programmi COBOL, i quaderni COBOL e i JCL. Puoi anche esportare i cataloghi BPE e TPE, le definizioni delle risorse CICS e i dati migrati come file sequenziali e file VSAM procedendo come segue:

    ls $HOME/migrated_app/*/*
  4. Crea una struttura di cartelle eseguendo lo script con il seguente comando: create_project

    sh $HOME/bin/create_project
  5. Attiva l' CardDemo ambiente reperendo il file di carddemo.env installazione utilizzando:

    source $HOME/bin/carddemo.env

Fase 2: Creare una regione TPE

Dopo aver attivato l'ambiente in cui si desidera distribuire l'applicazione, è necessario creare una regione TPE.

  1. Crea una regione TPE utilizzando il kixregion createRegion comando che richiede input come$KIXSYS, e. $JAVA_HOME $KIXLICDIR Queste variabili di ambiente sono già configurate nel file di carddemo.env configurazione.

    kixregion createRegion $KIXSYS $JAVA_HOME $KIXLICDIR
  2. Configurare la regione TPE utilizzando il kixregion setAttr comando.

    kixregion setAttr $KIXSYS server.tx.languages.cobol.enabled true kixregion setAttr $KIXSYS server.tx.languages.cobol.flavor vcobol kixregion setAttr $KIXSYS server.tx.languages.cobol.home $VCOBOL kixregion setAttr $KIXSYS maps.location $PROJECT_ROOT/maps kixregion setAttr $KIXSYS programs.location $PROJECT_ROOT/loadlib kixregion setAttr $KIXSYS environment.KIXDATA $KIXDATA kixregion setAttr $KIXSYS td.jobq.submission.node $EBMHOME kixregion setAttr $KIXSYS td.jobq.submission.subsys $EBMSYS
  3. Genera il file di ambiente utente specifico per questa regione TPE eseguendo il kixregion createScript comando. Questo comando crea o aggiorna $KIXSYS/bin/userenv in base alla configurazione della regione TPE.

    kixregion createScript $KIXSYS
  4. Attiva la regione TPE generando il file di ambiente utente (). $KIXSYS/bin/userenv

    source $KIXSYS/bin/userenv
  5. Crea la regione TPE eseguendo il comando. kixinstall2

    kixinstall2

Fase 3: Creare il nodo e il sottosistema BPE

Dopo aver creato una regione TPE, è necessario creare il nodo e il sottosistema BPE seguendo questi passaggi.

  1. Modifica la proprietà e le autorizzazioni di. INSTEBM

    sudo chown root $INSTEBM sudo chmod 4755 $INSTEBM
  2. Creare un nodo BPE utilizzando il INSTEBM comando. La directory del nodo BPE viene fornita come parametro di input.

    $INSTEBM $EBMHOME
  3. Attiva l'ambiente batch ricavando il batchenv file dal nodo BPE appena creato.

    source $EBMHOME/batchenv
  4. Create il sottosistema BPE all'interno di questo nodo utilizzando Batch Administration Manager (bam). Il bam comando aprirà l'interfaccia Batch Administration Manager.

    bam
    1. Avviare il nodo BPE utilizzando l'interfaccia BAM. Scegliete l'opzione 2, System Environments dal menu principale.

      In Batch Administrator Manager, scegli l'opzione 2 Ambienti di sistema.
    2. Scegliete l'opzione 2, Start/ (Stop) Batch Node per avviare il nodo BPE.

      In System Environments, scegli l'opzione 2 (nodo Start/Stop batch).
    3. Una volta avviato, premete due volte il tasto Invio per tornare al menu principale di BAM.

      Schermata di avvio di Batch Node completata.
    4. Per creare il sottosistema BPE, scegli l'opzione 3, Applicazioni e sottosistemi.

      Opzione 3 Applicazioni e sottosistemi selezionati nella pagina Batch Administrator Manager.
    5. Quindi scegli l'opzione 3, Crea un sottosistema.

      Opzione 3 Crea un sottosistema selezionato nella schermata Applicazioni e sottosistemi.
    6. Immettere il nome del sottosistema come. sys1

      È stato immesso sys1 nella schermata Crea.
    7. Scegli l'opzione 3, Gestione dei dati.

      Scegli l'opzione 3 Gestione dei dati nella schermata Crea in Applicazioni e sottosistema.
    8. Scegliete l'opzione 5, poiché l' CardDemo applicazione coinvolge sia file sequenziali che VSAM.

      Scegli l'opzione 5 per includere file sequenziali e VSAM.
    9. (Facoltativo). Premi «R» per tornare alla pagina Crea menu, rivedi le diverse opzioni di configurazione disponibili.

    10. Nella pagina Crea, inserisci «C» per creare il sottosistemasys1.

      Premi «C» sulla tastiera per creare il sottosistema sys1.
    11. Rivedi le impostazioni e inserisci «C» per continuare con il resto delle impostazioni dell'ambiente. Queste impostazioni di ambiente sono precompilate a causa delle variabili di ambiente necessarie definite nel file di carddemo.env installazione e della struttura di cartelle consigliata.

    12. Immettete «y» per confermare e salvare le impostazioni ambientali correnti.

      Visualizza l'impostazione dell'ambiente del sottosistema sys1 completata. Digita anche «y» per salvare le impostazioni correnti.
    13. Inserite «y» per visualizzare il registro durante la creazione del sottosistema.

      Mostra sullo schermo il sistema runtime NTT DATA COBOL di sys1 in fase di compilazione.
    14. Premi il tasto Invio fino a tornare al menu principale e uscire dall'interfaccia BAM selezionando l'opzione Esci.

      Visualizza il sistema di runtime COBOL creato. Richiede inoltre di premere Invio per continuare.
      Torna al menu Crea e mostra che il sottosistema sys1 è stato creato. E la configurazione viene aggiornata. Richiede di premere Invio per continuare.
      Menu principale di Batch Administrator. Richiede di inserire Q per uscire da questo menu.
  5. Attiva il sottosistema BPE inserendo il nome del sottosistema. batchenv sys1

    source $EBMHOME/batchenv sys1

Fase 4: Compilazione e distribuzione dell'applicazione CardDemo

In questo passaggio, si compilano i programmi COBOL e si distribuiscono artefatti applicativi come JCL, procedure, file di dati e definizioni di risorse CICS.

  1. Attivate nuovamente l' CardDemo ambiente richiamando il file di installazione. carddemo.env

    source $HOME/bin/carddemo.env
  2. Accedere alla directory dei sorgenti COBOL.

    cd $MIGAPP_DIR/cbl
  3. Compila il programma CBACT01C.cbl Cobol usando uno script. compile

    compile CBACT01C.cbl
  4. Compila tutti i programmi Cobol usando degli script. compile.all

    compile.all
  5. Accedere alla cartella sorgente delle mappe BMS.

    cd $MIGAPP_DIR/bms
  6. Compila la mappa COACTUP.bms BMS utilizzando lo script. compbms

    compbms COACTUP.bms
  7. Compila tutte le mappe BMS usando lo script. compbms.all

    compbms.all
  8. Verifica i binari compilati per le mappe COBOL e BMS.

    ls $PROJECT_ROOT/loadlib ls $PROJECT_ROOT/maps
  9. Implementa altri artefatti applicativi come JCL, procedure, file di dati e definizioni di risorse CICS utilizzando lo script. deploy_app

    deploy_app
  10. Accedi alla directory JCL del progetto.

    cd $PROJECT_ROOT/jcl
  11. Traduci JCL ACCTFILE in BPE JCL Macro. Usa il mvstrans comando, utilizzando l'opzione «-v» per la verifica JCL e l'opzione «-f» per creare la macro.

    mvstrans ACCTFILE -v mvstrans ACCTFILE -f
  12. Tradurre la procedura JCL REPROC in BPE Procedura JCL Macro. Usa il mvstrans comando con l'opzione «-p» insieme all'opzione «-v» per la verifica e l'opzione «-f» per creare la macro.

    mvstrans REPROC -v -p mvstrans REPROC -f -p
  13. Traduci tutte le procedure JCL e JCL.

    for file in "./jmvs/*"; do mvstrans $file -f; done > jmvs.out for file in "./mvsp/*"; do mvstrans $file -p -f; done > mvsp.out

Fase 5: Importazione del catalogo BPE e TPE

In questo passaggio, si importa il catalogo BPE e TPE utilizzando comandi diversi.

  1. Importa il catalogo BPE utilizzando il comando. loadcat

    loadcat $MIGAPP_DIR/catlg/bpe/BPECAT*
  2. Accedere alla directory $KIXSYS.

    cd $KIXSYS
  3. Importa il catalogo TPE usando il comando. kiximpcat

    kiximpcat -c CATALOG -l CATALOG.lst
  4. Importa le definizioni delle risorse CICS usando il comando kiximptbl.

    kiximptbl

Fase 6: Avviare e connettere TPE con BPE

In questo passaggio, è necessario avviare la regione TPE creata in precedenza insieme al gestore BPE e collegarli per poter eseguire l'applicazione di esempio. CardDemo

  1. Esegui il kixverify comando su tutti i file VSAM per assicurarti che vengano ripristinati e che tutti i file aperti in precedenza vengano chiusi.

    kixverify -r ALL
  2. Avviare la regione TPE.

    kixregion start $KIXSYS
  3. Assicurati che sia il BPE che il TPE siano collegati. Ciò è fondamentale in quanto i file VSAM sono di proprietà di TPE e qualsiasi operazione batch di accesso al VSAM richiederà una connessione a TPE.

    ebmsys -t
    Visualizza il nome del sottosistema come sys1. TPE è connesso e l'utente TPE è ec2-user.

Fase 7: Eseguire l'applicazione CardDemo

In questo passaggio, si esegue l' CardDemo applicazione nell'emulatore di terminale TN3270.

L'AMI UniKix runtime viene fornito con l'emulatore di terminale TN3270 che puoi avviare direttamente dall'istanza EC2. UniKix

Connettiti a TPE usando l'emulatore di terminale TN3270
  • Avvia il terminale TN3270 usando il comando. kixterm

    kixterm
    La schermata principale dell'applicazione di UniKix CardDemo esempio TPE per mainframe.

(Opzionale). Se desideri utilizzare il tuo emulatore di terminale:

  1. Ottieni l'indirizzo IP dell'istanza di UniKix runtime dalla console Amazon EC2.

  2. Ottieni il numero di porta per la connessione alla regione TPE utilizzando l'emulatore di terminale TN3270. Puoi trovarlo su ListenPort TNServer dal file unikixrc.cfg.

    cat $KIXSYS/unikixrc.cfg
    Visualizza i dettagli del file UniKix unikixrc.cfg con la porta del listener come 15440.
  3. Configurate l'emulatore di terminale TN3270 per utilizzare l'indirizzo IP dell'istanza di UniKix runtime e il numero di porta 15440.

Transazioni online

Questa sezione presuppone che ci si sia connessi all'emulatore di terminale TN3270 utilizzando il comando. kixterm

  1. Dopo la connessione dall'emulatore di terminale TN3270, premere il tasto «Invio» per cancellare la schermata TPE e inserire la transazione iniziale.

  2. Nella transazione iniziale CC00 (schermata di accesso) inserisci il nome utente e USER001 la password. PASSWORD

    Schermata principale per. CardDemo Indica che si tratta di un' CardDemoapplicazione Credit for Mainframe Modernization. Chiede di inserire l'ID utente e la password.
  3. Scegli l'opzione «01" dal menu principale per visualizzare gli account.

    CardDemo menu principale dell'applicazione nell'emulatore con l'opzione selezionata come 1.
  4. Nella schermata Visualizza account, inserisci un numero di conto (ad esempio, 00000000010). Dovresti vedere le informazioni sull'account compilate a partire dai dati migrati.

    Dettagli della CardDemo domanda con il numero di conto inserito come 00000000010.
  5. Premi due volte il tasto «PF03" per tornare alla schermata di accesso ed esci dal terminale TN3270 premendo «Ctrl+C» (Windows) o «Cmd+C» (Macbook).

Lavori in batch

  1. Accedere alla directory JCL.

    cd $MBMSUB
  2. Invia il lavoro MFCATGL1 e osserva l'output del job log.

    BPESUB READCARD
  3. Facoltativamente, è possibile visualizzare i log dei lavori dalla $SUBSYS_OUTDIR directory.

    ls -lrt $SUBSYS_OUTDIR/*

L' CardDemo applicazione è stata ora distribuita correttamente sul UniKix runtime di NTT DATA e verificato l'applicazione in esecuzione navigando tra alcune schermate online CICS e alcuni processi batch.

Risoluzione dei problemi

Di seguito sono riportati alcuni errori comuni che potresti riscontrare durante la configurazione dell'applicazione. CardDemo

Errore: errore di licenza

Se ricevi un errore di licenza mentre segui questo tutorial, è possibile che IMDSv2 sia abilitato nel tuo EC2. Puoi risolvere questo problema modificando l'opzione di metadati dell'istanza IMDSv2 su Optional, come indicato in Restore the use of IMDSv1 nella guida per l'utente di Amazon EC2.

Errore: TPE non è connesso a BPE

Se il TPE non è connesso a BPE, assicurati che la tabella di configurazione VSAM sia configurata correttamente con la directory del nodo BPE. Per accedere alla tabella di configurazione VSAM, avviare l'emulatore di terminale TN3270 utilizzando il seguente comando:

kixterm
  1. Immettere il nome della transazione come. CTBL

  2. Nel menu Table Manager, scegli l'opzione Tabelle standard.

  3. Nella schermata Tabelle standard, scegli l'opzione Tabella di configurazione VSAM.

  4. Controlla se Connetti al nodo batch? è impostato su "Y e la directory dei nodi è corretta.

Tabella di configurazione VSAM nell'emulatore di terminale TN3270. Visualizzazione dei valori per ciascuno dei campi della tabella.