Proprietà CWF per tipi data/ora del tipo semplice integrato

Le proprietà Custom Wire Format qui descritte sono applicabili a:

Rappresentazione fisica

Proprietà Tipo Spiegazione
Tipo fisico Tipo numerato Selezionare uno dei seguenti valori nell'elenco a discesa:
  • Stringa a lunghezza fissa. La lunghezza dell'elemento è determinata dalle altre proprietà di lunghezza riportate di seguito.
  • Stringa con lunghezza codificata 1. Nel byte del primo elemento è contenuta la lunghezza della stringa seguita dai byte di lunghezza in unità di lunghezza. La lunghezza massima di un elemento Stringa con lunghezza codificata 1 è 255 unità di lunghezza.
  • Stringa con lunghezza codificata 2. Nei due byte del primo elemento è contenuta la lunghezza della stringa seguita dai 2 byte di lunghezza in unità di lunghezza. La lunghezza massima di un elemento Stringa con lunghezza codificata 2 è 65535 unità di lunghezza. I due byte di lunghezza sono nel formato di codifica del gestore code WebSphere MQ.
  • Stringa terminata con valore nullo. La stringa termina con il carattere esadecimale NULL, X'00'.
  • Decimale compresso. Il valore data/ora è codificato come numero Decimale compresso. E' valido solo se la proprietà Formato data/ora rappresenta soli dati numerici.
  • Binario. Il valore data/ora è codificato come una sequenza binaria di byte. Se si seleziona questa opzione, il numero di simboli possibili per la proprietà Stringa formato è minore del numero di simboli possibili se si seleziona un'opzione di stringa (per ulteriori dettagli, fare riferimento a Formati data/ora).
  • Secondi. Questo valore supporta oggetti data e ora Java e C time_t. E' valido solo se la proprietà Formato data/ora rappresenta soli dati numerici.
  • Millisecondi dell'ora. Questo valore supporta oggetti data e ora Java e C time_t. E' valido solo se la proprietà Formato data/ora rappresenta soli dati numerici.

Il valore predefinito è Stringa a lunghezza fissa.

Formato data/ora Stringa Specificare una maschera per data e ora.

Il formato data/ora predefinito dipende dal tipo logico dell'oggetto. Per informazioni sui valori predefiniti per il formato data/ora secondo il tipo logico, fare riferimento a Valori data/ora predefiniti per tipo logico.

Se la proprietà Tipo fisico è impostata su Binario, la maschera è limitata ai componenti definiti in Data/ora come dati di stringa. Se la proprietà Tipo fisico è impostata su Decimale compresso, Secondi o Millisecondi dell'ora, la maschera è limitata ai componenti che rappresentano numeri. In questi casi, aggiornare la proprietà formato data/ora.

Per ulteriori dettagli sui formati data/ora, fare riferimento a Formati data/ora.

Conteggio lunghezza Pulsante e Numero intero Se la proprietà Tipo fisico è impostata su Stringa a lunghezza fissa, Decimale compresso o Binario e la proprietà Tipo lunghezza è impostata su Conteggio, immettere il numero di unità di lunghezza per l'elemento.

Il valore minimo possibile è 1 per tutti e tre i tipi fisici.

Il valore massimo possibile è 256 per il campo Stringa a lunghezza fissa, 10 per il campo Decimale compresso e 2147483647 per il campoBinario.

Il valore predefinito è 0 (zero).

Riferimento lunghezza Pulsante e tipo numerato Se è stata selezionata l'opzione di definizione della lunghezza Riferimento lunghezza, selezionare il nome dell'oggetto a numero intero che specifica la lunghezza di questo oggetto. Effettuare tale selezione nell'elenco a discesa degli oggetti a numero intero definiti come elementi di pari livello dell'oggetto corrente e situati prima di tale oggetto nella struttura del messaggio.

Per informazioni sul nuovo ordine degli elementi, fare riferimento a Nuovo ordine degli oggetti.

Unità di lunghezza Tipo numerato In base al Tipo fisico impostato, selezionare uno dei seguenti valori nell'elenco a discesa:
  • Byte. Specifica il numero di byte elaborati in X, dove X è il valore di Conteggio lunghezza o del valore INTEGER specificato in Riferimento lunghezza.
  • Caratteri. La spiegazione di questa opzione dipende dal valore impostato nel CCSID del messaggio o per la proprietà della serie di messaggi CCSID predefinito.
    • Se è stato specificato un CCSID SBCS, viene elaborato un numero X di byte, dove X è il valore di Conteggio lunghezza o del valore INTEGER specificato da Riferimento lunghezza.
    • Se è stato specificato un CCSID DBCS, viene elaborato un numero Y di byte, dove Y è il valore di Conteggio lunghezza o del valore INTEGER specificato in Riferimento lunghezza moltiplicato per due.
    • Se è stato specificato un CCSID MBCS, il programma di analisi legge 1 carattere alla volta e determina se il carattere è composto da uno o più byte. Il programma di analisi effettua Z letture, dove Z è il valore di Conteggio lunghezza o del valore INTEGER specificato in Riferimento lunghezza.
  • Unità di carattere. Specifica che la dimensione dell'unità di carattere è determinata dal valore impostato nel CCSID del messaggio o per la proprietà della serie di messaggi CCSID predefinito. Il numero di byte elaborati è la dimensione dell'unità di caratteri moltiplicata per il valore di Conteggio lunghezza o il valore INTEGER specificato in Riferimento lunghezza.
  • Fine di Bistream. Sono elaborati tutti i dati fino alla fine del flusso di bit. Questa opzione è valida solo se l'elemento è l'ultimo nel messaggio. Se viene selezionato questo valore, non è necessario immettere un valore in Conteggio lunghezza o Riferimento lunghezza.

