Impostazione delle preferenze per i convertitori XML di COBOL

Modifica online

Per impostare le preferenze per i convertitori XML di COBOL, aprire la pagina Convertitori XML di COBOL nelle preferenze di Enterprise Service Tools.

Queste preferenze influiscono sui progetti a servizio singolo, inclusi:

Servizi Web per CICS®
Progetto JSON Services forCICS
Trasformazione XML per CICS
IMS Enterprise Suite SOAP Gateway
Lotto, TSO, z/OS® UNIX System Services

Queste preferenze influenzano il modo in cui i programmi di conversione XML in runtime generati dalle procedure guidate per singolo servizio negli Enterprise Service Tools convertono i dati tra il formato XML utilizzato nelle richieste e nelle risposte dei servizi e le strutture dati di linguaggio di alto livello utilizzate da COBOL :

Per impostare le preferenze di creazione per programmi di conversione XML di runtime:

Nel riquadro sinistro della finestra Preferenze, selezionare Enterprise Service Tools.

Modificare le preferenze:

Le preferenze nella scheda Base sono descritte nella seguente tabella:

Preferenza:	Effetto di questa preferenza:
Prefisso nome programma di conversione	Questo campo di immissione specifica il gambo del nome del programma che viene incluso nella DIVISIONE IDENTIFICATIVA di ogni programma generato COBOL. Se si immette ACCT, ad esempio, la procedura guidata identifica il programma di conversione di input come ACCTI, il programma di conversione di output come ACCTO e il driver come ACCTD
nome author	Questo campo di immissione specifica la stringa di caratteri da includere nel paragrafo AUTORE di ogni programma COBOL generato.
Code page richiesta	Questa casella di elenco specifica la codepage da utilizzare per la codifica del messaggio XML di richiesta .
Code page host	Questa casella di elenco specifica la codepage utilizzata dal sistema host z/OS .
Code page di risposta	Questa casella di elenco specifica la codepage da utilizzare per la codifica del messaggio XML response .
Il punto decimale è una virgola	Questa casella di spunta controlla il modo in cui i caratteri virgola e punto vengono interpretati in stringhe numeriche: Quando si seleziona questa casella di spunta: Una virgola viene interpretata come virgola decimale. Un punto viene interpretato come separatore delle migliaia. Quando si deseleziona questa casella di spunta (questa è l'impostazione predefinita): Una virgola viene interpretata come separatore delle migliaia. Un punto viene interpretato come un punto decimale.

Le preferenze nella scheda Avanzate sono le seguenti:
- Nel gruppo Specifica opzioni di generazione schema XML :
  Genera gerarchia minima in schemi XML
  Questa casella di spunta controlla il formato del messaggio dello schema XML generato e di conseguenza l'analisi e la generazione di XML nei convertitori XML. I programmi di conversione XML basati su schemi XML con gerarchie ridotte tendono ad avere prestazioni migliori.
  - Selezionare questa casella di spunta se si desidera che i programmi di conversione XML vengano generati in modo da utilizzare una gerarchia di strutture XML ridotta, quando non è necessaria una gerarchia di strutture più dettagliata per identificare in modo univoco ciascun elemento nella struttura.
    Quando ci sono elementi con lo stesso nome tag, il nome dell'elemento che si verifica successivamente nel documento ha come prefisso il numero di tag principali richiesto per produrre un nome univoco. Questo metodo aumenta l'efficacia dei client di elaborazione dei messaggi e riduce il numero e la complessità degli oggetti che devono essere istanziati.
  - Deselezionare questa casella di spunta se si desidera che la procedura guidata generi uno schema XML che rappresenta la gerarchia completa della struttura del linguaggio.
  Genera gruppi in schemi XML
  Questa casella di spunta controlla se il convertitore XML include i gruppi negli schemi XML generati:
  - Selezionare questa check box se si desidera che il convertitore XML includa i gruppi negli schemi XML generati.
  - Deselezionare questa casella di spunta se si desidera che il programma di conversione XML includa il "contenuto" del gruppo in linea invece di utilizzare i riferimenti del gruppo. Questa opzione è utile per le applicazioni che non supportano l'utilizzo di gruppi e riferimenti di gruppi negli schemi XML.
  Genera nomi di tipi complessi brevi
  
  Il metodo normale per generare un nome di tipo complesso è quello di concatenare il nome del gruppo ai nomi di tutti i parent del gruppo, con un carattere di sottolineatura "_" dopo ogni nome tranne l'ultimo.
  
  Tuttavia, se questa casella di controllo è selezionata, viene generato un nome di tipo complesso prendendo solo il nome del gruppo.
  Ad esempio, in questo gruppo COBOL :
```
01 ServiceRequest.
  02 CommonHeader.
    05 HeaderType1.
      10 Element1     PIC X(10).
```
  il nome del tipo XML complesso per l'elemento HeaderType1 è:
  - servicerequest_commonheader_headertype1 se la casella di controllo non è selezionata.
  - HeaderType1 se la casella di spunta è selezionata.
  La riduzione dei nomi dei tipi complessi consente la generazione di codice client più compatto (di solito, codice classe Java™ ) dai file WSDL e XSD contenenti i tipi XML complessi.
  
  L'impostazione di questa casella di controllo non ha alcun effetto sugli scenari top-down o meet - in - middle.
  Quando si tenta di abbreviare un nome di tipo complesso, è possibile una collisione se il nome breve del tipo già esiste come risultato di un tipo precedentemente definito per un gruppo con un nome identico ma nomi di gruppo principale differenti. Ad esempio, nella seguente struttura COBOL :
```
01 ServiceRequest.
  02 CommonHeader.
    05 HeaderType.
      10 Element         PIC X(10).
  02 SpecificHeader.
    05 HeaderType.
      10 Element         PIC X(10).
```
  il nome tipo del gruppo HeaderType in SpecificHeader è in conflitto con quello del gruppo HeaderType in CommonHeader.
  In caso di collisione, tutti i nomi in collisione conservano i nomi di tipo long originali. Di conseguenza, in base a questo esempio, i nomi tipo risultanti sono:
  - servicerequest_commonheader_headertype e
  - servicerequest_specificheader_headertype.
  Il nome breve per un tipo complesso è formato prendendo il nome dell'elemento XML che ha quel tipo, più alcune possibili modifiche. Le regole per formare nomi brevi sono:
  1. Prendere il nome dell'elemento XML che ha il tipo (come HeaderType1).
  2. Se il nome inizia con un carattere non valido per i nomi Java (ad esempio, una cifra), viene preceduto da un doppio carattere di sottolineatura "__".
  3. Se nel nome originale del gruppo COBOL è presente un trattino "-", questo viene sostituito da un singolo trattino basso "_".
  4. Il carattere maiuscolo / minuscolo del nome gruppo viene conservato.
  Ad esempio, il seguente gruppo:
```
03 2-In--B.
   04 var2 blank zero pic 999.99.
```
  risulta nel nome del tipo complesso abbreviato __2_In__B.
  Genera commenti in XSD
  
  Selezionare questa casella di controllo per far sì che i commenti del file di codice sorgente COBOL vengano generati come documentazione di annotazione nei file XSD e WSDL generati (vedere Inclusione dei commenti del codice sorgente COBOL nei file XSD e WSDL generati )
  
  Questa opzione si applica solo allo scenario di sviluppo dal basso verso l'alto per la generazione di un servizio Web e si applica solo se si specifica Conversione XML compilata.
  
  Genera elementi XML completi negli schemi XML
  
  Questa casella di controllo consente la creazione di elementi XML qualificati negli schemi XML.
  Ciò consente all'opzione di richiedere che tutti gli elementi XML siano qualificati con uno spazio dei nomi e supportino la generazione di schemi XML che possono essere inclusi in altri schemi con minori possibilità di conflitto di spazi dei nomi.
- Nel gruppo Specifica comportamento convertitore XML richiesta :
  
  Convalida il nome dello spazio dei nomi dell'elemento root
  
  Selezionare questa casella di controllo per abilitare la convalida dello spazio dei nomi di destinazione dell'elemento root nei documenti XML. Lo spazio dei nomi di destinazione dell'elemento root si trova nello schema XML che lo definisce.
  
  Utilizzare i valori letterali VALUE per inizializzare gli elementi di dati omessi
  
  Selezionare questa casella di controllo per abilitare l'inizializzazione degli elementi di dati nella struttura del linguaggio di richiesta che sono stati esclusi dalla struttura dei dati di ingresso del servizio Web (vedere Inizializzazione degli elementi di dati nella struttura dei dati di ingresso dell'applicazione COBOL ).
  
  Questa opzione si applica solo allo scenario di sviluppo dal basso verso l'alto per la generazione di un servizio Web e si applica solo se si specifica Conversione XML compilata.
  
  Utilizzare i valori letterali VALUE per inizializzare gli elementi di dati vuoti
  
  Selezionare questa casella di controllo per abilitare l'inizializzazione degli elementi di dati nella struttura del linguaggio di richiesta che sono stati inclusi nella struttura dei dati di ingresso del servizio Web (vedere Inizializzazione degli elementi di dati nella struttura dei dati di ingresso dell'applicazione COBOL ).
  
  Questa opzione si applica solo allo scenario dal basso verso l'alto per la generazione di un servizio Web e si applica solo se si specifica Conversione XML compilata.
