Proprietà dei metodi
Utilizzare la pagina Proprietà metodo per impostare le proprietà array, COBOL, progettazione, definizione host e recordset nel metodo .
Proprietà matrice
| Usare | Per |
|---|---|
| Dimensioni di matrice | Selezionare le dimensioni della matrice per il valore restituito. Il valore predefinito è (nessuno).The default is (none). |
| Matrice is | Selezionare 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 segue 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).The default is (none). |
Proprietà COBOL
| Usare | Per |
|---|---|
| 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: - Troncamento. Selezionare questa opzione per impostare TI per troncare il valore quando si verifica un errore. (predefinito) - Arrotondamento. Selezionare questa opzione per impostare TI per arrotondare il valore quando si verifica un errore. - Errore. Selezionare questa opzione per impostare TI per restituire un errore quando si verifica un errore. |
| Riempimento | Digitare il riempimento del valore restituito. Il valore predefinito è 0. |
| Dall'host | Digitare il numero di byte di FILLER che segue questo elemento di dati nei buffer ricevuti dal server. FILLER causa un gap non traslato nel buffer. FILLER non è visibile sul lato 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 traslato nel buffer. FILLER non è visibile sul lato Automazione. Il valore predefinito è 0. |
| Scalabilità | Digitare la scala del valore restituito. |
| Attributo Sign | Selezionare l'attributo del segno di valore restituito. I valori possibili sono: - Finale. Per il tipo di dati DISPLAY firmato, indica che il segno è finale (impostazione predefinita). Questa opzione indica all'ambiente di runtime TI la formattazione di un tipo di dati DISPLAY firmato e influisce sul modo in cui i dati dall'host vengono convertiti in e dal tipo di dati di Automazione. - Separazione finale. Per il tipo di dati DISPLAY firmato, indica che il segno è separato. Questa opzione indica all'ambiente di runtime TI la formattazione di un tipo di dati DISPLAY firmato e influisce sul modo in cui i dati dall'host vengono convertiti in e dal tipo di dati di Automazione. - Iniziale. Per il tipo di dati DISPLAY firmato, indica che il segno è iniziale. Questa opzione indica all'ambiente di runtime TI la formattazione di un tipo di dati DISPLAY firmato e influisce sul modo in cui i dati dall'host vengono convertiti in e dal tipo di dati di Automazione. - Separazione iniziale. Per il tipo di dati DISPLAY firmato, indica che il segno è separato. |
| Size | Digitare la dimensione del valore restituito. |
| SOSI | Selezionare questa opzione per specificare quando si prevede che i dati di un set di caratteri a byte doppio inizino con uno shift-out (SO) e terminano 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 runtime TI li applica. - False (impostazione predefinita) |
| Delimitazione di stringhe | Selezionare la stringa del valore restituito delimitata. I valori possibili sono: - Spaziatura interna. Indica all'ambiente di runtime TI che la rappresentazione mainframe della stringa è delimitata dalla spaziatura interna della definizione della stringa con caratteri di 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 in base al numero appropriato di spazi finali prima di inviarle al mainframe. Ad esempio, se la stringa è definita nel mainframe come PIC X(10), TI invierà una stringa di ABC seguita da sette spazi finali. Se si seleziona questa opzione, viene indicato 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 altre informazioni, vedere Riempimento di stringhe di caratteri mainframe con spazi. (predefinito) - Terminazione Null. Indica all'ambiente di runtime TI che la rappresentazione mainframe della stringa è delimitata da un carattere Null (EBCDIC 0x00). 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. Pertanto, 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 altre informazioni, vedere Riempimento di stringhe di caratteri mainframe con spazi. |
Proprietà di progettazione
| Usare | Per |
|---|---|
| Consenti 32.000 in/out | Selezionare questa opzione se si vuole che TI consideri l'input DFHCOMMAREA indipendentemente dall'output DFHCOMMAREA. TI combina in genere l'input DFHCOMMAREA e l'area DFHCOMMAREA di output. Le aree combinate non possono superare 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 usare 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 della Guida | Digitare l'ID contesto della Guida associato a questo metodo. L'ID viene usato per connettersi alla Guida per questo metodo e restituito quando si verifica un'eccezione durante la chiamata 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 nell'argomento . Se non si include il parametro COMTIContext nella chiamata al metodo insieme agli altri parametri, Visual Basic .NET restituisce il messaggio di errore An unhandled exception of type 'System.MissingMemberException' occurred in microsoft.visualbasic.dll and informs you that the method cannot be call with the number of parameters you have write. 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 buffer iniziale | Digitare il valore del buffer iniziale. Il valore predefinito è Null. |
| Collegamento | Consente di specificare se il metodo dell'oggetto host usa il modello di programmazione Collega. 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 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 32.000 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 più chiamate di metodo passano alla 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 composto da un massimo di 250 caratteri Unicode. Il nome deve essere diverso da qualsiasi altro nome di metodo nello stesso progetto. Il valore predefinito è Null. |
| Valore restituito posizione 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. Usare questa opzione quando l'elemento dati che si desidera specificare come valore restituito di Automazione non è il primo campo elemento dati nella dichiarazione di dati che descrive i dati ricevuti dall'host. |
| Riempimento preliminare | Visualizzare il numero di byte di FILLER ricevuti o inviati all'host. |
| Dall'host | Digitare il numero di byte di FILLER che segue questo elemento di dati nei buffer ricevuti dal server. FILLER causa un gap non traslato nel buffer. FILLER non è visibile sul lato 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 traslato nel buffer. FILLER non è visibile sul lato Automazione. |
| Tipo restituito | Selezionare il tipo di valore restituito. I valori possibili sono: - Vuoto - Boolean - Byte - Data - Valuta - Decimale - Intero - Lungo - Doppia - Singolo - Stringa - 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 usata anche per definire una tabella dati o un recordset come delimitato o come incluse tutte le righe definite come Valore massimo occorrenza impostato nel parametro . |
| Dall'host | - Vero - False (impostazione predefinita) |
| Per ospitare | - Vero - False (impostazione predefinita) |
Proprietà definizione host
| Usare | Per |
|---|---|
| Nome del programma da collegamento a programma | Digitare il nome da collegamento a programma (CICS LINK/DPL). |
| ID transazione mirror | Digitare il mirror TRANID usato da questo metodo, se si vuole eseguire l'override del mirror TRANID per l'ambiente remoto (RE) associato a questo componente. Lasciando vuota questa casella, il traNID mirror nella descrizione dell'ambiente remoto deve essere usato. Il TRANID può essere fino a quattro caratteri in lunghezza. 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 Resource Controllo di accesso Facility (RACF) se la sicurezza delle transazioni è attiva. |
| Nome TP | Digitare un nome del programma di transazione di origine (TP) quando il programma 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à dei recordset
| Usare | Per |
|---|---|
| Includere le dimensioni effettive | Il programma host non include o prevede informazioni che indicano il numero effettivo di righe (set di record) 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. |
| Occorrenza massima | Occorrenza massima della 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 segue una tabella di lunghezza variabile seguono immediatamente l'ultimo elemento di dati nella tabella indipendentemente dalla dimensione massima specificata per la tabella. Per le matrici con più dimensioni, può essere usato solo per il ciclo più esterno (COBOL) o la dimensione più a destra (Visual C++ o Visual Basic). Il recordset di valori restituito si verifica a seconda di. Il valore predefinito è (nessuno). |
| Unbounded | Indica che il recordset non è associato. Indica che qualsiasi numero 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 la dimensione della stringa varia. - False. Quando l'ultimo elemento di dati è una matrice, ciò 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. (predefinito) |
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 l'errore della funzione del componente.
Vedere anche
TRM ed ELM personalizzati con COMTIContext
Nodo del nome del metodo (.NET)
Proprietà (progetto TI)