

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 (Self-Managed Experience). I clienti esistenti possono continuare a utilizzare il servizio normalmente. [Per ulteriori informazioni, consulta AWS Modifica della disponibilità di Mainframe Modernization.](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)

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 Modernizzazione del mainframe: ripiattaforma con NTT DATA
<a name="unikix"></a>

AWS La modernizzazione del mainframe offre una varietà di Amazon Machine Images (AMI). Queste AMI facilitano il provisioning rapido delle istanze Amazon EC2, creando un ambiente personalizzato per il rehosting e la ripiattaforma delle applicazioni mainframe utilizzando NTT Data. AWS Questa guida fornisce i passaggi necessari per accedervi e utilizzarle. AMIs 

## Prerequisiti
<a name="prereqs-unikix"></a>
+ Assicurati di avere accesso da amministratore a un AWS account in cui creare istanze Amazon EC2.
+ Verifica che il servizio di modernizzazione del AWS mainframe sia disponibile nella regione in cui intendi creare le istanze Amazon EC2. Consulta [l'elenco dei servizi AWS disponibili per regione](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/).
+ Identifica l'Amazon VPC in cui desideri creare le istanze Amazon EC2.

## Iscriviti all'Amazon Machine Image
<a name="subscribe-to-images-unikix"></a>

Quando ti abboni a un prodotto AWS Marketplace, puoi avviare un'istanza dall'AMI del prodotto.

1. Accedi Console di gestione AWS e apri la Marketplace AWS console su [https://console.aws.amazon.com/marketplace](https://console.aws.amazon.com/marketplace).

1. Scegli **Manage subscriptions** (Gestisci sottoscrizioni).

1. [Copia e incolla il seguente link nella barra degli indirizzi del browser: https://aws.amazon.com/marketplace/ pp/prodview-eg227ymldsnx2](https://aws.amazon.com/marketplace/pp/prodview-eg227ymldsnx2)

1. Scegliere **Continue to Subscribe (Continua la sottoscrizione)**.

1. **Se i termini e le condizioni sono accettabili, scegli Accetta termini.** L'elaborazione dell'abbonamento potrebbe richiedere alcuni minuti.

1. Attendi che venga visualizzato un messaggio di ringraziamento. Questo messaggio conferma che l'iscrizione al prodotto è avvenuta con successo.

1. Nel riquadro di navigazione a sinistra, scegli **Gestisci abbonamenti**. Questa visualizzazione mostra tutti i tuoi abbonamenti.

## Avvia la ripiattaforma AWS Mainframe Modernization con l'istanza NTT DATA
<a name="launch-data-replatform-unikix"></a>

1. [Apri la console su /marketplace Marketplace AWS . https://console.aws.amazon.com](https://console.aws.amazon.com/marketplace)

1. Nel riquadro di navigazione a sinistra, scegli **Gestisci abbonamenti**.

1. Trova l'AMI che desideri avviare e scegli **Launch new instance**.

1. In **Regione**, seleziona la regione consentita.

1. Scegli **Continua a lanciare tramite EC2**. Questa azione ti porta alla console Amazon EC2.

1. Inserisci un nome per il server.

1. Seleziona un tipo di istanza che soddisfi i requisiti di prestazioni e costi del progetto. Il punto di partenza consigliato per la dimensione dell'istanza è`c5.2xLarge`.

1. Scegli una key pair esistente o creane e salvane una nuova. Per informazioni sulle coppie di chiavi, consulta le coppie di [chiavi Amazon EC2 e le istanze Linux](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html) nella Guida per l'utente di Amazon EC2.

1. Modifica le impostazioni di rete e scegli il VPC nell'elenco consentito e la sottorete appropriata.

1. Scegli un gruppo di sicurezza esistente o creane uno nuovo. Se si tratta di un'istanza Amazon EC2 di Enterprise Server, è normale consentire il traffico TCP verso le porte 86 e 10086 per amministrare la configurazione di Rocket Software (precedentemente Micro Focus).

1. Configura lo storage per l'istanza Amazon EC2.

1. Controlla il riepilogo e scegli **Launch instance**. Affinché il lancio abbia successo, il tipo di istanza deve essere valido. Se l'avvio fallisce, scegli **Modifica configurazione dell'istanza** e scegli un tipo di istanza diverso.

1. Dopo aver visualizzato il messaggio di successo, scegli **Connect to instance**.

1. Apri la console Amazon EC2 all'indirizzo [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. Nel riquadro di navigazione a sinistra, nel menu **Istanze**, scegli **Istanze**.

1. Nel riquadro principale, controlla lo stato della tua istanza.

## Guida introduttiva a NTT Data
<a name="unikix-getting-started"></a>

Dopo aver effettuato il provisioning dell'istanza Amazon EC2, accedi tramite SSH con il nome utente. `ec2-user` La schermata sarà simile all'immagine seguente.

![\[Schermata SSH con istanza Amazon EC2 e nome utente forniti.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/unikix-start-screen.png)


Sotto la `/opt/software/` cartella, c'è una cartella denominata`UniKix_Product_Guides`, come mostrato nell'immagine seguente.

![\[Schermata SSH con i dettagli della /opt/software/ cartella. Individua la cartellaUniKix_Product_Guides.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/unikix-product-guides.png)


La `UniKix_Product_Guides` cartella include la documentazione per i seguenti componenti installati su questa istanza Amazon EC2:
+ TIPO DI DATI NTT
+ DATI NTT BPE
+ NTT DATA Enterprise COBOL
+ NTT DATA Secure UniKix 
+ Gestore centrale NTT DATA UniKix 

La `software` cartella che appare nell'immagine precedente contiene i file binari per i componenti elencati sopra.

Dopo aver convalidato con successo l'istanza Amazon EC2, inizia a AWS utilizzare Mainframe Modernization Replatform with NTT DATA seguendo la documentazione di NTT Data.

# Tutorial: distribuisci l'applicazione su NTT DATA CardDemo
<a name="tutorial-unikix-runtime"></a>

Questa pagina illustra il step-by-step processo di distribuzione dell'applicazione di CardDemo esempio sulla ripiattaforma AWS Mainframe Modernization con il runtime NTT DATA Unikix.

L'applicazione CardDemo di esempio è un'applicazione mainframe semplificata progettata e sviluppata per testare e presentare la tecnologia dei partner per casi AWS d'uso di migrazione e modernizzazione del mainframe. 

[Per ulteriori informazioni su questa applicazione, vedere, repository for. GitHub CardDemo](https://github.com/aws-samples/aws-mainframe-modernization-carddemo)

**Topics**
+ [Diagramma di flusso di distribuzione](#tutorial-unikix-workflow)
+ [Prerequisiti](#tutorial-unikix-prerequisites)
+ [Fase 1: Preparare l'ambiente](#tutorial-unikix-prepare)
+ [Fase 2: Creare una regione TPE](#tutorial-unikix-tpe)
+ [Fase 3: Creare il nodo e il sottosistema BPE](#tutorial-unikix-bpe)
+ [Fase 4: Compilare e distribuire l'applicazione CardDemo](#tutorial-unikix-compile)
+ [Fase 5: Importazione del catalogo BPE e TPE](#tutorial-unikix-import)
+ [Fase 6: Avviare e collegare TPE con BPE](#unikix-tutorial-connect)
+ [Fase 7: Eseguire l'applicazione CardDemo](#unikix-tutorial-run-application)
+ [Risoluzione dei problemi](#tutorial-unikix-troubleshoot)

## Diagramma di flusso di distribuzione
<a name="tutorial-unikix-workflow"></a>

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.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/unikix-process.png)


## Prerequisiti
<a name="tutorial-unikix-prerequisites"></a>
+ Segui le istruzioni fornite nell'[AWS Modernizzazione del mainframe: ripiattaforma con NTT DATA](unikix.md)utilizzo dell'[AMI NTT DATA UniKix Marketplace](https://aws.amazon.com/marketplace/pp/prodview-eg227ymldsnx2).
+ Modifica l'opzione dei metadati dell'istanza **IMDSv2**su **Opzionale**, come indicato in [Ripristina l'uso di IMDSv1](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-IMDS-existing-instances.html) nella guida per l'utente di *Amazon EC2*.
+ Scarica i componenti CardDemo di runtime per NTT DATA dal UniKix 

  [GitHub archivio](https://github.com/aws-samples/aws-mainframe-modernization-carddemo/blob/main/samples/m2/unikix/UniKix_CardDemo_runtime_v1.zip).
+ Accedi all'istanza EC2 in UniKix fase di esecuzione come. `ec2-user`
+ Estrai i componenti CardDemo di runtime scaricati utilizzando questo link: [UniKix\$1 CardDemo \$1runtime\$1v1.zip](https://github.com/aws-samples/aws-mainframe-modernization-carddemo/blob/main/samples/m2/unikix/UniKix_CardDemo_runtime_v1.zip).
  + La directory estratta deve contenere `bin` e `migrated_app` directory.
  + Sposta entrambe `bin` le `migrated_app` cartelle nella tua cartella. `$HOME` Il percorso sarebbe simile `/home/ec2-user` a.
  + Dovresti avere le seguenti directory nella tua`$HOME`:
    + `/home/ec2-user/bin`
    + `/home/ec2-user/migrated_app`
  + Sposta tutti i file all'interno della directory \$1HOME/bin con il seguente comando:
  + 
    + `chmod +x $HOME/bin/*`

## Fase 1: Preparare l'ambiente
<a name="tutorial-unikix-prepare"></a>

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

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

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

   ```
   ls -l /opt/software/
   ```

1. Esamina l'applicazione migrata. CardDemo Vedrai tutto il codice sorgente, comprese le mappe BMS, i programmi COBOL, i quaderni COBOL e. JCLs Puoi anche esportare i cataloghi BPE e TPE, le definizioni delle risorse CICS e i dati migrati come file sequenziali e file VSAM in questo modo:

   ```
   ls  $HOME/migrated_app/*/*
   ```

1. Crea la struttura delle cartelle eseguendo lo script con il seguente comando: `create_project`

   ```
   sh $HOME/bin/create_project
   ```

1. Attiva l' CardDemo ambiente scaricando il file di `carddemo.env` installazione utilizzando:

   ```
   source $HOME/bin/carddemo.env
   ```

## Fase 2: Creare una regione TPE
<a name="tutorial-unikix-tpe"></a>

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

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

   ```
   kixregion createRegion $KIXSYS $JAVA_HOME $KIXLICDIR
   ```

1. 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
   ```

1. 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
   ```

1. Attiva la regione TPE generando il file di ambiente utente (). `$KIXSYS/bin/userenv`

   ```
   source $KIXSYS/bin/userenv
   ```

1. Crea la regione TPE eseguendo il comando. `kixinstall2`

   ```
   kixinstall2
   ```

## Fase 3: Creare il nodo e il sottosistema BPE
<a name="tutorial-unikix-bpe"></a>

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

1. Crea un nodo BPE utilizzando il `INSTEBM` comando. La directory dei nodi BPE viene fornita come parametro di input.

   ```
   $INSTEBM $EBMHOME
   ```

1. Attiva l'ambiente batch estraendo il `batchenv` file dal nodo BPE appena creato.

   ```
   source $EBMHOME/batchenv
   ```

1. Creare il sottosistema BPE all'interno di questo nodo utilizzando Batch Administration Manager (bam). Il `bam` comando aprirà l'interfaccia di Batch Administration Manager.

   ```
   bam
   ```

   1. Avviare il nodo BPE utilizzando l'interfaccia BAM. Scegliete l'opzione 2, **Ambienti di sistema** dal menu principale.  
![\[In Batch Administrator Manager, scegli l'opzione 2 Ambienti di sistema.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/unikix-bpe-1.png)

   1. Scegliete l'opzione 2, **Start/ (Stop) Batch Node** per avviare il nodo BPE.   
![\[In Ambienti di sistema, scegliete l'opzione 2, nodo Start/Stop batch.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/unikix-bpe-2.png)

   1. Una volta avviato, premi due volte il **tasto** Invio per tornare al menu principale di BAM.  
![\[Schermata di avvio del nodo Batch completata.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/unikix-bpe-3.png)

   1. Per creare il sottosistema BPE, scegliete l'opzione 3, **Applicazioni e** sottosistemi.  
![\[Opzione 3 Applicazioni e sottosistemi selezionati nella pagina Batch Administrator Manager.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/unikix-bpe-4.png)

   1. Quindi scegli l'opzione 3, **Crea un sottosistema**.  
![\[Opzione 3 Crea un sottosistema selezionato nella schermata Applicazioni e sottosistemi.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/unikix-bpe-5.png)

   1. Immettere il nome del sottosistema come. `sys1`  
![\[Ha inserito sys1 nella schermata Crea.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/unikix-bpe-6.png)

   1. Scegliete l'opzione 3, Gestione **dei dati**.  
![\[Scegli l'opzione 3 Gestione dei dati nella schermata Crea in Applicazioni e sottosistema.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/unikix-bpe-7.png)

   1. Scegliete l'opzione 5, poiché l' CardDemo applicazione include sia file sequenziali che VSAM.  
![\[Scegliete l'opzione 5 per includere file sequenziali e VSAM.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/unikix-bpe-8.png)

   1. (Facoltativo). Premi «R» per tornare alla pagina **Crea menu**, rivedi le diverse opzioni di configurazione disponibili.

   1. Nella pagina **Crea**, inserisci «C» per creare il sottosistema`sys1`.  
![\[Premi «C» sulla tastiera per creare il sottosistema sys1.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/unikix-bpe-9.png)

   1. Rivedi le impostazioni e inserisci «C» per continuare con il resto delle impostazioni dell'ambiente. Queste impostazioni di ambiente sono precompilate grazie alle variabili di ambiente necessarie definite nel file di `carddemo.env` installazione e alla struttura di cartelle consigliata.

   1. Immettere «y» per confermare e salvare le impostazioni ambientali correnti.  
![\[Visualizza le impostazioni di ambiente del sottosistema sys1 completate. Digita anche «y» per salvare le impostazioni correnti.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/unikix-bpe-10.png)

   1. Immettete «y» per visualizzare il registro durante la creazione del sottosistema.  
![\[Mostra sullo schermo il sistema di runtime NTT DATA COBOL di Building sys1.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/unikix-bpe-11.png)

   1. **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.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/unikix-bpe-12.png)  
![\[Torna al menu Crea e mostra che il sottosistema sys1 è stato creato. E la configurazione viene aggiornata. Richiede di premere invio per continuare.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/unikix-bpe-13.png)  
![\[Menu principale per Batch Administrator. Richiede di inserire Q per uscire da questo menu.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/unikix-bpe-14.png)

1. Attiva il sottosistema BPE rifornendoli con il nome del sottosistema. `batchenv` `sys1`

   ```
   source $EBMHOME/batchenv sys1
   ```

## Fase 4: Compilare e distribuire l'applicazione CardDemo
<a name="tutorial-unikix-compile"></a>

In questa fase, si compilano i programmi COBOL e si distribuiscono elementi applicativi come JCL, procedure, file di dati e definizioni delle risorse CICS.

1. Attiva nuovamente l' CardDemo ambiente utilizzando il file di installazione. `carddemo.env`

   ```
   source $HOME/bin/carddemo.env
   ```

1. Passate alla directory dei sorgenti COBOL.

   ```
   cd $MIGAPP_DIR/cbl
   ```

1. Compila il programma `CBACT01C.cbl` Cobol usando uno script. `compile`

   ```
   compile CBACT01C.cbl
   ```

1. Compila tutti i programmi Cobol usando uno script. `compile.all`

   ```
   compile.all
   ```

1. Vai alla cartella dei sorgenti delle mappe BMS.

   ```
   cd $MIGAPP_DIR/bms
   ```

1. Compila la mappa `COACTUP.bms` BMS usando lo script. `compbms`

   ```
   compbms COACTUP.bms
   ```

1. Compila tutte le mappe BMS usando lo script. `compbms.all`

   ```
   compbms.all
   ```

1. Verifica i binari compilati per le mappe COBOL e BMS.

   ```
   ls $PROJECT_ROOT/loadlib
   ls $PROJECT_ROOT/maps
   ```

1. Implementa altri elementi dell'applicazione come JCL, procedure, file di dati e definizioni di risorse CICS utilizzando lo script. `deploy_app`

   ```
   deploy_app
   ```

1. Passa alla directory JCL del progetto.

   ```
   cd $PROJECT_ROOT/jcl
   ```

1. 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
   ```

1. Traduci la procedura JCL REPROC in una macro della procedura JCL BPE. 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
   ```

1. Translate tutte le procedure JCLs 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
<a name="tutorial-unikix-import"></a>

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

1. Vai alla directory \$1KIXSYS.

   ```
   cd $KIXSYS
   ```

1. Importa il catalogo TPE usando il comando. `kiximpcat`

   ```
   kiximpcat -c CATALOG -l CATALOG.lst
   ```

1. Importa le definizioni delle risorse CICS usando il comando kiximptbl.

   ```
   kiximptbl
   ```

## Fase 6: Avviare e collegare TPE con BPE
<a name="unikix-tutorial-connect"></a>

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. Eseguite il `kixverify` comando su tutti i file VSAM per assicurarvi che vengano ripristinati e che tutti i file precedentemente aperti vengano chiusi.

   ```
   kixverify -r ALL
   ```

1. Avviate la regione TPE.

   ```
   kixregion start $KIXSYS
   ```

1. Assicuratevi che sia BPE che TPE siano collegati. Questo è fondamentale in quanto i file VSAM sono di proprietà di TPE e qualsiasi operazione in batch che accede al VSAM richiederà una connessione a TPE.

   ```
   ebmsys -t
   ```  
![\[Visualizza il nome del sottosistema come sys1. TPE è connesso e l'utente TPE è ec2-user.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/unikix-start-1.png)

## Fase 7: Eseguire l'applicazione CardDemo
<a name="unikix-tutorial-run-application"></a>

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

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

**Connect a TPE utilizzando l'emulatore di TN3270 terminale**
+ Avvia il TN3270 terminale usando il comando. `kixterm`

  ```
  kixterm
  ```  
![\[La schermata principale dell'applicazione di UniKix CardDemo esempio TPE per mainframe.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/unikix-carddemo-00.png)

(Facoltativo). Se vuoi usare il tuo emulatore di terminale:

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

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

   ```
   cat $KIXSYS/unikixrc.cfg
   ```  
![\[Visualizza i dettagli del file UniKix unikixrc.cfg con la porta del listener impostata su 15440.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/unikix-carddemo-1.png)

1. Configura l'emulatore di TN3270 terminale per utilizzare l'indirizzo IP dell'istanza di UniKix runtime e il numero di porta 15440.

**Transazioni online**

Questa sezione presuppone che l'utente si sia connesso all'emulatore di TN3270 terminale utilizzando il `kixterm` comando.

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

1. Nella transazione iniziale CC00 (schermata di accesso) inserisci il nome `USER001` utente e `PASSWORD` la password.  
![\[Schermata principale per CardDemo. Indica che si tratta di un' CardDemoapplicazione di credito per la modernizzazione del mainframe. Chiede di inserire l'ID utente e la password.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/unikix-carddemo-2.png)

1. Scegli l'opzione «01" dal **menu principale** per visualizzare gli account.  
![\[CardDemo menu principale dell'applicazione nell'emulatore con l'opzione selezionata come 1.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/unikix-carddemo-3.png)

1. Nella schermata **Visualizza account**, inserisci un numero di conto (ad esempio, 00000000010). Dovresti vedere le informazioni sull'account compilate con i dati migrati.  
![\[Dettagli dell' CardDemo applicazione con il numero di conto inserito 00000000010.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/unikix-carddemo-4.png)

1. Premi due volte il tasto «PF03» per tornare alla schermata di accesso e esci dal TN3270 terminale premendo «Ctrl\$1C» (Windows) o «Cmd\$1C» (Macbook).

**Lavori in batch**

1. Vai alla directory JCL.

   ```
   cd $MBMSUB
   ```

1. Invia il lavoro `MFCATGL1` e osserva l'output del registro del lavoro.

   ```
   BPESUB READCARD
   ```

1. Facoltativamente, è possibile visualizzare i registri dei lavori dalla `$SUBSYS_OUTDIR` directory.

   ```
   ls -lrt $SUBSYS_OUTDIR/*
   ```

Ora avete distribuito con successo l' CardDemo applicazione sul UniKix runtime NTT DATA e verificato l'applicazione in esecuzione navigando tra alcune schermate online CICS e i processi in batch.

## Risoluzione dei problemi
<a name="tutorial-unikix-troubleshoot"></a>

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

### Errore: errore di licenza
<a name="tutorial-unikix-troubleshoot-license-issue"></a>

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 dei metadati dell'istanza su **Opzionale**, come indicato in [Restore the use of IMDSv1](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-IMDS-existing-instances.html) nella guida **IMDSv2**per l'utente di *Amazon EC2*.

### Errore: TPE non è collegato a BPE
<a name="tutorial-unikix-troubleshoot-tpe-connection"></a>

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

```
kixterm
```

1. Inserisci il nome della transazione come. `CTBL`

1. Nel menu **Table Manager**, scegliete l'opzione **Tabelle standard**.

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

1. Controlla se **Connect to batch node?** è impostato su "**Y**» e la cartella dei nodi è corretta.

![\[Tabella di configurazione VSAM nell'emulatore di TN3270 terminale. Visualizzazione dei valori per ciascuno dei campi della tabella.\]](http://docs.aws.amazon.com/it_it/m2/latest/userguide/images/unikix-troubleshoot.png)
