

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

# Modernizzazione del mainframe AWS sull'integrazione di Amazon EC2 con Control-M
<a name="aws-mainframe-modernization-ec2"></a>

Questa sezione descrive come Control-M si integra e supporta i processi batch eseguiti in un ambiente di runtime AWS Mainframe Modernization personalizzato distribuito su un'istanza EC2. Se stai implementando l'ambiente di runtime AWS Replatform with Micro Focus completamente gestito, consulta la sezione [Modernizzazione del mainframe AWS Integrazione gestita con Control-M](aws-mainframe-modernization-managed.md).

Questa sezione presuppone i seguenti prerequisiti:
+ Un account AWS attivo.
+ Un cloud privato virtuale (VPC) in cui verranno create le istanze EC2.
+ L'applicazione mainframe viene migrata ed eseguita in un ambiente AWS Replatform with Micro Focus su un'istanza EC2 e supporta il motore di runtime Micro Focus con più processi batch definiti. Per questo programma pilota, segui le istruzioni riportate in [Replatforming](https://docs.aws.amazon.com/m2/latest/userguide/replatforming-m2.html) applications with Micro Focus. La documentazione include tutte le attività e informazioni aggiuntive sulla configurazione e il funzionamento dell'ambiente di runtime AWS Replatform with Micro Focus su Amazon EC2.

I seguenti argomenti trattano la configurazione richiesta per l'integrazione tra Control-M e l'ambiente AWS Replatform with Micro Focus:
+ [Implementate le risorse Control-M e Micro Focus](deploy-resources-environment.md)
+ [Crea un profilo di connessione Control-M](create-control-m-connection-profile.md)
+ [Creazione di lavori e pianificazioni in Control-M Planning](create-jobs-schedules-control-m-planning.md)
+ [Gestisci le esecuzioni dei job in Control-M utilizzando Monitoring](monitor.md)

# Implementate le risorse Control-M e Micro Focus
<a name="deploy-resources-environment"></a>

I primi due passaggi per integrare AWS Mainframe Modernization con Control-M consistono nell'implementazione di un agente Control-M e quindi nella distribuzione di un plug-in sull'agente. Il terzo passaggio consiste nell'implementare il tipo di lavoro in Control-M Application Integrator.

## Implementa un agente Control-M su un'istanza EC2
<a name="deploy-agent"></a>

Quando si utilizza un ambiente di runtime AWS Replatform personalizzato con Micro Focus on Amazon EC2, `MFBSIFJCL` viene richiamata l'utilità. L'utilità funziona sull'host che è stato lanciato utilizzando l'offerta Micro Focus Enterprise Server di. Marketplace AWS Per eseguire l'`MFBSIFJCL`utilità, è inoltre necessario distribuire un agente Control-M su quell'host. [Per istruzioni, consulta la documentazione di Control-M.](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Agent_Installation.htm)

**Nota**  
È possibile scaricare i supporti di installazione richiesti dal sito [BMC Electronic Product](https://www.bmc.com/support/resources/product-downloads.html) Download.

## Implementate il plug-in Micro Focus su Control-M Agent
<a name="deploy-plug-in"></a>

I plug-in forniscono integrazione e supporto per le applicazioni e i servizi orchestrati da Control-M.

L'implementazione dei plug-in è un'attività poco frequente. Se disponi già di un plug-in che desideri utilizzare, salta questo passaggio e crea un profilo di connessione.

Su Amazon EC2, il servizio Modernizzazione del mainframe AWS Replatform with Micro Focus espone il motore Micro Focus. Per l'integrazione Modernizzazione del mainframe AWS, Control-M utilizza il plug-in Micro Focus. Per ulteriori informazioni, consultate la documentazione di [Control-M](https://docs.bmc.com/docs/ctm_integrations/control-m-for-micro-focus-1193641959.html).

È necessario distribuire questo plug-in su un agente installato su un host su cui è in esecuzione Micro Focus Enterprise Server.

## Implementate un tipo di Modernizzazione del mainframe AWS lavoro in Control-M Application Integrator
<a name="application-integrator"></a>

L'implementazione del tipo di lavoro è in genere un'attività una tantum. Se disponi già di un tipo di lavoro che desideri utilizzare, ignora questa fase e passa a quella successiva di [creazione di un profilo di connessione](create-control-m-connection-profile.md).

Il tipo di lavoro di esempio [AIJOB.ctmai](https://github.com/aws-samples/aws-mainframe-modernization-controlm-integration/blob/main/assets/AIJOB.ctmai) è fornito nel repository git. [Per distribuire un tipo di job, è necessario eseguire le seguenti operazioni utilizzando Application Integrator:](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Application_Integrator.htm)
+ Clona il GitHub repository [aws-mainframe-modernization-controlm-integration](https://github.com/aws-samples/aws-mainframe-modernization-controlm-integration) e scarica il `AIJOB.ctmai` file in una posizione del file system accessibile da Application Integrator.
+ Accedi ad Application Integrator.
+ Nella scheda **Home**, seleziona **Importa tipo di lavoro da file** e seleziona la posizione di `AIM2JOB.ctmai`.
+ Se desideri apportare modifiche all'esempio fornito, acquisisci familiarità con Application Integrator.
+ Implementa il tipo di lavoro seguendo le istruzioni nella [documentazione Control-M](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Deploying_and_Publishing_a_Plug-in.htm).

# Crea un profilo di connessione Control-M
<a name="create-control-m-connection-profile"></a>

I profili di connessione definiscono gli attributi di connessione e le credenziali di sicurezza per un'istanza specifica di un'applicazione. Ogni profilo di connessione può essere referenziato da più lavori. È possibile disporre di profili separati per ogni combinazione univoca di applicazione e credenziali.

Per definire i profili di connessione, è possibile utilizzare il [dominio di configurazione](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_centralized_connection_profile.htm) dell'interfaccia Web Control-M oppure utilizzare JSON. Il codice seguente è un esempio di utilizzo di JSON:

```
{
  "MICROFOCUS-WINDOWS": {

  "Type": "ConnectionProfile:Micro Focus Windows",
  "Centralized": true,
  "Description": "Micro Focus on Windows Connection Profile - file locations refer to the Enterprise Server host", "MFBSI Config Path": "C:\\microfocus\\ES\\mfbsi\\MFWIN\\mfbsi.cfg",
  "MFBSI Directory Path": "c:\\microfocus\\es\\mfbsi\\MFWIN",
  "Runtime Environment": "\"C:\\Program Files (x86)\\Micro Focus\\Enterprise Developer\\createenv.bat\"", "Run As": "dbauser",
  "RunAs-Pass": "*****"
  }
}
```

Il codice di esempio si trova `ConnectionProfile-Custom-M2-Replatform.json` nel file del GitHub repository. Per distribuire il codice, utilizza il servizio di distribuzione dell'API Control-M Automation:

```
ctm deploy ConnectionProfile-Custom-M2-Replatform.json
```

La risposta dell'API Control-M Automation sarà simile alla seguente:

```
[ 
 {
    "deploymentFile": "cp-JOG-MF-WINDOWS.json", 
    "deploymentState": "DEPLOYED_CONNECTION_PROFILES", 
    "deploymentStatus": "ENDED_OK", 
    "successfulFoldersCount": 0, 
    "successfulSmartFoldersCount": 0, 
    "successfulSubFoldersCount": 0,
    "successfulJobsCount": 0, 
    "successfulConnectionProfilesCount": 1, 
    "successfulDriversCount": 0, 
    "isDeployDescriptorValid": false, 
    "deployedConnectionProfiles": [ " MICROFOCUS-WINDOWS " ]
  }
]
```

# Creazione di lavori e pianificazioni in Control-M Planning
<a name="create-jobs-schedules-control-m-planning"></a>

Ora che avete il plug-in distribuito e un profilo di connessione per la connettività Micro Focus, potete iniziare a creare ed eseguire lavori.

Ogni job Control-M for Micro Focus è costituito da una serie di attributi, suddivisi in quattro sezioni. Ogni sezione può avere molti attributi. L'elenco seguente mostra alcuni degli attributi più comunemente usati.
+ Generale:
  + Il nome del lavoro
  + L'applicazione e la sottoapplicazione a cui appartiene il lavoro
  + Il JCL da presentare
  + Un collegamento alla documentazione operativa fornita dal sito
+ Pianificazione:
  + Mesi e giorni in cui questo lavoro può essere eseguito
  + Calendari come periodi contabili aziendali, festività o altre date speciali che non possono essere definite algoritmicamente
  + Finestre temporali
  + Comportamento ciclico, ad esempio correre ogni ora
+ Prerequisiti
  + Dipendenze a monte (in genere lavori, che devono essere completati correttamente prima che questo processo diventi idoneo all'esecuzione)
  + Risorse che potrebbero essere necessarie
  + Azione dell'utente che potrebbe essere richiesta
+ Azioni eseguite da Control-M al completamento del lavoro:
  + Determinazione del successo o del fallimento del lavoro (in genere in base ai codici di completamento del lavoro, ma è possibile ignorare tale impostazione per utilizzare il testo di output o i controlli relativi a uno stato specifico)
  + Notifiche, ad esempio e-mail, in caso di fallimento o riuscita
  + Stato di pubblicazione per le dipendenze a valle

Come per i profili di connessione, i lavori possono essere creati e distribuiti [utilizzando Control-M Web](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_Job.htm) o [scritti in JSON](https://docs.bmc.com/docs/automation-api/monthly/code-reference-1116950299.html) e distribuiti utilizzando l'API Control-M Automation.

Le seguenti sezioni esaminano alcuni scenari di flusso di lavoro comuni:
+ [Avvia i lavori utilizzando un flusso di lavoro](initiate-jobs.md)
+ [Automatizzazione delle esecuzioni dei lavori con una frequenza pianificata](automate-jobs.md)

# Avviare i lavori utilizzando un flusso di lavoro
<a name="initiate-jobs"></a>

Crea un flusso di lavori chiamato flusso di lavoro. I lavori nel flusso di lavoro sono interconnessi e dipendono dal corretto completamento dei lavori precedenti.

## Utilizzo di Control-M Web
<a name="control-m-web"></a>

Per avviare un processo dall'interfaccia utente Control-M, effettuate le seguenti operazioni:

1. Nel dominio Pianificazione, aggiungi un nuovo Spazio di lavoro. Questo apre un canvas con un oggetto cartella vuoto.

1. Nella barra dei menu, scegliete **Aggiungi lavoro**, scegliete il lavoro Micro Focus Windows o Micro Focus Linux e trascinatelo sulla parte anteriore della cartella.

1. Dopo che il colore del lavoro diventa verde, rilascialo. Il riquadro a destra contiene le sezioni **Generale**, **Pianificazione**, **Prerequisiti** e **Azioni**. Per creare il lavoro, consulta le istruzioni standard nella documentazione di [Control-M](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_Job.htm).

1. [Per istruzioni sulla creazione di un job Control-M for Micro Focus, consultate la documentazione Control-M.](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Jobs_for_Mainframe_Modernization.htm#MicroFocusJob) Per questo progetto pilota, ripetete i passaggi da 2 a 4 per cinque lavori, denominando ciascuno da a. `aws-mf-job1` `aws-mf-job5`

1. Per connettere questi lavori al flusso desiderato, scegliete il triangolo delle condizioni sotto l'oggetto del lavoro e trascinatelo sul lavoro successivo. Ad esempio, scegliete il triangolo delle condizioni sotto `aws-mf-job1` il quale si trova e trascinatelo sopra. `aws-mf-job2` Questa azione costituisce `aws-mf-job1` il predecessore di. `aws-mf-job2` Per impostazione predefinita, ora `aws-mf-job1` deve essere completata con successo prima di `aws-mf-job2` diventare idonea alla corsa.

Il diagramma seguente mostra la vista Control-M Planning del flusso di lavoro di base.



![\[Diagramma del flusso di lavoro, con le proprietà nel riquadro a destra.\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/control-m-batch-scheduler/images/control-m-web-planning.png)


*Immagine fornita per gentile concessione di BMC Software, Inc. ©2022*

## Utilizzo di JSON
<a name="json"></a>

Lo stesso flusso può essere codificato in JSON. Nel GitHub repository, il codice di esempio si trova nel file: `Folder-Custom-M2-Replatform.json`

```
{
  "aws-custom-m2": {
    "Type": "Folder",
    "ControlmServer": "psctm",
    "OrderMethod": "Manual",
    "Application": "AWSM2",
    "SubApplication": "Replatform-Custom",
    "aws-mf-job1": {
      "Type": "Job:Micro Focus Windows",
      "ConnectionProfile": "MICROFOCUS-WINDOWS",
      "Enable JCL Variables": "unchecked",
      "Restart on Rerun": "unchecked",
      "Recapture ABEND Codes": "Ignore",
      "Recapture COND Codes": "Ignore",
      "Auto Adjust Restart": "Ignore",
      "Set MF_UCC11": "Ignore",
      "Restart with Modified JCL": "No",
      "Application": "AWSM2",
      "SubApplication": "Replatform-Custom",
      "Host": "microfocus-es-host",
      "Output": {}
    },
    "aws-mf-job2": {
      "Type": "Job:Micro Focus Windows",
      "ConnectionProfile": "MICROFOCUS-WINDOWS",
      "Enable JCL Variables": "unchecked",
      "Restart on Rerun": "unchecked",
      "Recapture ABEND Codes": "Ignore",
      "Recapture COND Codes": "Ignore",
      "Auto Adjust Restart": "Ignore",
      "Set MF_UCC11": "Ignore",
      "Restart with Modified JCL": "No",
      "Application": "AWSM2",
      "SubApplication": "Replatform-Custom",
      "Host": "microfocus-es-host",
      "Output": {}
    },
    "aws-mf-job3": {
      "Type": "Job:Micro Focus Windows",
      "ConnectionProfile": "MICROFOCUS-WINDOWS",
      "Enable JCL Variables": "unchecked",
      "Restart on Rerun": "unchecked",
      "Recapture ABEND Codes": "Ignore",
      "Recapture COND Codes": "Ignore",
      "Auto Adjust Restart": "Ignore",
      "Set MF_UCC11": "Ignore",
      "Restart with Modified JCL": "No",
      "Application": "AWSM2",
      "SubApplication": "Replatform-Custom",
      "Host": "microfocus-es-host",
      "Output": {}
    },
    "aws-mf-job4": {
      "Type": "Job:Micro Focus Windows",
      "ConnectionProfile": "MICROFOCUS-WINDOWS",
      "Enable JCL Variables": "unchecked",
      "Restart on Rerun": "unchecked",
      "Recapture ABEND Codes": "Ignore",
      "Recapture COND Codes": "Ignore",
      "Auto Adjust Restart": "Ignore",
      "Set MF_UCC11": "Ignore",
      "Restart with Modified JCL": "No",
      "Application": "AWSM2",
      "SubApplication": "Replatform-Custom",
      "Host": "microfocus-es-host",
      "Output": {}
    },
    "aws-mf-job5": {
      "Type": "Job:Micro Focus Windows",
      "ConnectionProfile": "MICROFOCUS-WINDOWS",
      "Enable JCL Variables": "unchecked",
      "Restart on Rerun": "unchecked",
      "Recapture ABEND Codes": "Ignore",
      "Recapture COND Codes": "Ignore",
      "Auto Adjust Restart": "Ignore",
      "Set MF_UCC11": "Ignore",
      "Restart with Modified JCL": "No",
      "Application": "AWSM2",
      "SubApplication": "Replatform-Custom",
      "Host": "microfocus-es-host",
      "Output": {}
    },
    "leftbranch": {
      "Type": "Flow",
      "Sequence": [
        "aws-mf-job1",
        "aws-mf-job2",
        "aws-mf-job3",
        "aws-mf-job5"
      ]
    },
    "rightbranch": {
      "Type": "Flow",
      "Sequence": [
        "aws-mf-job2",
        "aws-mf-job4",
        "aws-mf-job5"
      ]
    }
  }
}
```

Per distribuire questo flusso, utilizza l'API Control-M Automation:

```
ctm deploy Folder-Custom-M2-Replatform.json
```

# Automatizzazione delle esecuzioni dei lavori con una frequenza pianificata
<a name="automate-jobs"></a>

Utilizzando il flusso creato nei passaggi precedenti, puoi aggiungere la pianificazione di base e del runtime.
+ La pianificazione di base definisce i giorni in cui un job è idoneo all'esecuzione (ad esempio, ogni giorno della settimana, solo nei giorni lavorativi, a fine mese o a fine trimestre). [È possibile impostare la pianificazione di base nella scheda Pianificazione.](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Job_scheduling.htm)
+ La pianificazione del runtime determina quando un processo viene eseguito nel giorno in cui è idoneo all'esecuzione (ad esempio, dopo il completamento dei lavori precedenti, ogni ora, dopo la disponibilità di risorse specifiche o solo dopo la conferma manuale).

**È possibile definire alcune pianificazioni di runtime nella sezione Pianificazione e altre nella sezione **Prerequisiti**.**

# Monitoraggio dei lavori
<a name="monitor"></a>

È possibile monitorare e verificare i lavori nel dominio Control-M Monitoring e nell'interfaccia utente [Common Web Administration di Micro Focus Enterprise Server](https://www.microfocus.com/documentation/visual-cobol/vc70/CSWin/GUID-C7A333B6-1DFB-49AC-8DB3-4023C6FCDEFB.html).

## Monitoraggio di Control-M
<a name="monitoring"></a>

Gli invii e le esecuzioni dei lavori possono essere monitorati nel dominio Monitoraggio di Control-M. Per impostazione predefinita, i lavori Modernizzazione del mainframe AWS di assistenza verranno visualizzati insieme a tutti gli altri lavori di Control-M. Se desideri visualizzare solo i lavori di Modernizzazione del mainframe AWS assistenza senza altri carichi di lavoro (o altri requisiti di filtraggio), puoi creare un Viewpoint.

I punti di vista non solo mostrano le informazioni sul lavoro, ma anche le relazioni con le dipendenze a monte e a valle. Inoltre, se il tuo flusso di lavoro include Modernizzazione del mainframe AWS altri tipi di job Control-M, puoi visualizzare e gestire l'intero flusso nel dominio Monitoring.

Puoi seguire i passaggi dettagliati visitando la [sezione Viewpoints di Monitoring nella documentazione di Control-M](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Viewpoints.htm).

La schermata seguente mostra gli output di due flussi di lavoro. Sul lato sinistro, il flusso di lavoro viene completato correttamente con tutti e cinque i lavori in verde. Sul lato destro, il flusso di lavoro ha esito positivo solo in parte perché è stato `aws-mf-job3` restituito lo stato **Non riuscito** e il flusso di lavoro si è fermato lì, lasciando lo stato **Wait `aws-mf-job5`** Schedule.



![\[Diagrammi del flusso di lavoro sul lato sinistro, monitoraggio dell'output nella scheda Output nel riquadro a destra.\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/control-m-batch-scheduler/images/monitor-jobs-2.png)


*Immagine fornita per gentile concessione di BMC Software, Inc. ©2022*