Methodeneigenschaften

Verwenden Sie die Seite " Methodeneigenschaften ", um Array-, COBOL-, Entwurfs-, Hostdefinitions- und Recordseteigenschaften für die Methode festzulegen.

Arrayeigenschaften

Verwenden Sie diese	Um dies zu tun
Arrayabmessungen	Wählen Sie die Arrayabmessungen für den Rückgabewert aus. Der Standardwert ist (keine).
Ist Array	Wählen Sie aus, ob der Rückgabewert ein Array ist. Mögliche Werte sind: - STIMMT - False (Standard)
Tritt auf je nach	Wählen Sie diese Option aus, um anzugeben, dass ein numerisches Datenelement vor der Tabelle (Recordset oder Array in der Automatisierung) die tatsächliche Anzahl von Zeilen oder Elementen angibt, die gesendet oder empfangen werden. Entspricht Tabellen mit variabler Länge in COBOL. Verwenden Sie die Dropdownliste, um das numerische Datenelement auszuwählen, das diesen Wert angibt. Bei CICS Link muss das Recordset oder Array und der zugehörige Längenbezeichner ein-/aus sein. Die Daten im Puffer, die einer Variablenlängentabelle folgen, folgen unmittelbar dem letzten Datenelement in der Tabelle, unabhängig von der für die Tabelle angegebenen maximalen Größe. Arrays mit mehreren Dimensionen können nur für die äußerste Schleife (COBOL) oder die rechte Dimension (Microsoft® Visual C++® oder Visual Basic) verwendet werden. Der Standardwert ist (keine).

COBOL-Eigenschaften

