Methodeneigenschaften
Verwenden Sie die Seite Methodeneigenschaften , um Array-, COBOL-, Design-, Hostdefinitions- und Recordseteigenschaften für die -Methode festzulegen.
Arrayeigenschaften
| Option | Aufgabe |
|---|---|
| Arraydimensionen | Wählen Sie die Arraydimensionen 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: - STIMMT - False (Standard) |
| Tritt je nach | Wählen Sie diese Option aus, um anzugeben, dass ein numerisches Datenelement vor der Tabelle (Recordset oder Array in Automation) 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. Für CICS Link müssen sich das Recordset oder Array und der zugehörige Längenbezeichner ein-/aus befinden. Die Daten im Puffer, die einer Tabelle mit variabler Länge folgen, folgen sofort 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 ganz rechts (Microsoft® Visual C++ ® oder Visual Basic) verwendet werden. Der Standardwert ist (keine). |
COBOL-Eigenschaften
| Option | Aufgabe |
|---|---|
| Hostdatentyp | Wählen Sie den Hostdatentyp aus. |
| Fehlerbehandlung | Wählen Sie die Rückgabewertfehlerbehandlung aus. Mögliche Werte: - Abschneiden. Wählen Sie diese Option aus, um ti so festzulegen, dass der Wert abgeschnitten wird, wenn ein Fehler auftritt. (Standard) - Rund. Wählen Sie diese Option aus, um TI so festzulegen, dass der Wert gerundet wird, wenn ein Fehler auftritt. - Fehler. Wählen Sie diese Option aus, um festzulegen, dass TI einen Fehler zurückgibt, wenn ein Fehler auftritt. |
| Filler | Geben Sie den Rückgabewertfüller ein. Der Standardwert ist 0. |
| Vom Host | Geben Sie die Anzahl der Bytes von FILLER ein, die diesem Datenelement in den Puffern folgen, die vom Server empfangen werden. FILLER verursacht eine nicht übersetzte Lücke im Puffer. FILLER ist auf der Automation-Seite nicht sichtbar. Der Standardwert ist 0. |
| So 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 Automation-Seite nicht sichtbar. Der Standardwert ist 0. |
| Skalieren | Geben Sie die Rückgabewertskala ein. |
| Sign-Attribut | Wählen Sie das Attribut des Rückgabewertzeichens aus. Mögliche Werte: - Nachgestellt. Bei signierten DISPLAY-Datentypen gibt an, dass das Zeichen nachgestellt ist (Standard). Diese Option gibt für die TI-Laufzeitumgebung an, wie ein signierter DISPLAY-Datentyp formatiert ist, und wirkt sich darauf aus, wie Daten vom Host in und aus dem Automation-Datentyp konvertiert werden. - Nachgestellt getrennt. Für den datentyp DISPLAY mit Vorzeichen gibt an, dass das Zeichen getrennt ist. Diese Option gibt für die TI-Laufzeitumgebung an, wie ein signierter DISPLAY-Datentyp formatiert ist, und wirkt sich darauf aus, wie Daten vom Host in und aus dem Automation-Datentyp konvertiert werden. - Führend. Gibt für den display-Datentyp mit Vorzeichen an, dass das Zeichen führend ist. Diese Option gibt für die TI-Laufzeitumgebung an, wie ein signierter DISPLAY-Datentyp formatiert ist, und wirkt sich darauf aus, wie Daten vom Host in und aus dem Automation-Datentyp konvertiert werden. - Führen sie getrennt aus. Für den datentyp DISPLAY mit Vorzeichen gibt an, dass das Zeichen getrennt ist. |
| Größe | Geben Sie die Rückgabewertgröße ein. |
| SOSI | Wählen Sie diese Option aus, um anzugeben, für welche Doppelbyte-Zeichensatzdaten erwartet wird, dass sie mit einem Shift-Out (SO) beginnen und mit einem SI-Zeichen (Shift-In) enden. Mögliche Werte: - 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 werden. In der Länge des PIC G ist es nicht erforderlich, die beiden Bytes für die Zeichen SO und SI einzuschließen, da sie von der TI-Laufzeitumgebung angewendet werden. - False (Standard) |
| Zeichenfolgentrennzeichen | Wählen Sie die Rückgabewertzeichenfolge aus, die durch Trennzeichen getrennt wird. Mögliche Werte: - Leerraum. Teilt der TI-Laufzeitumgebung mit, dass die Mainframedarstellung der Zeichenfolge durch Auffüllen der Zeichenfolgendefinition mit Leerzeichen getrennt wird. Wenn die COBOL-Definition des Mainframes beispielsweise PIC X(10) lautet, sich aber nur drei Zeichen in der Zeichenfolge befinden, erwartet der Mainframe sieben nachfolgende Leerzeichen. Wenn Sie diese Option auswählen, wird die TI-Laufzeitumgebung daher aufgefordert, Zeichenfolgen zu konvertieren, die an den Mainframe gesendet werden, um das NULL-Beendigungszeichen der Zeichenfolge in die entsprechende Anzahl von nachgestellten Leerzeichen zu ändern, bevor sie an den Mainframe gesendet werden. Wenn die Zeichenfolge beispielsweise auf dem Mainframe als PIC X(10) definiert ist, sendet TI eine ABC-Zeichenfolge gefolgt von sieben nachfolgenden Leerzeichen. Wenn Sie diese Option auswählen, wird die TI-Laufzeitumgebung außerdem aufgefordert, die vom Mainframe zurückgegebene Ausgabezeichenfolge in den TI Automation-Server zu konvertieren, indem die nachfolgenden Leerzeichen der Zeichenfolge in ein einzelnes NULL-Terminierungszeichen konvertiert werden. Weitere Informationen finden Sie unter Auffüllen von Mainframe-Zeichenfolgen mit Leerzeichen. (Standard) - Null beendet. Teilt der TI-Laufzeitumgebung mit, dass die Mainframedarstellung der Zeichenfolge durch ein NULL-Zeichen (EBCDIC 0x00) getrennt ist. Wenn Sie diese Option auswählen, weist die TI-Laufzeitumgebung an, am Ende einer Zeichenfolge ein einzelnes NULL-Zeichen hinzuzufügen, wenn platz für das Byte vorhanden ist, bevor eine Zeichenfolge an den Mainframe gesendet wird, und die TI-Laufzeitumgebung wird aufgefordert, beim ersten NULL-Zeichen anzuhalten, das beim Empfangen einer Zeichenfolge vom Mainframe gefunden wird. 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-Abschlussator konvertiert. Weitere Informationen finden Sie unter Auffüllen von Mainframe-Zeichenfolgen mit Leerzeichen. |
Entwurfseigenschaften
| Option | Aufgabe |
|---|---|
| 32.000 Ein/Aus zulassen | Wählen Sie diese Option aus, wenn TI die Eingabe DFHCOMMAREA unabhängig von der Ausgabe DFHCOMMAREA behandeln soll. TI kombiniert in der Regel den Eingabebereich DFHCOMMAREA und den Ausgabebereich DFHCOMMAREA. Die kombinierten Bereiche dürfen 32 KB Daten nicht überschreiten. Wenn diese Option ausgewählt ist, behandelt TI die Eingabe DFHCOMMAREA unabhängig von der Ausgabe DFHCOMMAREA. Jeder Eingabe- und Ausgabebereich verbraucht 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 CICS-Programmiermodell (Windows-Initiated Processing, WIP) und in allen HIP-Programmiermodellen (HostInitiierte Verarbeitung) 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 beim Aufrufen dieser Methode eine Ausnahme auftritt. Der Standardwert ist 0. |
| Kontextparameter einschließen | Wählen Sie aus, ob die Clientobjektmethode automatisch Kontext enthält. Mögliche Werte: - 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 ihren anderen Parametern in Ihren Methodenaufruf einschließen, gibt Visual Basic .NET die Fehlermeldung Eine nicht behandelte Ausnahme des Typs "System.MissingMemberException" in microsoft.visualbasic.dllzurück und informiert Sie darüber, dass die Methode nicht mit der Anzahl der von Ihnen geschriebenen Parameter aufgerufen werden kann. Wenn Sie diese Meldung erhalten, überprüfen Sie, ob 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 in Ihren Methodenaufruf zusammen mit Ihren anderen Parametern einschließen, gibt Visual Basic .NET die Fehlermeldung Eine nicht behandelte Ausnahme des Typs "System.MissingMemberException" in microsoft.visualbasic.dllzurück und informiert Sie darüber, dass die Methode nicht mit der Anzahl der von Ihnen geschriebenen Parameter aufgerufen werden kann. 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. |
| Is Link | Wählen Sie aus, ob die Hostobjektmethode das Link-Programmiermodell verwendet. Die möglichen Werte für die Windows-initiierte Verarbeitung (WIP) sind: - TRUE. Verwenden Sie das Linkmodell. Das Linkprogrammiermodell kann nur mit CICS-Linkprotokollen verwendet werden. - FALSE. Verwenden Sie nicht das Linkmodell. Der Standardwert ist False. Die möglichen Werte für die hostinitiierte Verarbeitung (HIP) sind: - Ja. Verwenden Sie das Linkmodell. Das Linkprogrammiermodell kann mit allen Protokollen verwendet werden. - Nein. Verwenden Sie nicht das Linkmodell. - Link mit 32K Ein-/Aus. Verwenden Sie das Linkmodell, 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: - (keine). Standardmäßig werden keine speziellen Daten an die Hostanwendung gesendet oder von dieser empfangen. Wählen Sie diese Optionsschaltfläche aus, wenn Sie nur die Daten für die -Methode senden und empfangen möchten. - Schließen Sie Methodeninformationen ein. Der Name dieser Methode, die an den Host gesendet werden soll, zusammen mit Parameterdaten. Der Methodenname wird als die ersten 32 Bytes im Puffer gesendet. Diese Option ist nützlich, wenn mehrere Methodenaufrufe an dieselbe Transaktion gehen und Sie die Daten von den verschiedenen Aufrufen unterscheiden möchten. - Alle Informationen einschließen. Alle Metadaten, die mit Ihren Methodendaten gesendet und empfangen werden können. Ausführliche Informationen zum Format von 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 jedem anderen Methodennamen im selben Projekt unterscheiden. Der Standardwert ist NULL. |
| Positionsrückgabewert nach | Geben Sie den Rückgabewert der Automation-Methode ein, der dem ausgewählten Datenelement folgt, wenn es vom Host empfangen wird. Diese Option wirkt sich nicht auf die Automation-Seite aus. Verwenden Sie diese Option, wenn das Datenelement, das Sie als Automation-Rückgabewert angeben möchten, nicht das erste Datenelementfeld in der Datendeklaration ist, das die vom Host empfangenen Daten beschreibt. |
| Vorläufiger Füllstoff | Zeigen Sie die Anzahl der Bytes von FILLER an, die vom Host empfangen oder an diesen gesendet werden. |
| Vom Host | Geben Sie die Anzahl der Bytes von FILLER ein, die diesem Datenelement in den Puffern folgen, die vom Server empfangen werden. FILLER verursacht eine nicht übersetzte Lücke im Puffer. FILLER ist auf der Automation-Seite nicht sichtbar. |
| So hosten | Geben Sie die Anzahl der Bytes von FILLER ein, die diesem Datenelement in den Puffern folgt, die an den Server gesendet werden. FILLER verursacht eine nicht übersetzte Lücke im Puffer. FILLER ist auf der Automation-Seite nicht sichtbar. |
| Rückgabetyp | Wählen Sie den Rückgabewerttyp aus. Mögliche Werte: - Leere - Boolean - Byte - Datum - Währung - Decimal - Ganzzahl - Lange - Doppel - Einzelnen - Schnur - Benutzerdefinierter Typ - Recordset - (keine) (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 so zu definieren, dass sie entweder begrenzt ist oder alle Zeilen einschließt, die als Maximum Occurrence set für den Parameter definiert sind. |
| Vom Host | - STIMMT - False (Standard) |
| So hosten | - STIMMT - False (Standard) |
Hostdefinitionseigenschaften
| Option | Aufgabe |
|---|---|
| Link-zu-Programmname | Geben Sie den Link-zu-Programm-Namen (CICS LINK/DPL) ein. |
| Transaktions-ID spiegeln | Geben Sie die Spiegel TRANID ein, die diese Methode verwendet, wenn Sie die Spiegel TRANID für die Remoteumgebung (RE) überschreiben möchten, der diese Komponente zugeordnet ist. Wenn dieses Feld leer bleibt, wird die Spiegel TRANID in der Remoteumgebungsbeschreibung 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 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 RCT-Eintrag (CICS Resource Control Table) verwiesen, der CICS-Transaktionen DB2-Plänen ordnet. Gibt den Namen des Hosttransaktionsprogramms (IMS oder CICS) oder den Link-zu-Programmnamen (CICS LINK/DPL) an. |
Recordseteigenschaften
| Option | Aufgabe |
|---|---|
| Tatsächliche Größe einschließen | Das Hostprogramm enthält oder erwartet keine Informationen, die die tatsächliche Anzahl der gesendeten oder empfangenen Zeilen (Recordsets) oder Elemente (Arrays) angeben. Mögliche Werte: - STIMMT - False (Standard) Diese Eigenschaft ist schreibgeschützt und wird immer auf False festgelegt, es sei denn, sie wurde zum Zeitpunkt 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 vom Host empfangen werden sollen. Entspricht dem SCHLÜSSELWORT (KEYWORD) OCCURS n TIMES für ein COBOL-Gruppenelement. Der Standardwert lautet 1. |
| Tritt je nach | Entspricht Tabellen mit variabler Länge in COBOL. Gibt an, dass ein numerisches Datenelement vor der Tabelle (Recordset oder Array in Automation) 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. Für CICS Link müssen sich das Recordset oder Array und der zugehörige Längenbezeichner ein-/aus befinden. Die Daten im Puffer, die einer Tabelle mit variabler Länge folgen, folgen sofort 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 äußerste Dimension (Visual C++ oder Visual Basic) verwendet werden. Das Rückgabewert-Recordset erfolgt abhängig von. Der Standardwert ist (keine). |
| Unbegrenzte | Gibt an, dass das Recordset nicht gebunden ist. Gibt an, dass eine beliebige Anzahl von Zeilen an den Host gesendet oder vom Host empfangen werden kann. Sie wählen diese Option aus, wenn die gesendeten oder empfangenen Zeilen aus einer Datenbank stammen und die maximale Anzahl von Zeilen nicht bekannt ist. Mögliche Werte: - 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) |
Achtung
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 nicht ordnungsgemäß funktioniert.
Weitere Informationen
Benutzerdefinierte TRMs und ELMs mit COMTIContext
Knoten „Methodenname“ (.NET)
Eigenschaften (TI-Projekt)