Proprietà del metodo

Utilizzare la pagina delle proprietà del Metodo per impostare le proprietà di array, COBOL, progettazione, definizione host e recordset nel Metodo.

Proprietà dell'array

Usare questo	Per farlo
Dimensioni matrice	Selezionare le dimensioni della matrice per il valore restituito. Il valore predefinito è (nessuno).
Matrice is	Consente di specificare se il valore restituito è una matrice. I valori possibili sono: - Vero - False (impostazione predefinita)
Si verifica a seconda di	Selezionare questa opzione per indicare che un elemento dati numerico precedente alla tabella (recordset o matrice in Automazione) indica il numero effettivo di righe o elementi inviati o ricevuti. Equivalente alle tabelle a lunghezza variabile in COBOL. Usare l'elenco a discesa per selezionare l'elemento dati numerico che specifica questo valore. Per il collegamento CICS, il recordset o la matrice e l'identificatore di lunghezza associato devono essere in/out. I dati nel buffer che seguono una tabella di lunghezza variabile seguono immediatamente l'ultimo elemento di dati nella tabella indipendentemente dalle dimensioni massime specificate per la tabella. Le matrici con più dimensioni possono essere usate solo per il ciclo più esterno (COBOL) o la dimensione più a destra (Microsoft® Visual C++ ® o Visual Basic). Il valore predefinito è (nessuno).

Proprietà COBOL

Usare questo	Per farlo
Tipo di dati host	Selezionare il tipo di dati host.
gestione degli errori	Selezionare la gestione degli errori del valore restituito. I valori possibili sono: - Tronca. Selezionare questa opzione per impostare TI per troncare il valore quando si verifica un errore. (impostazione predefinita) - Rotondo. Selezionare questa opzione per impostare TI per arrotondare il valore quando si verifica un errore. - Errore. Selezionare questa opzione per configurare TI affinché restituisca un errore quando si verifica.
Riempimento	Digitare il riempimento del valore restituito. Il valore predefinito è 0.
Da Host	Digitare il numero di byte di FILLER che segue questo elemento di dati nei buffer ricevuti dal server. FILLER causa un gap non tradotto nel buffer. FILLER non è visibile nell'ambito dell'automazione. Il valore predefinito è 0.
Per ospitare	Digitare il numero di byte di FILLER che segue questo elemento di dati nei buffer inviati al server. FILLER causa un gap non tradotto nel buffer. FILLER non è visibile nell'ambito dell'automazione. Il valore predefinito è 0.
Scale	Digitare la scala del valore restituito.
Attributo di Firma	Selezionare l'identificatore del valore restituito. I valori possibili sono: - Spazi finali. Per il tipo di dato DISPLAY con segno, indica che il segno è posticipato (impostazione predefinita). Questa opzione indica all'ambiente di runtime TI il formato di un tipo di dati DISPLAY firmato e influisce sulla modalità di conversione dei dati dall'host in e dal tipo di dati di Automazione. - Seguimento separato. Per il tipo di dati DISPLAY firmato, indica che il segno è separato. Questa opzione indica all'ambiente di runtime TI come viene formattato un tipo di dati DISPLAY firmato e influisce su come i dati dall'host vengono convertiti verso e dal tipo di dati di Automazione. - Principale. Per il tipo di dati DISPLAY firmato, indica che il segno è posizionato davanti. Questa opzione indica all'ambiente di runtime TI come viene formattato un tipo di dati DISPLAY firmato e influisce su come i dati dall'host vengono convertiti verso e dal tipo di dati di Automazione. - Separazione principale. Per il tipo di dati DISPLAY firmato, indica che il segno è separato.
Dimensione	Digitare la dimensione del valore restituito.
SOSI	Selezionare questa opzione per specificare se ci si aspetta che un set di caratteri a doppio byte inizi con un carattere shift-out (SO) e termini con un carattere shift-in (SI). I valori possibili sono: - True. I caratteri SO e SI vengono rimossi dai dati quando vengono ricevuti dall'applicazione host e i caratteri SO e SI vengono aggiunti ai dati quando vengono inviati all'applicazione host. Nella lunghezza del PIC G, non è necessario includere i due byte per i caratteri SO e SI perché l'ambiente di esecuzione TI li applica. - False (impostazione predefinita)
Delimitazione di stringhe	Selezionare la stringa di delimitazione del valore restituito. I valori possibili sono: - Riempito con spazi. Indica all'ambiente di runtime TI che la rappresentazione mainframe della stringa è delimitata riempiendo la definizione di stringa con caratteri spazio. Ad esempio, se la definizione COBOL del mainframe è PIC X(10), ma nella stringa sono presenti solo tre caratteri, il mainframe prevede sette spazi finali. La selezione di questa opzione indica quindi all'ambiente di runtime TI di convertire le stringhe inviate al mainframe per modificare il carattere di terminazione NULL della stringa nel numero appropriato di spazi finali prima di inviarle al mainframe. Ad esempio, se la stringa viene definita nel mainframe come PIC X(10), TI invierà una stringa di ABC seguita da sette spazi finali. La selezione di questa opzione indica anche all'ambiente di runtime TI di convertire la stringa di output restituita dal mainframe al server di automazione TI convertendo gli spazi finali della stringa in un singolo carattere di terminazione Null. Per ulteriori informazioni, vedere Padding Mainframe Character Strings with Spaces. (impostazione predefinita) - Terminazione Null. Indica all'ambiente di runtime TI che la rappresentazione mainframe della stringa è delimitata da un carattere Null (0x00 EBCDIC). Se si seleziona questa opzione, l'ambiente di runtime TI indica all'ambiente di runtime TI di aggiungere un singolo carattere Null alla fine di una stringa se è presente spazio per il byte prima di inviare una stringa al mainframe e indica all'ambiente di runtime TI di arrestarsi al primo carattere Null rilevato durante la ricezione di una stringa dal mainframe. Di conseguenza, selezionando questa opzione, si indica a TI di mantenere gli spazi finali nelle stringhe di output provenienti dal mainframe perché TI non convertirà gli spazi finali in un singolo carattere di terminazione NULL. Per ulteriori informazioni, vedere Padding Mainframe Character Strings with Spaces.