Verwenden Sie diese	Um dies zu tun
Hostdatentyp	Wählen Sie den Hostdatentyp aus.
Fehlerbehandlung	Wählen Sie die Fehlerbehandlung für den Rückgabewert aus. Mögliche Werte sind: - Abschneiden. Aktivieren Sie diese Option, damit TI so eingestellt wird, den Wert abzuschneiden, wenn ein Fehler auftritt. (Standard) - Runden. Aktivieren Sie diese Option, um ti so festzulegen, dass der Wert gerundet wird, wenn ein Fehler auftritt. - Fehler. Wählen Sie diese Option, damit TI einen Fehler zurückgibt, wenn ein Problem auftritt.
Füller	Geben Sie den Rückgabewertfüller ein. Der Standardwert ist 0.
Vom Host	Geben Sie die Anzahl der Bytes von FILLER ein, die auf dieses Datenelement in den Puffern folgt, die vom Server empfangen werden. FILLER verursacht eine nicht übersetzte Lücke im Puffer. FILLER ist auf der Automatisierungsseite nicht sichtbar. Der Standardwert ist 0.
Zu hosten	Geben Sie die Anzahl der Bytes von FILLER ein, die diesem Datenelement in Puffern folgen, die an den Server gesendet werden. FILLER verursacht eine nicht übersetzte Lücke im Puffer. FILLER ist auf der Automatisierungsseite nicht sichtbar. Der Standardwert ist 0.
Scale	Geben Sie die Rückgabewertskala ein.
Sign-Attribut	Wählen Sie das Attribut für das Rückgabewertzeichen aus. Mögliche Werte sind: - Trailing. Gibt für den signierten DISPLAY-Datentyp an, dass das Vorzeichen am Ende steht (Standard). Diese Option gibt der TI-Laufzeitumgebung an, wie ein signierter DISPLAY-Datentyp formatiert ist und sich darauf auswirkt, wie Daten vom Host in den Automatisierungsdatentyp konvertiert werden. - Nachgestellt getrennt. Gibt für signierten DISPLAY-Datentyp an, dass das Zeichen getrennt ist. Diese Option gibt der TI-Laufzeitumgebung an, wie ein signierter DISPLAY-Datentyp formatiert ist und sich darauf auswirkt, wie Daten vom Host in den Automatisierungsdatentyp konvertiert werden. - Führend. Gibt für den signierten DISPLAY-Datentyp an, dass das Vorzeichen führend ist. Diese Option gibt der TI-Laufzeitumgebung an, wie ein signierter DISPLAY-Datentyp formatiert ist und sich darauf auswirkt, wie Daten vom Host in den Automatisierungsdatentyp konvertiert werden. - Vorangestellter Separater. Gibt für signierten DISPLAY-Datentyp an, dass das Zeichen getrennt ist.
Größe	Geben Sie die Rückgabewertgröße ein.
SOSI	Wählen Sie diese Option aus, um anzugeben, ob ein Double-Byte-Zeichensatzdaten mit einem Shift-Out-Zeichen (SO) beginnen und mit einem Shift-In-Zeichen (SI) enden soll. Mögliche Werte sind: - True. Die SO- und SI-Zeichen werden aus den Daten entfernt, wenn sie von der Hostanwendung empfangen werden, und die SO- und SI-Zeichen werden den Daten hinzugefügt, wenn sie an die Hostanwendung gesendet wird. In der Länge des PIC G ist es nicht erforderlich, die beiden Bytes für die SO- und SI-Zeichen einzuschließen, da die TI-Laufzeitumgebung sie anwendet. - False (Standard)
Zeichenfolgenbegrenzung	Wählen Sie die Trennzeichen der Rückgabewertzeichenfolge aus. Mögliche Werte sind: - Leerraum. Teilt der TI-Laufzeitumgebung mit, dass die Darstellung der Zeichenfolge auf dem Großrechner durch das Auffüllen der Zeichenfolgendefinition mit Leerzeichen erfolgt. Wenn beispielsweise die COBOL-Definition des Großrechners PIC X(10) lautet, aber nur drei Zeichen in der Zeichenfolge enthalten sind, erwartet der Großrechner sieben nachfolgende Leerzeichen. Daher weist die Auswahl dieser Option die TI-Laufzeitumgebung an, Zeichenfolgen, die an den Mainframe gesendet werden, zu konvertieren, um das NULL-Beendigungszeichen der Zeichenfolge in die entsprechende Anzahl nachgestellter Leerzeichen zu ändern, bevor sie an den Mainframe gesendet werden. Wenn beispielsweise die Zeichenfolge auf dem Großrechner als PIC X(10) definiert ist, sendet TI eine Zeichenfolge von ABC gefolgt von sieben nachfolgenden Leerzeichen. Wenn Sie diese Option auswählen, wird der TI-Runtime-Umgebung auch mitgeteilt, dass die Ausgabe-Zeichenfolge, die vom Mainframe zurückgegeben wird, an den TI Automation-Server übergeben wird, indem die nachfolgenden Leerzeichen der Zeichenfolge in ein einzelnes Nullterminationszeichen umgewandelt werden. Weitere Informationen finden Sie unter Auffüllen von Mainframe-Zeichenfolgen mit Leerzeichen. (Standard) - nullterminiert. Teilt der TI-Laufzeitumgebung mit, dass die Großrechnerdarstellung der Zeichenfolge durch ein NULL-Zeichen (EBCDIC 0x00) getrennt ist. Wenn Sie diese Option auswählen, teilt dies der TI-Laufzeitumgebung mit, ein einzelnes Null-Zeichen am Ende einer Zeichenfolge hinzuzufügen, wenn genügend Platz für das Zeichen vorhanden ist, bevor die Zeichenfolge an den Mainframe gesendet wird. Beim Empfang einer Zeichenfolge vom Mainframe wird die TI-Laufzeitumgebung angewiesen, beim ersten aufgetretenen Null-Zeichen zu stoppen. Wenn Sie diese Option auswählen, weisen Sie TI daher an, nachfolgende Leerzeichen in Ausgabezeichenfolgen beizubehalten, die vom Mainframe stammen, da TI die nachfolgenden Leerzeichen nicht in einen einzelnen NULL-Endator konvertiert. Weitere Informationen finden Sie unter Auffüllen von Mainframe-Zeichenfolgen mit Leerzeichen.

Entwurfseigenschaften

