Questa pagina descrive come caricare le applicazioni in Mainframe Assessment Tool ed eseguire una valutazione degli asset che Mainframe Assessment Tool rileva nella codebase caricata.
Puoi eseguire autonomamente il rilevamento degli asset o richiedere l'assistenza di un customer engineer di Google.
Prima di iniziare
Per prepararti alla valutazione, assicurati di aver completato i seguenti prerequisiti:
- Configura il tuo Google Cloud progetto per Mainframe Assessment Tool
- Configura e accedi a Mainframe Assessment Tool
Carica i file dell'applicazione mainframe in Mainframe Assessment Tool
Per caricare i file dell'applicazione in Mainframe Assessment Tool:
Crea un file ZIP contenente tutte le applicazioni che vuoi migrare.
Mainframe Assessment Tool supporta solo file ZIP con una dimensione massima di 400 MB. Se il file ZIP dell'applicazione supera i 400 MB, valuta la possibilità di suddividerlo in file ZIP più piccoli in base ai domini aziendali e di caricare un file ZIP per ogni dominio.
Se le applicazioni contengono riferimenti ad artefatti esterni, come programmi o tabelle, ti consigliamo di includere anche queste dipendenze. Se disponibile, fornisci il codice sorgente dei seguenti tipi:
- Programmi COBOL (
cobecbl) - Copybook COBOL (
incecpy) - Programmi Easytrieve (
ezt) - Programmi HLASM (
asm) - Job JCL (
jcl) - Procedure JCL (
proc) - Include JCL
- Dati della scheda JCL (
ctl) - Programmi PL/I (
pliepl1) - Programmi RPG/RPGLE (
rpgerpgle) - File di inclusione RPG/RPGLE (
rpgincerpgleinc) - Configurazioni dello scheduler per BMC Control-M
Non includere file binari e altri file non di origine nel file ZIP.
- Programmi COBOL (
Per caricare il file ZIP in Mainframe Assessment Tool:
Per aprire Mainframe Assessment Tool sulla macchina locale, apri una finestra del browser web e vai a
http://localhost:PORT.Sostituisci
PORTcon il numero di porta che hai utilizzato sulla macchina locale per la connessione tramite tunnel a Mainframe Assessment Tool.Nella home page, fai clic su Crea valutazione.
Inserisci un nome.
(Facoltativo) Inserisci una descrizione per la valutazione.
Per caricare un file ZIP, fai clic su Seleziona file. Si apre il browser di file. Seleziona un file ZIP da caricare. Puoi caricare un solo file alla volta.
Fai clic su Avanti.
Per configurare gli approfondimenti generati dall'AI:
Per generare riepiloghi a livello di paragrafo per il codice COBOL, seleziona Riepiloghi dettagliati. Per impostazione predefinita, questa opzione è selezionata.
Per generare scenari di test per le specifiche di valutazione generate da Gemini, seleziona Scenari di test. Per impostazione predefinita, questa opzione non è selezionata.
In Indicazioni aggiuntive per la generazione, inserisci il testo da aggiungere ai prompt di Gemini durante la generazione dell'AI.
Fai clic su Avanti.
Per configurare i modelli Gemini e il livello qualitativo per la valutazione, configura il passaggio Modello e qualità, quindi fai clic su Avanti.
Per impostazione predefinita, Mainframe Assessment Tool utilizza il livello qualitativo Bilanciato consigliato. Per saperne di più sui livelli di qualità, sulla scelta di un modello specifico e sulla conservazione dei dati nella tua regione, vedi Scegliere modelli e qualità.
(Facoltativo) Per aggiungere uno o più domini che rappresentano un'area di funzionalità distinta, fai clic su Aggiungi dominio.
I domini ti consentono di filtrare e rivedere i risultati in base a contesti specifici al termine della valutazione.
Fai clic su Avanti.
Fai clic su Crea valutazione.
Dopo aver caricato il file ZIP, Mainframe Assessment Tool decomprime ed elabora il codice sorgente. La pagina Valutazioni mostra una nuova voce nella tabella per ogni asset rilevato, indicandone lo stato di valutazione.
- In attesa:la valutazione è in attesa del suo turno.
- In corso:l'analisi è in corso.
- Analizzata:la valutazione è stata completata.
- Non riuscita:la valutazione non è stata completata.
Se visualizzi errori dopo l'importazione del file, puoi esaminare il messaggio di errore direttamente in Mainframe Assessment Tool.
Per visualizzare ulteriori dettagli sull'avanzamento della valutazione di un elemento, fai clic sull'ID di riferimento accanto nella tabella. Si apre una pagina che mostra tutti i passaggi insieme allo stato.
Scegliere modelli e qualità
Configura i modelli Gemini per una valutazione durante la creazione o la modifica di una valutazione. Queste impostazioni si applicano solo a quella valutazione.
Per impostazione predefinita, Mainframe Assessment Tool ottimizza i modelli per ogni passaggio di valutazione in base al livello qualitativo selezionato. Lo strumento indirizza i passaggi di ragionamento complessi a modelli più pesanti e i passaggi più semplici a modelli più leggeri.
Selezionare un livello qualitativo
In Ottimizza per, seleziona uno dei seguenti livelli di qualità:
- Bilanciato (consigliato): bilancia velocità e profondità per la maggior parte delle valutazioni. Questo è il livello predefinito.
- Veloce: restituisce i risultati più rapidi utilizzando modelli più leggeri.
- Esteso: massimizza la profondità dell'analisi utilizzando modelli più pesanti.
Ogni livello qualitativo elenca i modelli Gemini utilizzati per ogni passaggio.
Specificare un singolo modello
Per eseguire tutti i passaggi di valutazione su un singolo modello anziché ottimizzare per livello, seleziona Utilizza invece un modello specifico e scegli un modello dall'elenco. Ogni modello è etichettato come Disponibilità generale o Anteprima.
Mainframe Assessment Tool supporta tutte le zone all'interno delle regioni di Agent Platform disponibili .
Applicare la residenza dei dati
Per impostazione predefinita, Mainframe Assessment Tool indirizza le chiamate ai modelli alla posizione ottimale per i modelli selezionati, inclusa la regione di valutazione, una regione multipla o l'endpoint globale di Agent Platform.
Per limitare le chiamate ai modelli alla regione di valutazione e alla regione multipla associata, attiva l'opzione Conserva i dati nella mia regione. Quando questa impostazione è attiva, Mainframe Assessment Tool esegue le seguenti azioni:
- Disattiva i livelli di qualità che richiedono un modello Gemini non disponibile nella regione di valutazione. Questi livelli sono etichettati come Non disponibile in questa regione.
- Nasconde i modelli dall'elenco dei modelli specifici che non sono disponibili nella regione di valutazione.
Se nella regione di valutazione non è disponibile alcun modello supportato, la valutazione non può essere eseguita con l'opzione Conserva i dati nella mia regione attiva. Per procedere con la valutazione, disattiva l'opzione Conserva i dati nella mia regione per consentire le chiamate ai modelli al di fuori della regione.
Se l'istanza di Mainframe Assessment Tool non ha un indirizzo IP esterno e attivi l'opzione Conserva i dati nella mia regione, i modelli forniti solo su un endpoint multi-regione potrebbero non essere disponibili. Questo accade perché l'accesso privato Google non può raggiungere gli endpoint multi-regione. Per rendere disponibili questi modelli rispettando i requisiti di residenza dei dati, configura la connettività privata all'endpoint multi-regione. Per istruzioni, vedi Configurare la connettività privata per la residenza dei dati.
Aggiungere file a una valutazione esistente
Dopo aver creato una valutazione, puoi aggiungere altri file ZIP. I file del nuovo file ZIP vengono uniti ai file esistenti nella valutazione. Se vuoi sostituire i file esistenti, il nuovo file ZIP deve includere i file che stai sostituendo con la stessa struttura di percorso.
Per aggiungere file a una valutazione esistente:
- Apri Mainframe Assessment Tool in un browser web.
- Nel menu di navigazione, fai clic su Valutazioni.
- Nella pagina Valutazioni, trova la valutazione che vuoi modificare, e fai clic su Apri valutazione.
- Fai clic su Aggiungi un file.
- Fai clic su Seleziona file e seleziona un file ZIP da caricare. Puoi caricare un solo file alla volta.
- Fai clic su Aggiungi.
Dopo aver caricato i file, Mainframe Assessment Tool riavvia l'analisi. Se sostituisci i file, questi vengono rivalutati completamente e l'analisi esistente per questi file potrebbe cambiare. Durante la rielaborazione, accanto ai file in fase di rielaborazione viene visualizzato un indicatore Non aggiornato.
Aggiornare i dettagli e le impostazioni della valutazione
Dopo aver creato una valutazione, puoi aggiornarne il nome e la descrizione e modificare le impostazioni degli approfondimenti generati dall'AI.
Per aggiornare i dettagli o le impostazioni della valutazione:
- Apri Mainframe Assessment Tool in un browser web.
- Nel menu di navigazione, fai clic su Valutazioni.
- Nella pagina Valutazioni, trova la valutazione che vuoi modificare, e fai clic su Apri valutazione.
- Fai clic su settingsModifica impostazioni di valutazione.
- (Facoltativo) Nel passaggio Dettagli valutazione , modifica il nome e la descrizione, quindi fai clic su Avanti.
- (Facoltativo) Nel passaggio Impostazioni AI, modifica le impostazioni dell'AI in base alle esigenze, quindi fai clic su Avanti.
- (Facoltativo) Nel passaggio Modello e livello qualitativo, configura i modelli o il livello qualitativo, quindi fai clic su Avanti. Per saperne di più, vedi Scegliere modelli e qualità.
- Nel passaggio Domini, fai clic su Avanti. Non puoi modificare i domini dopo aver creato una valutazione.
- Fai clic su Aggiorna valutazione.
Dopo aver aggiornato le impostazioni, Mainframe Assessment Tool riavvia l'analisi.