Personalizzazione con programmi sostituibili dall'utente

Un programma sostituibile dall'utente è un programma fornito da CICSche viene sempre richiamato in un punto particolare nell'elaborazione di CICS® , come se facesse parte del codice CICS . È possibile modificare il programma fornito includendo la propria logica oppure sostituirlo con una versione scritta personalmente.

Quando si creano le proprie versioni di programmi sostituibili dall'utente, è necessario seguire questa guida:
  • È possibile codificare programmi sostituibili dall'utente in uno qualsiasi dei linguaggi supportati da CICS (ovvero, in linguaggio assembler, COBOL, PL/I o C). Una versione in linguaggio assembler della maggior parte dei programmi viene fornita, in formato di origine, nella libreria CICSTS54.CICS.SDFHSAMP. Le versioni COBOL, PL/I o C sono fornite per alcuni programmi. La descrizione di ogni programma elenca i programmi di esempio, i copy book e le macro forniti in ogni caso.
  • È possibile eseguire il trap di una fine anomala in un programma sostituibile dall'utente eseguendo un comando EXEC CICS HANDLE ABEND . Tuttavia, se non viene emesso alcun HANDLE ABEND , CICS non termina l'attività ma restituisce il controllo al modulo CICS che ha richiamato il programma. L'azione intrapresa dal modulo CICS dipende dal programma sostituibile dall'utente interessato.
  • Al ritorno da qualsiasi programma sostituibile dall'utente, CICS deve sempre ricevere il controllo in modalità di conversione dello spazio primario, con il contenuto originale di tutti i registri di accesso ripristinati e con tutti i registri generali ripristinati (ad eccezione di quelli che forniscono codici di ritorno o informazioni di collegamento).

    Per informazioni sulle modalità di conversione, consultare z / Architecture Principles of Operation.

  • In z/OS®, non installare SVC o routine PC che restituiscono il controllo al chiamante in qualsiasi modalità autorizzata: ossia, nello stato supervisore, chiave PSW di sistema o APF autorizzata. Ciò è contrario al z/OS Dichiarazione di integrità. Se si richiamano tali servizi da CICS, si potrebbe compromettere l'integrità del sistema e qualsiasi problema risultante non verrà risolto dal servizio IBM® .
  • I programmi sostituibili dall'utente e tutti i programmi richiamati dai programmi sostituibili dall'utente possono essere RMODE ANY ma devono essere AMODE 31.
  • È necessario assicurarsi che i programmi sostituibili dall'utente siano definiti come locali. I programmi sostituibili dall'utente non possono essere eseguiti in una regione remota. Questa regola si applica a tutti i programmi sostituibili dall'utente, inclusi il programma di controllo di installazione automatica e il programma di instradamento dinamico.
  • I programmi sostituibili dall'utente producono solo dump di sistema quando si verifica un controllo del programma; non producono dump di transazione.
  • È possibile utilizzare EDF (Execution Diagnostic Facility) CICS per verificare i programmi sostituibili dall'utente. Tuttavia, EDF non funziona se la transazione iniziale è una transazione fornita da CICS.