

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 Integrazione gestita con Control-M
<a name="aws-mainframe-modernization-managed"></a>

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

Questa sezione presuppone i seguenti prerequisiti:
+ Un attivo. Account AWS
+ L'applicazione mainframe viene migrata ed eseguita in un ambiente di runtime gestito da AWS Replatform con Micro Focus con più processi batch definiti.
+ Per questo programma pilota, l'applicazione di BankDemo esempio è configurata in. Modernizzazione del mainframe AWS Per le istruzioni di configurazione, vedete [Tutorial: Managed Runtime for Micro Focus](https://docs.aws.amazon.com/m2/latest/userguide/tutorial-runtime.html).

I seguenti argomenti descrivono la step-by-step configurazione richiesta per l'integrazione tra Control-M Scheduler e l' Modernizzazione del mainframe AWS ambiente per diversi tipi di flussi di lavoro di integrazione:
+ [Distribuisci le risorse Control-M](deploy-control-m-resources.md)
+ [Creazione di un profilo di connessione Control-M per Modernizzazione del mainframe AWS](connection-profile.md)
+ [Creazione di lavori e pianificazioni in Control-M Planning](jobs-schedules-control-m.md)
+ [Monitoraggio dei lavori](monitor-jobs.md)

# Implementa le risorse Control-M
<a name="deploy-control-m-resources"></a>

I primi due passaggi per integrare AWS Mainframe Modernization con Control-M consistono nell'implementazione del plug-in e del tipo di lavoro.

## Distribuisci il plug-in Control-M Modernizzazione del mainframe AWS
<a name="deploy-plug-in"></a>

I plug-in forniscono integrazione e supporto per le applicazioni e i servizi orchestrati da Control-M. Per il servizio gestito, distribuisci il plug-in Modernizzazione del mainframe AWS . Modernizzazione del mainframe AWS 

L'implementazione del plug-in è un'attività poco frequente. Se installi il plug-in per la prima volta, segui i passaggi indicati nella documentazione di [Control-M](https://docs.bmc.com/docs/ctm_integrations/control-m-for-aws-mainframe-modernization-1244652367.html). Se disponi di un plug-in esistente che desideri utilizzare, salta questo passaggio e [crea un](connection-profile.md) profilo di connessione.

## Implementa un tipo di Modernizzazione del mainframe AWS lavoro in Control-M Application Integrator
<a name="deploy-job-type"></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](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)

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

1. Accedi ad Application Integrator.

1. Nella scheda **Home**, seleziona **Importa tipo di lavoro da file** e seleziona la posizione di `AIJOB.ctmai`.

1. Se desideri apportare modifiche all'esempio fornito, acquisisci familiarità con Application Integrator.

1. 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 per Modernizzazione del mainframe AWS
<a name="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](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_centralized_connection_profile.htm), è possibile utilizzare l'interfaccia utente grafica (GUI) disponibile nel dominio di **configurazione** dell'interfaccia Web Control-M oppure utilizzare JSON.](https://docs.bmc.com/docs/automation-api/monthly/connection-profiles-1116950312.html) [Per informazioni sul profilo di connessione del Modernizzazione del mainframe AWS plug-in, consulta la documentazione di Control-M.](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Mainframe_Modernization_Connection_Profiles.htm#AWSMainframeModernizationConnectionProfileParameters)

Il codice seguente è un esempio di utilizzo di JSON:

```
{
  "MANAGED-M2-REPLATFORM": {
    "Type": "ConnectionProfile:AWS Mainframe Modernization",
    "Mainframe Modernization URL": "https://m2.{{AwsRegion}}.amazonaws.com",
    "Connection Timeout": "30",
    "AWS Region": "us-west-2",
    "Authentication": "NoSecret",
    "IAM Role": "--- IAM Role name ---",
    "AWS Logs URL": "https://logs.{{AwsRegion}}.amazonaws.com",
    "Description": "",
    "Centralized": true
  }
}
```