Verwenden Sie diese	Um dies zu tun
Ein-/Ausgabe von 32K zulassen	Wählen Sie diese Option aus, wenn TI die Eingabe DFHCOMMAREA unabhängig vom Ausgabe-DFHCOMMAREA behandeln soll. TI kombiniert in der Regel den Eingabebereich DFHCOMMAREA und den Ausgabebereich DFHCOMMAREA. Die kombinierten Bereiche dürfen nicht mehr als 32 KB Daten umfassen. Wenn diese Option ausgewählt ist, behandelt TI die Eingabe DFHCOMMAREA unabhängig vom Ausgabe-DFHCOMMAREA. Jeder Eingabe- und Ausgabebereich verwendet bis zu 32 KB Daten. Das Ändern dieser Option wirkt sich auf die aktuell ausgewählte Methode aus. Mögliche Werte: - STIMMT - False (Standard) Hinweis: Sie können diese Eigenschaft als Zubehör für "Verwenden des Linkprogrammiermodells" im windows-initiierten CICS-Programmiermodell (WIP) und in allen vom Host initiierten Verarbeitungsmodellen (HIP) verwenden. Hinweis: Diese Eigenschaft ist nur verfügbar, wenn die Is Link-Eigenschaft auf True festgelegt ist.
Beschreibung	Geben Sie eine Beschreibung der Methode ein. Die Beschreibung kann maximal 250 Unicode-Zeichen umfassen.
Hilfekontext-ID	Geben Sie die Hilfekontext-ID ein, die dieser Methode zugeordnet ist. Die ID wird verwendet, um eine Verbindung mit der Hilfe für diese Methode herzustellen, und wird zurückgegeben, wenn während der Ausführung dieser Methode eine Ausnahme auftritt. Der Standardwert ist 0.
Include Context-Parameter	Wählen Sie aus, ob die Clientobjektmethode automatisch Kontext enthält. Mögliche Werte sind: - True. Visual Basic .NET schließt den Kontext automatisch als zusätzlichen Parameter in das Argument ein. Wenn Sie den COMTIContext-Parameter nicht zusammen mit den anderen Parametern in Den Methodenaufruf einschließen, gibt Visual Basic .NET die Fehlermeldung zurück. Eine unbehandelte Ausnahme vom Typ 'System.MissingMemberException' ist in microsoft.visualbasic.dllaufgetreten und informiert Sie darüber, dass die Methode nicht mit der Anzahl der parameter aufgerufen werden kann, die Sie geschrieben haben. Wenn Sie diese Meldung erhalten, stellen Sie sicher, dass der Include-Kontextparameter als Parameter in der Liste der Parameter für die Methode enthalten ist. - False. Visual Basic .NET schließt den Kontext nicht automatisch als zusätzlichen Parameter in das Argument ein. Wenn Sie diese Eigenschaft auf "False" festlegen und den COMTIContext-Parameter zusammen mit den anderen Parametern einschließen, gibt Visual Basic .NET die Fehlermeldung zurück. Eine unbehandelte Ausnahme vom Typ "System.MissingMemberException" ist in microsoft.visualbasic.dllaufgetreten und informiert Sie darüber, dass die Methode nicht mit der Anzahl der parameter aufgerufen werden kann, die Sie geschrieben haben. Wenn Sie diese Meldung erhalten, entfernen Sie den COMTIContext-Parameter aus der Methodenparameterliste. Der Standardwert ist True.
Anfangspufferwert	Geben Sie den anfänglichen Pufferwert ein. Der Standardwert ist NULL.
Ist-Verknüpfung	Wählen Sie aus, ob die Hostobjektmethode das Link-Programmiermodell verwendet. Mögliche Werte für die von Windows initiierte Verarbeitung (WIP) sind: - True. Verwenden Sie das Linkmodell. Das Linkprogrammierungsmodell kann nur mit CICS-Verbindungsprotokollen verwendet werden. - False. Verwenden Sie das Linkmodell nicht. Der Standardwert ist False. Die möglichen Werte für die vom Host initiierte Verarbeitung (HIP) sind: - Ja. Verwenden Sie das Linkmodell. Das Linkprogrammiermodell kann mit allen Protokollen verwendet werden. - Nein. Verwenden Sie das Linkmodell nicht. - Link mit 32K In/Out. Verwenden Sie das Link-Modell und legen Sie die Eigenschaften "Von Host" und "An Host" fest. Der Standardwert ist No.
Metadaten	Wählen Sie aus, wie Metadaten behandelt werden. Mögliche Werte sind: - (none). Standardmäßig werden keine speziellen Daten an die Hostanwendung gesendet oder empfangen. Wählen Sie diese Optionsschaltfläche aus, wenn Sie nur die Daten für die Methode senden und empfangen möchten. - Einschließen von Methodeninformationen. Der Name dieser Methode, die zusammen mit Parameterdaten an den Host gesendet werden soll. Der Methodenname wird als erste 32 Bytes im Puffer gesendet. Diese Option ist nützlich, wenn mehrere Methodenaufrufe zur gleichen Transaktion gelangen und Sie die Daten der verschiedenen Aufrufe unterscheiden möchten. - Alle Informationen einschließen. Alle Metadaten, die mit Ihren Methodendaten gesendet und empfangen werden können. Ausführliche Informationen zum Format der Metadaten finden Sie in der Beschreibung für "Optionale Metadaten".
Name	Geben Sie den Namen der Methode ein. Der Name kann maximal 250 Unicode-Zeichen umfassen. Der Name muss sich von einem anderen Methodennamen im selben Projekt unterscheiden. Der Standardwert ist NULL.
Positioniere Rückgabewert nach	Geben Sie den Rückgabewert der Automatisierungsmethode ein, der dem ausgewählten Datenelement folgt, wenn es vom Host empfangen wird. Diese Option wirkt sich nicht auf die Automatisierungsseite aus. Verwenden Sie diese Option, wenn das Datenelement, das Sie als Rückgabewert für die Automatisierung angeben möchten, nicht das erste Datenelementfeld in der Datendeklaration ist, das die vom Host empfangenen Daten beschreibt.
Vorläufiges Füllfeld	Zeigen Sie die Anzahl der Bytes an, die FILLER empfangen oder an den Host gesendet hat.
Vom Host	Geben Sie die Anzahl der Bytes von FILLER ein, die auf dieses Datenelement in den Puffern folgt, die vom Server empfangen werden. FILLER verursacht eine nicht übersetzte Lücke im Puffer. FILLER ist auf der Automatisierungsseite nicht sichtbar.
Zu hosten	Geben Sie die Anzahl der Bytes von FILLER ein, die diesem Datenelement in den Puffern folgen, die an den Server gesendet werden. FILLER verursacht eine nicht übersetzte Lücke im Puffer. FILLER ist auf der Automatisierungsseite nicht sichtbar.
Rückgabetyp	Wählen Sie den Rückgabewerttyp aus. Mögliche Werte sind: - Void - Boolean - Byte - Datum - Währung - Dezimal - Ganzzahl - Lange - Doppel - Einzel - Schnur - Benutzerdefinierter Typ - Recordset - (kein) (Standard)
Endgültiges Feld mit variabler Größe	– Wählen Sie diese Option aus, wenn das letzte Datenelement eine Zeichenfolge ist, um anzugeben, dass die Größe der Zeichenfolge variiert. Diese Option wird auch verwendet, um eine Datentabelle oder ein Recordset entweder als begrenzt oder als alle Zeilen umfassend zu definieren, wie im Parameter als Maximales Vorkommen festgelegt.
Vom Host	- STIMMT - False (Standard)
Zu hosten	- STIMMT - False (Standard)

