Beispielmakros

var macro = createMacro(function*(){
  'use strict';

  // Das "ui"-Objekt stellt Funktionen zur Abfrage und Anzeige von Informationen bereit

  // Variablen für eine spätere Verwendung deklarieren
  var username;
  var password;
  var flavor;
  var scoops;

  //Start generiertes Makro
  var ps = session.getPresentationSpace();

  try {
    // Benutzer zur Eingabe ihres Namens auffordern und den Namen in einer Variable speichern.
    // Das 'yield'-Schlüsselwort ist zum Blockieren der Ausführung erforderlich, während auf die Benutzereingabe gewartet wird.
    username = yield ui.prompt('Geben Sie Ihren Benutzernamen ein');

    // Benutzer mit bereitgestelltem Standard zur Eingabe eines Werts auffordern.
    flavor = yield ui.prompt('Was ist Ihre Lieblingseissorte?', 'Schokolade');

    // Benutzer über die 'mask'-Option zur Eingabe persönlicher Informationen auffordern. Das Eingabefeld wird bei der Eingabe maskiert.
    // Wenn ein Parameter nicht verwendet wird, kann mit 'null‘ angegeben werden, dass er nicht verwendet werden soll.
    // Hier zeigen wir durch die Angabe, dass wir keinen Standardwert zeigen müssen.
    password = yield ui.prompt('Geben Sie Ihr Passwort ein', null, true);

    // Die Aufforderung gibt null zurück, wenn der Benutzer nicht auf die Schaltfläche 'OK' klickt, sondern auf 'Abbrechen'.
    // Eine Möglichkeit zum Behandeln dieses Falls ist das Umbrechen des Aufrufs in einem try/catch-Block.
    scoops = yield ui.prompt('Wie viele Kugeln möchten Sie?');
    if (scoops === null) {
      // Dadurch wird das Makro beendet.
      return;
      // Alternativ könnte ein Fehler ausgegeben und im nachstehenden "Catch“ erfasst werden
     }
     // Die gesammelten Werte verwenden, um das Eis zu bestellen 
    ps.sendKeys(username + ControlKey.TAB + password + ControlKey.ENTER); 
    yield wait.forCursor(new Position(5, 1)); 
    ps.sendKeys(flavor + ControlKey.TAB + scoops + ControlKey.ENTER);

     // Dem Benutzer eine Meldung anzeigen. Durch die Verwendung des 'yield'-Schlüsselworts vor dem Aufruf wird die
     // weitere Ausführung des Makros blockiert, bis der Benutzer auf die Schaltfläche 'OK' klickt.
    yield ui.message('Bestellung erfolgreich. Genießen Sie Ihr ' + scoops + ' Kugeln ' + flavor + ' Eiscreme ' + username + '!');
    } catch (error) {
     // Hier verwenden wir das ui-Objekt zum Anzeigen einer Fehlermeldung
    yield ui.message(error.message);
    }
    //Ende generiertes Makro

});

return macro();

