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.
Prerequisiti
-
Segui le istruzioni fornite nell'AWS Modernizzazione del mainframe, ripiattaforma con NTT DATAutilizzo dell'AMI NTT DATA Marketplace. UniKix
-
Modifica l'opzione di metadati dell'istanza IMDSv2 in Opzionale come indicato in Restore the use of IMDSv1 nella guida per l'utente di Amazon EC2.
-
Scarica CardDemo i componenti UniKix di runtime per NTT DATA da
-
Accedere all'istanza EC2 in UniKix fase di esecuzione come.
ec2-user -
Estrai i componenti CardDemo di runtime scaricati utilizzando questo link: UniKix _ CardDemo _runtime_v1.zip
. -
La directory estratta deve contenere
binemigrated_appdirectory. -
Sposta entrambe
binlemigrated_appcartelle nella tua cartella.$HOMEIl percorso sarebbe simile/home/ec2-user. -
Dovresti avere le seguenti directory nel tuo
$HOME:-
/home/ec2-user/bin -
/home/ec2-user/migrated_app
-
-
Sposta tutti i file all'interno della HOME/bin directory $ con il seguente comando:
-
-
chmod +x $HOME/bin/*
-
-
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.
-
Accedere all'istanza EC2 in UniKix fase di esecuzione come.
ec2-user -
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/ -
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/*/* -
Crea una struttura di cartelle eseguendo lo script con il seguente comando:
create_projectsh $HOME/bin/create_project -
Attiva l' CardDemo ambiente reperendo il file di
carddemo.envinstallazione 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.
-
Crea una regione TPE utilizzando il
kixregion createRegioncomando che richiede input come$KIXSYS, e.$JAVA_HOME$KIXLICDIRQueste variabili di ambiente sono già configurate nel file dicarddemo.envconfigurazione.kixregion createRegion $KIXSYS $JAVA_HOME $KIXLICDIR -
Configurare la regione TPE utilizzando il
kixregion setAttrcomando.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 -
Genera il file di ambiente utente specifico per questa regione TPE eseguendo il
kixregion createScriptcomando. Questo comando crea o aggiorna$KIXSYS/bin/userenvin base alla configurazione della regione TPE.kixregion createScript $KIXSYS -
Attiva la regione TPE generando il file di ambiente utente ().
$KIXSYS/bin/userenvsource $KIXSYS/bin/userenv -
Crea la regione TPE eseguendo il comando.
kixinstall2kixinstall2
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.
-
Modifica la proprietà e le autorizzazioni di.
INSTEBMsudo chown root $INSTEBM sudo chmod 4755 $INSTEBM -
Creare un nodo BPE utilizzando il
INSTEBMcomando. La directory del nodo BPE viene fornita come parametro di input.$INSTEBM $EBMHOME -
Attiva l'ambiente batch ricavando il
batchenvfile dal nodo BPE appena creato.source $EBMHOME/batchenv -
Create il sottosistema BPE all'interno di questo nodo utilizzando Batch Administration Manager (bam). Il
bamcomando aprirà l'interfaccia Batch Administration Manager.bam-
Avviare il nodo BPE utilizzando l'interfaccia BAM. Scegliete l'opzione 2, System Environments dal menu principale.
-
Scegliete l'opzione 2, Start/ (Stop) Batch Node per avviare il nodo BPE.
-
Una volta avviato, premete due volte il tasto Invio per tornare al menu principale di BAM.
-
Per creare il sottosistema BPE, scegli l'opzione 3, Applicazioni e sottosistemi.
-
Quindi scegli l'opzione 3, Crea un sottosistema.
-
Immettere il nome del sottosistema come.
sys1
-
Scegli l'opzione 3, Gestione dei dati.
-
Scegliete l'opzione 5, poiché l' CardDemo applicazione coinvolge sia file sequenziali che VSAM.
-
(Facoltativo). Premi «R» per tornare alla pagina Crea menu, rivedi le diverse opzioni di configurazione disponibili.
-
Nella pagina Crea, inserisci «C» per creare il sottosistema
sys1.
-
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.envinstallazione e della struttura di cartelle consigliata. -
Immettete «y» per confermare e salvare le impostazioni ambientali correnti.
-
Inserite «y» per visualizzare il registro durante la creazione del sottosistema.
-
Premi il tasto Invio fino a tornare al menu principale e uscire dall'interfaccia BAM selezionando l'opzione Esci.
-
-
Attiva il sottosistema BPE inserendo il nome del sottosistema.
batchenvsys1source $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.
-
Attivate nuovamente l' CardDemo ambiente richiamando il file di installazione.
carddemo.envsource $HOME/bin/carddemo.env -
Accedere alla directory dei sorgenti COBOL.
cd $MIGAPP_DIR/cbl -
Compila il programma
CBACT01C.cblCobol usando uno script.compilecompile CBACT01C.cbl -
Compila tutti i programmi Cobol usando degli script.
compile.allcompile.all -
Accedere alla cartella sorgente delle mappe BMS.
cd $MIGAPP_DIR/bms -
Compila la mappa
COACTUP.bmsBMS utilizzando lo script.compbmscompbms COACTUP.bms -
Compila tutte le mappe BMS usando lo script.
compbms.allcompbms.all -
Verifica i binari compilati per le mappe COBOL e BMS.
ls $PROJECT_ROOT/loadlib ls $PROJECT_ROOT/maps -
Implementa altri artefatti applicativi come JCL, procedure, file di dati e definizioni di risorse CICS utilizzando lo script.
deploy_appdeploy_app -
Accedi alla directory JCL del progetto.
cd $PROJECT_ROOT/jcl -
Traduci JCL ACCTFILE in BPE JCL Macro. Usa il
mvstranscomando, utilizzando l'opzione «-v» per la verifica JCL e l'opzione «-f» per creare la macro.mvstrans ACCTFILE -v mvstrans ACCTFILE -f -
Tradurre la procedura JCL REPROC in BPE Procedura JCL Macro. Usa il
mvstranscomando 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 -
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.
-
Importa il catalogo BPE utilizzando il comando.
loadcatloadcat $MIGAPP_DIR/catlg/bpe/BPECAT* -
Accedere alla directory $KIXSYS.
cd $KIXSYS -
Importa il catalogo TPE usando il comando.
kiximpcatkiximpcat -c CATALOG -l CATALOG.lst -
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
-
Esegui il
kixverifycomando su tutti i file VSAM per assicurarti che vengano ripristinati e che tutti i file aperti in precedenza vengano chiusi.kixverify -r ALL -
Avviare la regione TPE.
kixregion start $KIXSYS -
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
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.
kixtermkixterm
(Opzionale). Se desideri utilizzare il tuo emulatore di terminale:
-
Ottieni l'indirizzo IP dell'istanza di UniKix runtime dalla console Amazon EC2.
-
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
-
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
-
Dopo la connessione dall'emulatore di terminale TN3270, premere il tasto «Invio» per cancellare la schermata TPE e inserire la transazione iniziale.
-
Nella transazione iniziale CC00 (schermata di accesso) inserisci il nome utente e
USER001la password.PASSWORD
-
Scegli l'opzione «01" dal menu principale per visualizzare gli account.
-
Nella schermata Visualizza account, inserisci un numero di conto (ad esempio, 00000000010). Dovresti vedere le informazioni sull'account compilate a partire dai dati migrati.
-
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
-
Accedere alla directory JCL.
cd $MBMSUB -
Invia il lavoro
MFCATGL1e osserva l'output del job log.BPESUB READCARD -
Facoltativamente, è possibile visualizzare i log dei lavori dalla
$SUBSYS_OUTDIRdirectory.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
-
Immettere il nome della transazione come.
CTBL -
Nel menu Table Manager, scegli l'opzione Tabelle standard.
-
Nella schermata Tabelle standard, scegli l'opzione Tabella di configurazione VSAM.
-
Controlla se Connetti al nodo batch? è impostato su "Y e la directory dei nodi è corretta.