Il valore predefinito è byte.

Segnato Boolean Se la proprietà Tipo fisico è impostata su Decimale compresso, Secondi o Millisecondi dell'ora, selezionare (impostazione predefinita) o deselezionare Segnato. Se è stato selezionato un altro valore per Tipo fisico, questa proprietà non è valida.
Giustificazione stringa Tipo numerato Se la proprietà Tipo fisico è impostata su Stringa a lunghezza fissa, selezionare Giustificazione a sinistra (valore predefinito) o Giustificazione a destra nell'elenco a discesa. Se è stato selezionato un altro valore per Tipo fisico, questa proprietà non è attiva.
Carattere di riempimento Stringa

Se la proprietà Tipo fisico è impostata su Stringa a lunghezza fissa e la proprietà Giustificazione stringa è impostata su Giustificazione a sinistra o Giustificazione a destra, questa proprietà è applicabile.

In fase di scrittura di un messaggio di output, utilizzare il carattere di riempimento per completare le posizioni dei caratteri rimanenti quando la lunghezza della stringa è minore della lunghezza indicata dalla proprietà Conteggio lunghezza o Riferimento lunghezza. L'opzione di riempimento da destra o da sinistra è regolata dalla proprietà Giustificazione stringa.

In fase di analisi di un messaggio di input, il carattere di riempimento è ritagliato a partire dalla fine della stringa. L'opzione di ritaglio da destra o da sinistra è regolata dalla proprietà Giustificazione stringa.

Specificare il carattere utilizzando una delle procedure riportate di seguito:

  • Selezionare NUL o '0' oppure SPACE nell'elenco a discesa.
  • Immettere un carattere tra apici, ad esempio "c" o 'c', dove c rappresenta un carattere alfanumerico qualsiasi.
  • Immettere un valore Unicode nel formato U+xxxx dove xxxx rappresenta un valore Unicode specificato in formato esadecimale. La lunghezza massima possibile del valore di stringa è 10.
  • Immettere un codice di carattere esadecimale nel formato 0xYY, dove YY rappresenta un valore esadecimale.
  • Immettere un valore di byte decimale (compreso tra 0 e 255).

La scelta di quali formati del carattere di riempimento utilizzare per un elemento MRM dipende dal carattere di riempimento richiesto e la relativa dipendenza dalla conversione di dati. Nella maggior parte dei casi è sufficiente specificare il carattere di riempimento tra apici e quando tale carattere di riempimento viene utilizzato, viene convertito nella code page di destinazione del messaggio MRM di output creato. Ad esempio, quando si effettua la conversione da formato ASCII nella code page 500, se come carattere di riempimento è stato specificato U+0008, questo viene convertito da 0x08 a 0x15, la rappresentazioni ASCII ed EBCDIC del carattere "BACKSPACE".

Se è richiesto un carattere di riempimento che non è possibile immettere con facilità nel campo del carattere di riempimento, è possibile specificare il carattere richiesto utilizzando il formato mnemonico Unicode. Quando viene utilizzato, tale valore Unicode è convertito inoltre nella code page di destinazione del messaggio MRM creato.

Se si converte un messaggio da una code page all'altra, accertarsi che il valore convertito del carattere di riempimento sia valido per tale code page. Se non è possibile rappresentare il carattere di riempimento nella code page di destinazione, è sostituito da un carattere di sostituzione. Il carattere di sostituzione è fisso e il relativo valore dipende dalla code page di destinazione specificata.

Se è richiesto un carattere di riempimento che non dipende dalla conversione dati, è possibile utilizzare il formato decimale o esadecimale. Sarà quindi possibile specificare come carattere di riempimento un valore assoluto, inserito in modo diretto nel messaggio di output. Se viene utilizzato tale formato, è necessario accertarsi che tale valore sia valido per la code page di uno qualsiasi dei messaggi di output creati utilizzando le definizioni MRM.

Rappresentazione dei valori nulli

Proprietà Tipo Spiegazione
Nullo di codifica Tipo numerato Selezionare una delle seguenti opzioni nell'elenco a discesa. L'opzione selezionata determina il valore da impostare per la proprietà Valore Null di codifica:
  • NULLPadFill. Questa proprietà è valida solo se la proprietà Tipo fisico è impostata su Stringa a lunghezza fissa. Il campo è riempito con il valore specificato in Carattere di riempimento. Si tratta del valore predefinito.
  • NULLLogicalValue. La proprietà Valore Null di codifica viene convertita prima nel valore reale e quindi rappresentata nella modalità specificata per il campo.
  • NULLLiteralValue. Indica che il valore contenuto nel campo Valore Null di codifica viene sostituito in modo diretto come se si trattasse di una stringa. Utilizzare questa opzione quando il valore impostato per Valore Null di codifica che specifica una data nulla non è un valore dateTime o non è conforme al formato data/ora standard aaaa-MM-gg 'T'HH:mm:ss.
  • NULLLiteralFill. Il campo è riempito con il valore specificato in Valore Null di codifica. Il Valore Null di codifica deve essere risolto in un carattere singolo.