// Neue Makrofunktion erstellen.
var macro = createMacro(function*(){
  'use strict';

  // Variable(n) für eine spätere Verwendung erstellen var password;
  var accountNumber;
  var transactionCount = 0;
  var row = 0;

  // Eine Referenz zum PresentationSpace-Objekt abrufen.
  var ps = session.getPresentationSpace();

  try {
    // Für die Anmeldung bei der Anwendung Benutzername und Passwort eingeben. 
    yield wait.forCursor(new Position(19, 48)); 
    ps.sendKeys('bjones' + ControlKey.TAB);

    yield wait.forCursor(new Position(20, 48));
    password = yield ui.prompt('Password:', null, true); 
    ps.sendKeys(password); 
    ps.sendKeys(ControlKey.ENTER);

    // Anwendungsbefehl eingeben. 
    yield wait.forCursor(new Position(20, 38)); 
    ps.sendKeys('4'); 
    ps.sendKeys(ControlKey.ENTER);

    // Transaktionen für ein Konto werden aufgelistet. 
    yield wait.forCursor(new Position(13, 25)); 
    ps.sendKeys('2');
    // Kontonummer eingeben. Hier zur Erleichterung hartcodiert. 
    yield wait.forCursor(new Position(15, 25));
    accountNumber = yield ui.prompt('Kontonummer:', '167439459'); 
    ps.sendKeys(accountNumber); 
    ps.sendKeys(ControlKey.ENTER);

    // Warten, bis auf dem Kontoprofilbildschirm vorhanden 
    yield wait.forText('ACCOUNT PROFILE', new Position(3, 33));

    // Nach Text suchen, der anzeigt, dass die letzte Seite des Datensatzes erreicht wurde
    while (ps.getText(new Position(22, 12), 9) !== 'LAST PAGE') {

      // Während die letzte Seite mit Datensätzen nicht erreicht wurde, zur nächsten Seite mit Datensätzen wechseln. 
      ps.sendKeys(ControlKey.PF2); 
      yield wait.forCursor(new Position(1, 1));

      // Wenn die Cursorposition nicht zwischen Datensatzbildschirmen wechselt und der Bildschirm keinen Text enthält,
      // können Sie prüfen, ob ein Bildschirm aktualisiert wurde. Sie können eine
      // festgelegte Zeitspanne warten, bis eine aid-Taste für den Aufbau des Bildschirms gesendet wird.
      // Zum Beispiel:
      // yield wait.forFixedTime(1000);

      // Für alle Zeilen die Zählvariable erhöhen, wenn sie Daten enthalten.
      for (row = 5; row <= 21; row++) {

        // Es befinden sich zwei Spalten auf dem Bildschirm. Daten in Spalte 1 prüfen.
        // In diesem Beispiel wissen wir: Wenn sich an einer bestimmten
        // Position ein Leerzeichen befindet, liegt eine Transaktion vor.
        if (ps.getText(new Position(row, 8), 1) !== ' ') {
          transactionCount++;
        }
        // Daten in Spalte 2 prüfen.
        if (ps.getText(new Position(row, 49), 1) !== ' ') {
          transactionCount++;
        }
      }
    }

    // Nach dem Durchlaufen aller Datensatzseiten die Anzahl der Datensätze in einem Meldefenster anzeigen.
    yield ui.message('Es wurden ' + transactionCount + ' für Ihre Konto ' + accountNumber + ' gefunden.');

    // Log out of the application
    ps.sendKeys(ControlKey.PF13);
    ps.sendKeys(ControlKey.PF12);

    // The try / catch allows all errors to be caught and reported in a central location
  } catch (error) {
    // Here we use the ui object to display a message that an error occurred
    yield ui.message(error.message);
  } 
});  

// Here we 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
return macro();

 var macro = createMacro(function*() {
  'use strict';

  // Einige Variablen für eine spätere Verwendung erstellen;
  var username;
  var password;
  var accountNumber;
  var accountDetails;

  // Eine Funktion erstellen, die einen AJAX / REST-Aufruf an einen VHI-Webdienst ausführt.
  // Kann für den Aufruf eines beliebigen Webdienstes (nicht nur VHI) angepasst werden.
  // Wenn nicht CORS verwendet wird, muss die Anforderung wahrscheinlich einen
  // Proxy auf dem Sitzungsserver durchlaufen. Siehe Beispielhinweise für weitere Informationen.
  /**
   * Hartcodierte Unterstützungsfunktion zum Einschließen von AJAX / REST-Parametern, zum Aktivieren des
   * REST-Dienstes und zum Zurückgeben der Ergebnisse in einem Promise-Objekt.
   * @param {Number} Kontonummer zum Senden an die REST-Abfrage.
   * @param {String} Benutzername für den Zugriff auf den REST-Dienst.
   * @param {String} Passwort für den Zugriff auf den REST-Service.
   * @return {Promise} enthält $.post()-Ergebnisse, die mit yield kompatibel sind. 
  */
  var getAccountDetails = function (acctNum, username, password) {
    var url = "proxy1/model/CICSAcctsDemo/GetAccountDetail";
    var args = {"filters": {"AcctNum": acctNum}, "envVars": {"Username": username, "Password": password}};

    // jQuery AJAX / HTTP POST-Aufruf in einem neuen Promise-Objekt umbrechen.
    // Das hier zurückgegebene Promise-Objekt ermöglicht dem Makro über yield / wait
    // auf seinen Abschluss zu warten.
    return Promise.resolve($.post(url, JSON.stringify(args)))
      .catch(function (error) {
      // Fehler zuordnen, die im jQuery-Aufruf an unser Promise-Objekt auftreten.
      throw new Error('REST API Error: ' + error.statusText);
    });
  };

  // Start generiertes Makro
  var ps = session.getPresentationSpace();
  try {
    // Konnte hier mit dem Host interagieren, sich bei einer Hostanwendung anmelden usw.
    // Benutzername und Passwort erfassen
    username = yield ui.prompt('Username:');
    password = yield ui.prompt('Passwort:', null, true);
    accountNumber = yield ui.prompt('Kontonummer:');
    if (!username || !password || !accountNumber) {
      throw new Error('Kein Benutzername oder Passwort angegeben');
    }

    // Externen REST-Dienst aktivieren, und yields / wartet auf den Abschluss des Aufrufs.
    accountDetails = yield getAccountDetails(accountNumber, username, password);

    // Jetzt haben wir die Daten von unserem externen Dienst.
    // Können die Daten in unsere lokale Hostanwendung integrieren oder die Daten einfach dem Benutzer anzeigen.
    // In diesem Beispiel zeigen wir einfach die sich ergebenden Kontodetails an.
    if (accountDetails.result && accountDetails.result.length > 0) {
      yield ui.message(accountDetails.result[0].FirstName + ' $' + accountDetails.result[0].AcctBalance);
    } else {
      yield ui.message('Kein Datensatz für folgendes Konto gefunden: ' + accountNumber);
    }
  } catch (error) {
    // Wenn während des AJAX / REST-Aufrufs
    // oder beim Erfassen von Benutzername/Passwort ein Fehler auftritt, befinden wir uns hier.
    yield ui.message(error.message);
  }
  });