Eigenschaften der Hostdefinition

Verwenden Sie diese	Um dies zu tun
Link-zum-Programmnamen	Geben Sie den Link-zu-Programm-Namen (CICS LINK/DPL) ein.
Spiegeltransaktions-ID	Geben Sie die von dieser Methode verwendete Spiegel-TRANID ein, wenn Sie die Spiegel-TRANID für die Remoteumgebung (RE) außer Kraft setzen möchten, der diese Komponente zugeordnet ist. Wenn Sie dieses Feld leer lassen, wird die "mirror TRANID" aus der Beschreibung der Remote-Umgebung verwendet. Die TRANID kann bis zu vier Zeichen lang sein. Zulässige Zeichen sind A-Z a-z 0-9 $ @ # . / _ % & ? ! : | = , ; <>. Transaktionsnamen, die mit C beginnen, sind für CICS reserviert und sollten nicht verwendet werden. Die Zeichen % und & können Probleme mit der Zugriffskontrolleinrichtung (Resource Access Control Facility, RACF) verursachen, wenn die Transaktionssicherheit aktiv ist.
TP-Name	Geben Sie einen TP-Namen (Source Transaction Program) ein, wenn das CICS-Anwendungsprogramm auf eine DB2-Datenbank zugreifen muss. Auf den TP-Namen wird in einem CICS Resource Control Table (RCT)-Eintrag verwiesen, der CICS-Transaktionen db2-Plänen zuordnet. Gibt den Namen des Transaktionsprogramms des Hosts (IMS oder CICS) oder des Verknüpfungsprogramms (CICS LINK/DPL) an.