Crea un file JSON simile all'esempio e distribuiscilo utilizzando il servizio di distribuzione dell'API [Control-M](https://docs.bmc.com/docs/automation-api/monthly/deploy-service-1116950327.html) Automation. Ad esempio, se il codice JSON viene salvato in un file denominato`cp-MANAGED-M2-REPLATFORM.json`, la sintassi `ctm` CLI per distribuire questo profilo di connessione è la seguente:

```
 ctm deploy cp-MANAGED-M2-REPLATFORM.json
```

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

```
[
  {
    "deploymentFile": "cp-Managed-M2-REPLATFORM.json",
    "deploymentState": "DEPLOYED_CONNECTION_PROFILES",
    "deploymentStatus": "ENDED_OK",
    "successfulFoldersCount": 0,
    "successfulSmartFoldersCount": 0,
    "successfulSubFoldersCount": 0,
    "successfulJobsCount": 0,
    "successfulConnectionProfilesCount": 1,
    "successfulDriversCount": 0,
    "isDeployDescriptorValid": false,
    "deployedConnectionProfiles": [
      "MANAGED-M2-REPLATFORM"
    ]
  }
]
```

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

Ora che hai il tipo di lavoro distribuito e un profilo di connessione per la connettività AWS, puoi iniziare a creare ed eseguire lavori.

Ogni lavoro di Modernizzazione del mainframe AWS servizio è costituito da un insieme 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
+ Pianificazione:
  + Mesi e giorni in cui questo lavoro può essere eseguito
  + Calendari, ad esempio periodi contabili aziendali, festività o altre date speciali che non possono essere definite algoritmicamente
  + Finestre temporali
  + Comportamento ciclico
+ 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 [nella GUI](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/Creating_a_Job.htm) o [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:
+ [Avvio dei lavori in base al codice di stato dei lavori precedenti](status-code.md)
+ [Automatizzazione delle esecuzioni dei lavori con una frequenza pianificata](scheduled.md)
+ [Esecuzioni del lavoro di base in base agli eventi](event-based.md)

# Avvio dei lavori in base allo stato dei lavori precedenti
<a name="status-code"></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 della GUI Web Control-M
<a name="using-gui"></a>

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

1. **Nel dominio **Planning**, aggiungi un nuovo Workspace.** Questo apre un canvas con un oggetto cartella vuoto.

1. Seleziona il tipo di Modernizzazione del mainframe AWS lavoro (se stai utilizzando il modello di tipo di lavoro fornito, si chiama [M2JOB](https://github.com/aws-samples/aws-mainframe-modernization-controlm-integration/blob/main/assets/AWS-jobs.json)) e trascinalo nella cartella.

1. Dopo che il colore del tipo di 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. Successivamente, sono necessari i valori **Job Name** per configurare i tipi di lavoro. Puoi trovare i valori del **Job Name** nella schermata di definizione dell'**applicazione** della Modernizzazione del mainframe AWS console o eseguendo l'[ListBatchJobDefinitions API](https://docs.aws.amazon.com/m2/latest/APIReference/API_ListBatchJobDefinitions.html). Per questo programma pilota, ripeti i passaggi da 2 a 4 per diversi lavori, assegnando a ciascuno il nome che preferisci. I nomi di esempio sono `CBANK``CURRENCY`, I, `NVFUNDS``BROKERAGE`, `RISKMGMT` e. `BANK-SERVICE-Managed-M2`

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 `CBANK` il quale si trova e trascinatelo sopra. `CURRENCY` Questa azione costituisce `CBANK` il predecessore di. `CURRENCY` Per impostazione predefinita, ora `CBANK` deve essere completata correttamente prima che CURRENCY diventi idonea all'esecuzione.

La schermata seguente mostra la visualizzazione Control-M Planning del flusso di lavoro di base.



![\[Job flow a sinistra e proprietà a destra.\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/control-m-batch-scheduler/images/workflow-control-m-web-1.png)


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

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

Lo stesso flusso può essere codificato in JSON:

```
{
  "Defaults": {
    "Application": "AWSM2",
    "SubApplication": "Replatform-Managed",
    "Job": {
      "Host": "ctm-worker",
      "Output": {}
    }
  },
  "jog-managed-m2": {
    "Type": "Folder",
    "ControlmServer": "psctm",
    "OrderMethod": "Manual",
    "SiteStandard": "_z_DemoBusinessFlows",
    "CBANK": {
      "Type": "Job:AWS Mainframe Modernization",
      "ConnectionProfile": "MANAGED-M2-REPLATFORM",
      "JCL Name": "iefbr14",
      "Retrieve CloudWatch Logs": "checked",
      "Action": "Start Batch Job",
      "Application Version": "1"
    },
    "CURRENCY": {
      "Type": "Job:AWS Mainframe Modernization",
      "ConnectionProfile": "MANAGED-M2-REPLATFORM",
      "JCL Name": "iefbr14",
      "Retrieve CloudWatch Logs": "checked",
      "Action": "Start Batch Job",
      "Application Version": "1"
    },
    "BROKERAGE": {
      "Type": "Job:AWS Mainframe Modernization",
      "ConnectionProfile": "MANAGED-M2-REPLATFORM",
      "JCL Name": "iefbr14",
      "Retrieve CloudWatch Logs": "checked",
      "Action": "Start Batch Job",
      "Application Version": "1"
    },
    "INVFUNDS": {
      "Type": "Job:AWS Mainframe Modernization",
      "ConnectionProfile": "MANAGED-M2-REPLATFORM",
      "JCL Name": "iefbr14",
      "Retrieve CloudWatch Logs": "checked",
      "Action": "Start Batch Job",
      "Application Version": "1"
    },
    "RISKMGMT": {
      "Type": "Job:AWS Mainframe Modernization",
      "ConnectionProfile": "MANAGED-M2-REPLATFORM",
      "JCL Name": "iefbr14",
      "Retrieve CloudWatch Logs": "checked",
      "Action": "Start Batch Job",
      "Application Version": "1"
    },
    "BANK-SERVICE-Managed-M2": {
      "Type": "Job:SLAManagement",
      "ServiceName": "Bank Service - Managed M2",
      "RunAs": "ctmagent",
      "CompleteBy": {
        "Time": "12:00",
        "Days": "0"
      }
    },
    "leftbranch": {
      "Type": "Flow",
      "Sequence": [
        "CURRENCY",
        "RISKMGMT",
        "BANK-SERVICE-Managed-M2"
      ]
    },
    "middlebranch": {
      "Type": "Flow",
      "Sequence": [
        "CBANK",
        "CURRENCY",
        "INVFUNDS",
        "BANK-SERVICE-Managed-M2"
      ]
    },
    "rightbranch": {
      "Type": "Flow",
      "Sequence": [
        "CURRENCY",
        "BROKERAGE",
        "BANK-SERVICE-Managed-M2"
      ]
    }
  }
}
```

Per distribuire questo flusso, utilizza il servizio di distribuzione:

```
ctm deploy folder-MANAGED-M2-REPLATFORM.json
```

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

Utilizzando il flusso creato nei passaggi precedenti, puoi aggiungere la pianificazione di base e del runtime.
+ La pianificazione di base definisce in quali giorni può essere eseguito un lavoro (ad esempio, ogni giorno della settimana, solo nei giorni lavorativi, alla fine del mese o alla fine del trimestre).
+ La pianificazione del runtime determina quando un lavoro verrà eseguito nel giorno in cui è idoneo all'esecuzione (ad esempio, ogni ora, dopo la disponibilità di risorse specifiche o solo dopo la conferma manuale).

Puoi impostare la pianificazione di base e del runtime alla scheda **Pianificazione**.

# Esecuzioni del lavoro di base in base agli eventi
<a name="event-based"></a>

Control-M Managed File Transfer (MFT) è un FTP/SFTP client e un server che è possibile utilizzare per guardare e trasferire file tra un host locale e un host remoto. Per ulteriori informazioni sulla definizione di un processo di trasferimento file, consulta la [documentazione di Control-M](https://documents.bmc.com/supportu/9.0.21/en-US/Documentation/File_Transfer_Job.htm).

Questo programma pilota utilizza il lavoro di trasferimento file per verificare la presenza di un evento di creazione di un file con estensione .poc nella cartella `/bmcfile` in un bucket S3 denominato `bmc-poc-bucket`. Quando si verifica tale evento, il lavoro Control-M viene avviato per eseguire il lavoro successivo. Facoltativamente, puoi trasferire il percorso completo, incluso il nome del bucket.

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

È possibile monitorare e convalidare l'elaborazione dei lavori all'interno del dominio Control-M Monitoring e tramite Console di gestione AWS, garantendo un'osservazione e una verifica complete su entrambe queste piattaforme.

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

Gli invii e le esecuzioni dei lavori possono essere monitorati nel *dominio Monitoraggio di Control-M.* Per impostazione predefinita, i job Modernizzazione del mainframe AWS di servizio 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.

Per seguire i passaggi dettagliati, consulta 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 i lavori in verde. Sul lato destro, il flusso di lavoro ha avuto esito positivo solo in parte perché il processo ha `CURRRENCY` **restituito lo stato Non riuscito**, indicato dal colore rosso. Il flusso di lavoro si è fermato lì, lasciando i lavori rimanenti nello stato **Wait Schedule**.



![\[Diagrammi dei flussi di lavoro a sinistra, proprietà dei lavori a destra.\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/control-m-batch-scheduler/images/monitor-jobs.png)


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

## Monitoraggio sulla console
<a name="console"></a>

Per visualizzare le informazioni sul lavoro e accedere AWS, accedi a Console di gestione AWS, quindi accedi alla [Modernizzazione del mainframe AWS console](https://console.aws.amazon.com/m2/home?region=us-east-1#/applications). 



![\[Lavori e stati elencati nella console AWS Mainframe Modernization.\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/control-m-batch-scheduler/images/monitor-jobs-aws-management-console.png)


Questa visualizzazione non include le dipendenze né alcun carico di lavoro che non sia gestito dal servizio. Modernizzazione del mainframe AWS 