// Unser Makro ausführen
return macro();

var macro = createMacro(function*() {
    'use strict';

    // Präsentationsbereich für die Interaktion mit dem Host abrufen
    var ps = session.getPresentationSpace();

    // Variablen für eine spätere Verwendung deklarieren
    var cells;
    var text;
    var attrs;

    // Standardwartezeit für "wait"-Funktionen festlegen
    wait.setDefaultTimeout(10000);

    // Beispielmakro für das Arbeiten mit Datenzellen und Attributen
    try { 
        yield wait.forCursor(new Position(24, 2));

        // Datenzellen aus dem Präsentationsbereich abrufen
        // Zeile 19, Spalte 3 ist die Eingabeaufforderung 35 Zeichen lang
        // "Wählen Sie einen der folgenden Befehle:"
        cells = ps.getDataCells({row:19, col:3}, 35);
        text = '';

        // Sie können Text mithilfe von 'getText' anzeigen
        yield ui.message("Screen text: " + ps.getText({row:19, col:3}, 35));

        // Oder den Text aus den Datenzellen an den einzelnen Positionen bilden
        for(var index = 0; index < cells.length; index++) {
            text = text.concat(cells[index].getChar());
        }
        // Und den Text anzeigen
        yield ui.message("Cells text: " + text);

        // Attribute für die erste Datenzelle abrufen (cell[0])
        attrs = cells[0].getAttributes();

        // Anzeigen, ob Attribute für die Datenzelle vorhanden sind
        yield ui.message("Attribute set is empty: " + attrs.isEmpty());

        // Anzeigen, wie viele Attribute angegeben sind
        yield ui.message("Number of attributes: " + attrs.size());

        // Anzeigen, welche Attribute angegeben sind
        yield ui.message("Attributes: " + attrs.toString());

        // Anzeigen, ob das das Attribut 'HIGH_INTENSITY' angegeben ist
        yield ui.message("Is high intensity: " +
                         attrs.contains(Attribute.HIGH_INTENSITY));

        // Anzeigen, ob das Attribut 'UNDERLINE' angegeben ist
        yield ui.message("Is underline: " +
                         attrs.contains(Attribute.UNDERLINE));

        // Anzeigen, ob die Attribute 'ALPHA_NUMERIC', 'HIGH_INTENSITY' und 'PEN_DETECTABLE' angegeben sind
        yield ui.message("Is alphanumeric, intensified and pen-detectable: " +
                         attrs.containsAll([Attribute.ALPHA_NUMERIC, Attribute.HIGH_INTENSITY, Attribute.PEN_DETECTABLE]));

        // Anzeigen, ob die Attribute 'UNDERLINE', 'HIGH_INTENSITY' und 'PEN_DETECTABLE' angegeben sind
        yield ui.message("Is underline, intensified and pen-detectable: " +
                         attrs.containsAll([Attribute.UNDERLINE, Attribute.HIGH_INTENSITY, Attribute.PEN_DETECTABLE]));
    } catch (error) {
        yield ui.message(error);
    }
 //Generiertes Makro beenden
});