- Nel gruppo Specifica comportamento converter XML di risposta :
  Dati lingua
  Questa opzione controlla il modo in cui il programma di conversione XML del runtime della risposta gestisce i caratteri nei dati della risposta COBOL che sono illegali nella specifica XML 1.0 :
  - Selezionare Caratteri di filtro non validi in XML 1.0 se si desidera che il programma di conversione esegua la scansione di dati non numerici e numerici nella struttura del linguaggio e converta qualsiasi carattere non consentito nella specifica XML 1.0 in uno spazio EBCDIC, ASCII o UNICODE (a seconda della codepage response ).
  - Selezionare Arrestare i caratteri non consentiti in XML 1.0 se si desidera che il programma di conversione esegua la scansione dei dati non numerici e numerici nella struttura del linguaggio e causi un'eccezione se vengono rilevati caratteri non validi in XML 1.0 .
  - Selezionare Non verificare la presenza di caratteri non consentiti se si desidera che il programma di conversione non verifichi la presenza di caratteri non consentiti nella specifica XML 1.0 .
  Per ulteriori informazioni, vedere Opzioni per la gestione dei caratteri XML non validi.
- Nel gruppo Specifica preferenze correlate al compilatore :
  
  Ottimizzazione
  
  Selezionare se l'opzione di ottimizzazione è abilitata per il compilatore COBOL. Quando la casella di controllo è selezionata, il compilatore COBOL utilizzerà l'ottimizzazione nella generazione del codice di runtime dal codice sorgente COBOL.
  Se si sta cercando di eseguire il debug di un errore di compilazione nel codice sorgente di COBOL, è una buona idea deselezionare questa casella di controllo e ricompilare. Senza l'ottimizzazione attivata, è più facile determinare quale parte del codice sorgente di COBOL causa l'errore.
  
  Specificare la versione del compilatore Enterprise COBOL
  
  Selezionare la versione del compilatore COBOL che si desidera utilizzare.
Al termine, fare clic su OK .