Proprietà di progettazione

Usare questo	Per farlo
Consenti 32K I/O	Selezionare questa opzione se si vuole che TI consideri l'input DFHCOMMAREA in modo indipendente dall'output DFHCOMMAREA. TI combina in genere l'input DFHCOMMAREA e l'area di output DFHCOMMAREA. Le aree combinate non possono superare i 32 KB di dati. Quando questa opzione è selezionata, TI considera l'input DFHCOMMAREA indipendentemente dall'output DFHCOMMAREA. Ogni area di input e output usa fino a 32 KB di dati. La modifica di questa opzione influisce sul metodo attualmente selezionato. I valori possibili sono: - Vero - False (impostazione predefinita) Nota: è possibile utilizzare questa proprietà come accessorio per "Usa modello di programmazione dei collegamenti" nel modello di programmazione CICS avviato da Windows (WIP) e in qualsiasi modello di programmazione HIP (Host-Initiated Processing). Nota: Questa proprietà è disponibile solo se la proprietà Is Link è impostata su True.
Descrizione	Digitare una descrizione del metodo . La descrizione può essere un massimo di 250 caratteri Unicode.
ID contesto di Aiuto	Digitare l'ID contesto della Guida associato a questo metodo. L'ID viene utilizzato per connettersi al sistema di aiuto per questo metodo e viene passato quando si verifica un'eccezione durante l'invocazione di questo metodo. Il valore predefinito è 0.
Includi parametro di contesto	Selezionare se il metodo dell'oggetto client include automaticamente il contesto. I valori possibili sono: - True. Visual Basic .NET include automaticamente il contesto come parametro aggiuntivo negli argomenti. Se non si include il parametro COMTIContext nella chiamata al metodo insieme agli altri parametri, Visual Basic .NET restituisce il messaggio di errore Un'eccezione non gestita di tipo 'System.MissingMemberException' si è verificata in microsoft.visualbasic.dll e informa che il metodo non può essere chiamato con il numero di parametri scritti. Se viene visualizzato questo messaggio, verificare che il parametro Include Context sia incluso come parametro all'interno dell'elenco di parametri nel metodo . - False. Visual Basic .NET non include automaticamente il contesto come parametro aggiuntivo nell'argomento . Se si imposta questa proprietà su False e si include il parametro COMTIContext nella chiamata al metodo insieme agli altri parametri, Visual Basic .NET restituisce il messaggio di errore Un'eccezione non gestita di tipo 'System.MissingMemberException' si è verificata in microsoft.visualbasic.dll e informa che il metodo non può essere chiamato con il numero di parametri scritti. Se viene visualizzato questo messaggio, rimuovere il parametro COMTIContext dall'elenco dei parametri del metodo. Il valore predefinito è True.
Valore del buffer iniziale	Digitare il valore del buffer iniziale. Il valore predefinito è Null.
È Collegamento	Seleziona se il metodo dell'oggetto host utilizza il modello di programmazione Link. I valori possibili per l'elaborazione avviata da Windows (WIP) sono: - True. Usare il modello di collegamento. Il modello di programmazione dei collegamenti può essere usato solo con i protocolli di collegamento CICS. - False. Non usare il modello di collegamento. Il valore predefinito è False. I valori possibili per l'elaborazione avviata dall'host (HIP) sono: - Sì. Usare il modello di collegamento. Il modello di programmazione dei collegamenti può essere usato con tutti i protocolli. - No. Non usare il modello di collegamento. - Collegamento con 32K In/Out. Usare il modello di collegamento e impostare le proprietà From Host e To Host. Il valore predefinito è No.
Metadati	Selezionare la modalità di gestione dei metadati. I valori possibili sono: - (nessuno). Per impostazione predefinita, nessun dato speciale viene inviato o ricevuto dall'applicazione host. Selezionare questo pulsante di opzione se si desidera inviare e ricevere solo i dati per il metodo . - Includere le informazioni sul metodo. Nome di questo metodo da inviare all'host insieme ai dati dei parametri. Il nome del metodo viene inviato come primi 32 byte nel buffer. Questa opzione è utile se si effettuano più chiamate di metodo nella stessa transazione e si desidera distinguere i dati dalle diverse chiamate. - Includere tutte le informazioni. Tutti i metadati disponibili per l'invio e la ricezione con i dati del metodo. Per informazioni dettagliate sul formato dei metadati, vedere la descrizione per "Metadati facoltativi".
Nome	Digitare il nome del metodo. Il nome può essere un massimo di 250 caratteri Unicode. Il nome deve essere diverso da qualsiasi altro nome di metodo nello stesso progetto. Il valore predefinito è Null.
Posiziona il Valore Restituito Dopo	Digitare il valore restituito del metodo di automazione che segue l'elemento di dati selezionato quando viene ricevuto dall'host. Questa opzione non influisce sul lato Automazione. Usa questa opzione quando l'elemento di dati che si desidera specificare come valore restituito dell'Automazione non è il primo campo dell'elemento dati nella dichiarazione che descrive i dati ricevuti dall'host.
Filler preliminare	Visualizzare il numero di byte di FILLER ricevuti dall'host o inviati all'host.
Da Host	Digitare il numero di byte di FILLER che segue questo elemento di dati nei buffer ricevuti dal server. FILLER causa un gap non tradotto nel buffer. FILLER non è visibile nell'ambito dell'automazione.
Per ospitare	Digitare il numero di byte di FILLER che segue questo elemento di dati nei buffer inviati al server. FILLER causa un gap non tradotto nel buffer. FILLER non è visibile nell'ambito dell'automazione.
Tipo di ritorno	Selezionare il tipo di valore restituito. I valori possibili sono: - Vuoto - Boolean - Byte - Data - Valuta - Decimale - Intero - Lungo - Doppio - Singolo - Corda - Tipo definito dall'utente - Recordset - (nessuno) (impostazione predefinita)
Campo finale ridimensionato variabile	- Selezionare questa opzione quando l'ultimo elemento di dati è una stringa per indicare che le dimensioni della stringa variano. Questa opzione viene utilizzata anche per definire una tabella dati o un recordset come limitato, oppure come comprendente tutte le righe, secondo quanto definito nel parametro Numero massimo di occorrenze.
Da Host	- Vero - False (impostazione predefinita)
Per ospitare	- Vero - False (impostazione predefinita)