// Zurückgegebenes Makro ausführen
return macro();

var macro = createMacro(function*() {
    'use strict';

    // Präsentationsbereich für die Interaktion mit dem Host abrufen
    var ps = session.getPresentationSpace();

    // Variablen für eine spätere Verwendung deklarieren
    var fields;
    var field;
    var searchString = 'z/VM';

    // Standardwartezeit für "wait"-Funktionen festlegen
    wait.setDefaultTimeout(10000);

    // Beispielmakro für das Arbeiten mit Feldlisten und Feldern
    try { 
        yield wait.forCursor(new Position(24, 2));

        // Feldliste abrufen.
        fields = ps.getFields();

        // Die gesamte Feldliste durchlaufen und Feldinfo anzeigen.
        for(var index = 0; index < fields.size(); index++) {
            field = fields.get(index);

            yield ui.message("Field " + index + " info: " + field.toString());
        }

        yield ui.message("Hier ein Feld mit dem Text '" + searchString + "'");
        field = fields.findField(new Position(1, 1), searchString);

        if(field !== null) {
            yield ui.message("Found field info: " + field.toString());
            yield ui.message("Found field foreground is green? " + (Color.GREEN === field.getForegroundColor()));
            yield ui.message("Found field background is default? " + (Color.BLANK_UNSPECIFIED === field.getBackgroundColor()));
        }

        // Jetzt nach einem Befehlsfeld suchen und es ändern.
        field = fields.findField(new Position(23, 80));
        if(field !== null) {
            field.setText("cics");
        }

        yield ui.message("Klicken Sie mit der Maus, um 'cics' an den Host zu senden."); 
        ps.sendKeys(ControlKey.ENTER);

        // Auf neuen Bildschirm warten; neue Felder abrufen. 
        yield wait.forCursor(new Position(10, 26));
        fields = ps.getFields();

        // Benutzerfeld suchen und festlegen.
        field = fields.findField(new Position(10, 24));        
        if(field !== null) {        
            field.setText("myusername");
        }
        // Passwortfeld suchen und festlegen.
        field = fields.findField(new Position(11, 24));
        if(field !== null) {        
            field.setText("mypassword");        
        }

        yield ui.message("Click to send login to host."); 
        ps.sendKeys(ControlKey.ENTER);

        // Auf neuen Bildschirm warten; neue Felder abrufen. 
        yield wait.forCursor(new Position(1, 1));
        fields = ps.getFields();

        // Befehlsfeld suchen und 'logoff'-Befehl festlegen.
        field = fields.findField(new Position(24, 45));
        if(field !== null) {        
            field.setText("cesf logoff");
        }

        yield ui.message("Click to send logoff to host.");
        ps.sendKeys(ControlKey.ENTER);

    } catch (error) {
        yield ui.message(error);
    }
    //Ende generiertes Makro

});

// Makro ausführen
return macro();

var macro = createMacro(function*() {
    'use strict';

    // Präsentationsbereich für die Interaktion mit dem Host abrufen
    var ps = session.getPresentationSpace();

    // Variable für Weiterleitungsticket für die Anmeldung
    var passTicket;

    // Anwendungs-ID für die Anmeldung
    var appId = 'CICSV41A';

    // Standardwartezeit für "wait"-Funktionen festlegen
    wait.setDefaultTimeout(10000);

    // Start generiertes Makro
    try { 
    yield wait.forCursor(new Position(24, 2));

       // Weiterleitungsticket von DCAS abrufen.
       passTicket = yield autoSignon.getPassTicket(appId);

        ps.sendKeys('cics');
        ps.sendKeys(ControlKey.ENTER);

        yield wait.forCursor(new Position(10, 26));

        // Generierten Benutzernamen mit 'sendUserName(passTicket) ...' ersetzen
        yield autoSignon.sendUserName(passTicket);

        // ps.sendKeys('bvtst01' + ControlKey.TAB + ControlKey.TAB); 
        ps.sendKeys(ControlKey.TAB + ControlKey.TAB);

        yield wait.forCursor(new Position(11, 26));

        // Generiertes Passwort mit 'sendPassword(passTicket) ...' ersetzen
        yield autoSignon.sendPassword(passTicket);

        // var userInput3 = yield ui.prompt('Passwort:', '', true);
         // if (userInput3 === null) {
             // throw new Error('Kein Passwort angegeben');
        // }
        // ps.sendKeys(userInput3);
        ps.sendKeys(ControlKey.ENTER);

        yield wait.forCursor(new Position(1, 1));
        yield ui.message('Angemeldet. Melde mich ab.'); 
        ps.sendKeys('cesf logoff'); 
        ps.sendKeys(ControlKey.ENTER);
    } catch (error) {
        yield ui.message(error);
    }
    //Ende generiertes Makro
});