Recordset-Eigenschaften

Verwenden Sie diese	Um dies zu tun
Tatsächliche Größe einschließen	Das Hostprogramm enthält oder erwartet keine Informationen, die die tatsächliche Anzahl von Zeilen (Recordsets) oder Elementen (Arrays) angibt, die gesendet oder empfangen werden. Mögliche Werte sind: - STIMMT - False (Standard) Diese Eigenschaft ist schreibgeschützt und wird immer auf False festgelegt; es sei denn, sie wurde bei der Erstellung der Typbibliothek mit der ersten Version von COM Transaction Integrator auf True festgelegt.
Maximales Vorkommen	Maximales Zeilenvorkommen. Gibt die maximale Anzahl von Zeilen an, die an den Host gesendet oder empfangen werden sollen. Entspricht dem Schlüsselwort "OCCURS n TIMES" bei einem COBOL-Gruppenelement. Der Standardwert lautet 1.
Tritt auf je nach	Entspricht Tabellen mit variabler Länge in COBOL. Gibt an, dass ein numerisches Datenelement vor der Tabelle (Recordset oder Array in der Automatisierung) die tatsächliche Anzahl von Zeilen oder Elementen angibt, die gesendet oder empfangen werden. Verwenden Sie die Dropdownliste, um auszuwählen, welches numerische Datenelement diesen Wert angibt. Bei CICS Link muss das Recordset oder Array und der zugehörige Längenbezeichner ein-/aus sein. Die Daten im Puffer, die einer Variablenlängentabelle folgen, folgen unmittelbar dem letzten Datenelement in der Tabelle, unabhängig von der für die Tabelle angegebenen maximalen Größe. Für Arrays mit mehreren Dimensionen kann sie nur für die äußerste Schleife (COBOL) oder die rechteste Dimension (Visual C++ oder Visual Basic) verwendet werden. Der resultierende Recordset hängt vom Rückgabewert ab. Der Standardwert ist (keine).
Unbegrenzte	Gibt an, dass das Recordset ungebunden ist. Gibt an, dass eine beliebige Anzahl von Zeilen an den Host gesendet oder empfangen werden kann. Sie würden diese Option auswählen, wenn die gesendeten oder empfangenen Zeilen aus einer Datenbank stammen und die maximale Anzahl von Zeilen nicht bekannt ist. Mögliche Werte sind: - True. Wenn das letzte Datenelement eine Zeichenfolge ist, bedeutet dies, dass die Größe der Zeichenfolge variiert. - False. Wenn das letzte Datenelement ein Array ist, bedeutet dies, dass die Anzahl der Elemente im Array variiert. Wenn das letzte Datenelement ein Recordset ist, bedeutet dies, dass die Anzahl der Zeilen im Recordset variiert. (Standard)

Vorsicht

Die Eigenschaften einer Komponente sollen nicht programmgesteuert festgelegt oder geändert werden. Das programmgesteuerte Festlegen oder Ändern der Eigenschaften kann dazu führen, dass die Komponente falsch funktioniert.

Siehe auch

Benutzerdefinierte TRMs und ELMs mit COMTIContext
Methodennameknoten (.NET)
Properties (TI Project)