Proprietà di definizione dell'host

Usare questo	Per farlo
Nome Link al Programma	Digitare il nome del collegamento al programma (CICS LINK/DPL).
ID transazione "Mirror"	Digitare il TRANID mirror utilizzato da questo metodo, se si desidera eseguire l'override del TRANID mirror per l'ambiente remoto (RE) a cui è associato questo componente. Se si lascia vuota questa casella, il TRANID mirror nella descrizione dell'ambiente remoto viene usato. Il TRANID può avere una lunghezza massima di quattro caratteri. I caratteri accettabili sono A-Z a-z 0-9 $ @ # . / _ % & ? ! : | = , ; <>. I nomi delle transazioni che iniziano con C sono riservati per CICS e non devono essere usati. I caratteri % e & possono causare problemi con la funzionalità RACF (Resource Access Control Facility) se la sicurezza delle transazioni è attiva.
Nome TP	Digitare un nome TP (Source Transaction Program) quando il programma dell'applicazione CICS deve accedere a un database DB2. Il nome TP viene fatto riferimento in una voce CICS Resource Control Table (RCT), che associa le transazioni CICS ai piani DB2. Specifica il nome del programma di transazione host (IMS o CICS) o il nome del programma di collegamento (CICS LINK/DPL).

Proprietà recordset