// Makro ausführen
return macro();

var macro = createMacro(function*() {
    'use strict';

    try {
        var fileTransfer = fileTransferFactory.getInd$File();
        var hostFiles = yield fileTransfer.getHostFileListing();

        yield ui.message('Found ' + hostFiles.length + ' files');
        if (hostFiles.length > 0) {
            var firstFile = hostFiles[0];
            var msg1 = 'Der Katalogname lautet ' + firstFile.getParent() + '. ';
            var msg2 = 'The first file is ' + firstFile.getName();
            yield ui.message(msg1 + msg2);
        }
    } catch (error) {
        yield ui.message(error);
    }
});

// Makro ausführen
return macro();

var hostEnvironment = 'CMS';  // 'TSO'
// Dateipfad erstellen, d. h. catalog/file.name oder catalog/partition/file
function getPath (fileNode) {
    var prefix = fileNode.getParent() ? fileNode.getParent() + '/' : '';
    return prefix + fileNode.getName();
}

var macro = createMacro(function*() {
    'use strict';

    try {
        var fileTransfer = fileTransferFactory.getInd$File();

        // transferMethod-Optionen sind 'binary' und 'ascii'
        fileTransfer.setTransferOptions({transferMethod: 'ascii'});

        // In dieser Demo wird die erste Datei abgerufen, die in der Liste
        var hostFiles = yield fileTransfer.getHostFileListing();
        var firstHostFile = hostFiles[0];

        if (hostEnvironment === 'CMS') { 
           yield wait.forText('Ready', new Position(1,1), 5000);
        }

        // Download
        // Wenn Ihnen der Pfad der gewünschten Datei bereits bekannt ist, übergeben Sie ihn einfach an getDownloadURL()
        var downloadUrl = fileTransfer.getDownloadURL(getPath(firstHostFile));

        // Dadurch wird der Browserspeicherort geändert. Möglicherweise ergeben sich unterschiedliche Ergebnisse in unterschiedlichen Browsern.
        window.location = downloadUrl;

        // Wenn Sie die Dateiinhalte in eine Variable einlesen möchten, anstatt sie
        // herunterzuladen, können Sie Folgendes verwenden: jQuery
        // var fileContents = yield $.get(downloadUrl);

    } catch (error) {
         yield ui.message(error);
    }
    });

// Makro ausführen
return macro();

var hostEnvironment = 'CMS';  // 'TSO'
 // Dialogfeld des Browsers zur Dateiauswahl programmgesteuert öffnen
function promptForFileToUpload () {
    return new Promise(function (resolve, reject) {
        // Es erfolgt keine Benachrichtigung, wenn der Benutzer das Dialogfeld zur Dateiauswahl schließt, daher nach 30 Sekunden ablehnen
        var timerId = setTimeout(reject.bind(null, 'Timed out waiting for file selection'), 30000);
        var fileSelector = document.createElement('input');
        fileSelector.setAttribute('type', 'file');
        fileSelector.onchange = function (evt) {
            var file = evt.target.files[0];
            clearTimeout(timerId);
            resolve(file);
        };
        fileSelector.click();
    });
}

var macro = createMacro(function*() {
    'use strict';

    try {
        var fileTransfer = fileTransferFactory.getInd$File();

       // transferMethod-Optionen sind 'binary' und 'ascii'
        fileTransfer.setTransferOptions({transferMethod: 'ascii'});

        var localFile = yield promptForFileToUpload();

        // Aktuellen Katalognamen abrufen und ausgewählten Dateinamen an ihn anfügen
        var hostFiles = yield fileTransfer.getHostFileListing();
        var destination = hostFiles[0].getParent() + '/' + localFile.name;

        if (hostEnvironment === 'CMS') {
           yield wait.forText('Ready', new Position(1,1), 5000);
        }

        var result = yield fileTransfer.sendFile(localFile, destination);

    } catch (error) {
        yield ui.message(error);
    }
});

 // Makro ausführen
return macro();