Grundlegende Hostinteraktion

In diesem Beispiel wird die grundlegende Hostinteraktion dargestellt. Dazu zählen die folgenden Interaktionen:

Für alle Makros sind standardmäßig die folgenden Objekte verfügbar:

// Neue Makrofunktion erstellen
var macro = createMacro(function*(){
	'use strict';
	
	// Für alle Makros sind standardmäßig die folgenden Objekte verfügbar:
	// 1. session – Hauptzugriffspunkt zum Host. Kann Verbindungen herstellen und trennen und bietet Zugriff auf das PresentationSpace-Objekt.
	//    Das aus der Sitzung abgerufene PresentationSpace-Objekt stellt den Bildschirm dar und bietet zahlreiche allgemeine Funktionen wie das Abrufen und Einrichten der
	//    Cursorposition, das Senden von Daten an den Host und das Lesen auf dem Bildschirm.
	// 2. wait - Dieses Objekt bietet eine einfache Möglichkeit, auf das Auftreten der verschiedenen Hoststatus zu warten, bevor weitere Daten gesendet oder auf dem Bildschirm gelesen werden.
	// 3. ui – Stellt die grundlegenden Funktionen der Benutzeroberfläche bereit. Benutzern Daten anzeigen oder Informationen von Benutzern abfragen.
	
	// Eine Variable zum Lesen und Anzeigen von Bildschirmdaten deklarieren.
	// Es wird empfohlen, alle Variablen im oberen Bereich einer Funktion zu deklarieren.
	var numberOfAccounts = 0;
	
	// Mit dem Abrufen des PresentationSpace-Objekts beginnen, das zahlreiche gängige Bildschirmoperationen bereitstellt.
	var ps = session.getPresentationSpace();
	
	try {
		// Kann die Cursorposition einrichten und abrufen
		ps.setCursorPosition(new Position(24, 2));
		
		// Die sendKeys-Funktion zum Senden von Zeichen an den Host verwenden
		ps.sendKeys('cics');
		
		// SendKeys wird auch zum Senden von Hosttasten wie PA- und PF-Tasten verwendet.
		// Siehe "Steuertasten" in der Dokumentation für alle verfügbaren Optionen
		ps.sendKeys(ControlKey.ENTER);
		
		// Darauf warten, dass der Cursor die korrekte Position erreicht.
		// Das wait-Objekt bietet verschiedene Funktionen zum Warten auf das Eintreten bestimmter Status,
		// sodass Sie weitere Tasten senden oder Daten auf dem Bildschirm lesen können.
		yield wait.forCursor(new Position(24, 2));
		
		// Sie können Zeichen und Steuerungstasten gemeinsam in einem sendKeys-Aufruf verwenden.
		ps.sendKeys('data' + ControlKey.TAB + ControlKey.TAB + 'more data' + ControlKey.ENTER);
		
		// Das "yield"-Schlüsselwort muss allen "wait"- und "ui"-Funktionsaufrufen voranstehen.
		// Es weist den Browser an, die Ausführung des Makros anzuhalten, bis die
		// (asynchrone) wait-Funktion zurückgegeben wird. Informationen darüber, welche Funktionen das yield-Passwort
		// erfordern, finden Sie in der Dokumentation.
		yield wait.forCursor(new Position(10, 26));
		ps.sendKeys('accounts' + ControlKey.ENTER);
		
		// Kann auch darauf warten, dass in bestimmten Bereichen des Bildschirms Text angezeigt wird
		yield wait.forText('ACCOUNTS', new Position(3, 36)) ;
		ps.sendKeys('1' + ControlKey.ENTER);
		
		// Alle wait-Funktionen werden unterbrochen, wenn die Kriterien nicht innerhalb einer bestimmten Zeitspanne erfüllt werden.
		// Kann mit einem optionalen Parameter in den wait-Funktionen die Wartezeit erhöhen (in Millisekunden)
		// Alle Wartezeiten werden in Millisekunden angegeben. Der Standardwert ist 10 Sekunden (10000 ms).
		yield wait.forCursor(new Position(1, 1), 15000);
		ps.sendKeys('A' + ControlKey.ENTER);
		
		// PS provides the getText function for reading text from the screen
		numberOfAccounts = ps.getText(new Position(12, 3), 5);
		
		// Use the ui object to display some data from the screen
		ui.message('Number of active accounts: ' + numberOfAccounts);
		
		// The try / catch allows all errors to be caught and reported in a central location
	} catch (error) {
		// Again we use the ui object to display a message that an error occurred
		yield ui.message('Error: ' + error.message);
	}
	//End Generated Macro
});

// Run the macro and return the results to the Macro Runner
// The return statement is required as the application leverages
// this to know if the macro succeeded and when it is finished
return macro();