Usare questo	Per farlo
Includi dimensioni effettive	Il programma host non includerà o prevede informazioni che indicano il numero effettivo di righe (recordset) o elementi (matrici) inviati o ricevuti. I valori possibili sono: - Vero - False (impostazione predefinita) Questa proprietà è di sola lettura e verrà sempre impostata su False a meno che non sia stata impostata su True al momento della creazione della libreria dei tipi con la prima versione di COM Transaction Integrator.
Numero massimo di occorrenze	Numero massimo di occorrenze di riga. Indica il numero massimo di righe da inviare o ricevere dall'host. Equivalente alla parola chiave OCCURS n TIMES in un elemento del gruppo COBOL. L'impostazione predefinita è 1.
Si verifica a seconda di	Equivalente alle tabelle a lunghezza variabile in COBOL. Indica che un elemento dati numerico precedente alla tabella (recordset o matrice in Automazione) indica il numero effettivo di righe o elementi inviati o ricevuti. Usare l'elenco a discesa per selezionare l'elemento dati numerico che specifica questo valore. Per il collegamento CICS, il recordset o la matrice e l'identificatore di lunghezza associato devono essere in/out. I dati nel buffer che seguono una tabella di lunghezza variabile seguono immediatamente l'ultimo elemento di dati nella tabella indipendentemente dalle dimensioni massime specificate per la tabella. Per le matrici con più dimensioni, può essere usata solo per il ciclo più esterno (COBOL) o la dimensione più a destra (Visual C++ o Visual Basic). Il recordset di valori restituiti si verifica in base a . Il valore predefinito è (nessuno).
Unbounded	Indica che il recordset è senza limiti. Indica che un numero qualsiasi di righe può essere inviato o ricevuto dall'host. Selezionare questa opzione quando le righe inviate o ricevute provengono da un database e il numero massimo di righe non è noto. I valori possibili sono: - True. Quando l'ultimo elemento di dati è una stringa, ciò significa che le dimensioni della stringa variano. - False. Quando l'ultimo elemento di dati è una matrice, questo significa che il numero di elementi nella matrice varia. Quando l'ultimo elemento di dati è un recordset, ciò significa che il numero di righe nel recordset varia. (impostazione predefinita)

Attenzione

Le proprietà di un componente non devono essere impostate o modificate a livello di codice. L'impostazione o la modifica delle proprietà a livello di codice potrebbero causare un funzionamento non corretto del componente.

Vedere anche

TRMs e ELMs personalizzati con COMTIContext
Nome del metodo Nodo (.NET)
Proprietà (progetto TI)