Valore Nullo di codifica Stringa

Se la proprietà Null di codifica è impostata su NULLPadFill, tale proprietà è disabilitata (ombreggiata).

Se la proprietà Null di codifica è impostata su NULLLogicalValue, impostare questa proprietà su un formato data/ora conforme allo standard ISO8601. I formati sono descritti in Data/ora come dati di stringa. Ad esempio, specificare un valore conforme al formatoaaaa-MM-dd'T'HH:mm:ss come 1970-12-01.

Se la proprietà Null di codifica è impostata su NULLLiteralValue, è possibile immettere qualsiasi valore della stessa lunghezza del campo.

Se la proprietà Null di codifica è impostata su NULLLiteralFill, è necessario che il valore sia risolto in un carattere singolo. Impostare il carattere effettuando una delle procedure riportate di seguito:
  • Selezionare SPACE, NUL, 0x00 o 0xFF nell'elenco a discesa.
  • Immettere un carattere tra apici, ad esempio "c" o 'c', dove c rappresenta un carattere alfanumerico qualsiasi.
  • Immettere un codice di carattere esadecimale nel formato 0xYY, dove YY rappresenta un valore esadecimale.
  • Immettere un codice di carattere decimale nel formato YY, dove YY rappresenta un valore decimale.
  • Immettere un valore Unicode nel formato U+xxxx dove xxxx rappresenta un valore Unicode specificato in formato esadecimale.

Allineamento dei byte

Proprietà Tipo Spiegazione
Allineamento dei byte Tipo numerato Specificare la modalità di allineamento dell'oggetto dall'inizio del messaggio. Selezionare uno di questi valori:
  • 1 byte. Si tratta del valore predefinito.
  • 2 byte
  • 4 byte
  • 8 byte
  • 16 byte
Numero di elementi iniziali ignorati Numero intero Specificare il numero di byte da ignorare prima di leggere o scrivere questo oggetto. Il valore predefinito è 0, il valore minimo è0 e il valore massimo è 999999. È possibile utilizzare questo valore per ignorare i campi non desiderati in una struttura o per modellare un campo definito da dati C o COBOL per i quali è richiesto l'allineamento su un limite a 2, 4, 8 o 16 byte. Specificare il numero di byte da ignorare prima di leggere o scrivere questo oggetto. In fase di scrittura di un messaggio di output, ai byte del campo Numero di elementi ignorati è assegnato il valore della proprietà Riempimento allineamento byte della serie di messaggi.

Per gli oggetti ripetuti, questa proprietà viene applicata solo alla prima istanza.

Numero di elementi finali ignorati Numero intero Specificare il numero di byte da ignorare dopo la lettura o la scrittura di questo oggetto. Il valore predefinito è 0, il valore minimo è0 e il valore massimo è 999999. È possibile utilizzare questo valore per ignorare i campi non desiderati in una struttura o per modellare una struttura ripetuta in cui sono contenuti campi per i quali è richiesto l'allineamento su un limite a 2, 4, 8 o 16 byte. In fase di scrittura di un messaggio di output, ai byte del campo Numero di elementi ignorati è assegnato il valore della proprietà Riempimento allineamento byte della serie di messaggi.

Per gli oggetti ripetuti, questa proprietà viene applicata a tutte le istanze.

Ripeti

Proprietà Tipo Spiegazione
Riferimenti ripetizioni Tipo numerato Utilizzare questa proprietà se l'oggetto è presente più volte e il numero di ricorrenze viene fornito in modo dinamico in un campo precedente nel messaggio.

Selezionare un oggetto intero nel relativo elenco a discesa situato prima di tale oggetto nella struttura del messaggio. Il valore del numero intero selezionato specifica il numero di ricorrenze di questo oggetto. Se non viene elencato alcun oggetto, non sono presenti oggetti interi prima di questo nella struttura del messaggio.

Se è stata specificata la proprietà Riferimenti ripetizioni, sostituisce qualsiasi impostazione per la proprietà logica Numero massimo ricorrenze in fase di analisi e di scrittura del messaggio, ma non in fase di convalida del messaggio.

Concetti correlati
Creazione di modelli di messaggio
Il modello di messaggio
Custom Wire Format: relazione con il modello logico
Attività correlate
Sviluppo di modelli di messaggio
Gestione degli oggetti del modello messaggio
Riferimenti correlati
Informazioni di riferimento del modello di messaggio
Proprietà dell'oggetto modello di messaggio
Proprietà dell'oggetto modello di messaggio obsolete
Proprietà di tipo semplice integrato
Proprietà CWF di tipo semplice integrato
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
ad16050_