PREP_PROCESS_FILENAME

Verwenden Sie die Script-Funktion PREP_PROCESS_FILENAME, um eine Liste von Dateien abzurufen, die in einem bestimmten Verzeichnis verfügbar sind. Mit dem Script können Sie nach bestimmten Dateinamen filtern und angeben, ob Unterverzeichnisse und Ordner enthalten sein sollen. Auf dem Host ruft der Agent die Dateien ab. Die Script-Funktion gibt einen Verweis auf eine Datensequenz zurück, die Sie zur weiteren Verarbeitung verwenden können, indem Sie den Rückgabewert der Script-Anweisung :PROCESS zuweisen. Verwenden Sie die Script-Funktion GET_PROCESS_LINE, um auf jede Zeile in der Datensequenz zuzugreifen.

Wichtig! Agenten für Anwendungen (Oracle-Anwendungen, PeopleSoft und SAP) unterstützen PREP_PROCESS_FILENAME nicht.

Hinweise:

• Die Script-Funktion bewirkt, dass alle offenen Transaktionen des Scripts in die AE-Datenbank geschrieben werden. Weitere Informationen finden Sie unter Script-Verarbeitung.
• Der Script-Variablen, die die Datensequenz-Referenz enthält, kann kein neuer Wert zugewiesen werden. Verwenden Sie :CLOSE_PROCESS, um die vorhandene Datensequenz zu verwerfen und einen neuen Wert zuzuweisen.
• Es gibt keine Fehlermeldung, wenn die Datensequenz nicht den von Ihnen festgelegten Inhalt enthält. Die Script-Anweisung :PROCESS verarbeitet die Datensequenz in diesem Fall nicht.

Syntax

PREP_PROCESS_FILENAME (Host, Dateiname, [Platzhalter], [Unterordner], [Filter] [,"COL=Definition1[, Definition2]"] [,"UC_LOGIN=Login-Objekt"])

Parameter

• PREP_PROCESS_FILENAME
  Ruft eine Liste von Dateinamen ab.

• Host
  Name des Agenten auf dem Computer, auf dem die Dateien abgelegt sind
  Format: Script-Literal oder Script-Variable

• Dateiname
  Pfad und Dateiname, nach denen gesucht wird
  Format: Script-Literal oder Script-Variable
  Hinweise:

  • Verwenden Sie das Platzhalterzeichen *, das für eine beliebige Anzahl von Zeichen steht, oder ? für ein einzelnes Zeichen im Dateinamen.
  • Verwenden Sie keine Platzhalterzeichen im Pfad.
  • Die Groß-/Kleinschreibung wird durch den Parameter Wildcards bestimmt.
    

• Wildcards
  (Optional) Gibt an, ob der Dateiname mit Platzhalterzeichen angegeben wird
  Format: Script-Literal oder Script-Variable
  Zulässige Werte:

  • Y (Standard)
    Dateiname enthält Platzhalterzeichen, Groß-/Kleinschreibung nicht beachten
  • N
    Dateiname-Name enthält keine Platzhalterzeichen, Unterscheidung zwischen Groß-und Kleinschreibung
    

• Unterordner
  (Optional) Legt fest, ob Unterordner und Unterverzeichnisse in die Suche einbezogen werden
  Format: Script-Literal oder Script-Variable
  Zulässige Werte:

  • Y
    Unterordner und Unterverzeichnisse sind eingeschlossen
  • N (Standard)
    Unterordner und Unterverzeichnisse sind ausgeschlossen

• Filter
  (Optional) Zusätzlicher Filter für Dateinamen in Datensequenzen
  Format: Script-Literal oder Script-Variable
  Standardwert: *
  Hinweise:

  • Der Filter unterscheidet nicht zwischen Groß-und Kleinschreibung.
  • Verwenden Sie das Platzhalterzeichen *, das für eine beliebige Anzahl von Zeichen steht, oder ? für ein einzelnes Zeichen.

• COL
  Verwenden Sie das folgende Format COL=Definition1[, Definition2]. Weitere Informationen finden Sie unter Spalten definieren.

• Login-Objekt
  (Optional) Name eines Login-Objekts
  Der Anmeldebenutzer im Anmeldeobjekt ist für den Zugriff auf das Dateisystem, das gescannt werden soll, geprüft.
  Format: Script-Literal oder Script-Variable
  Wichtig!

  • Wenn Sie kein Login-Objekt angeben, muss der Benutzer über folgende Rechte verfügen: Dateiübertragung: Start ohne Login-Objekt angegeben und FT_ANONYMOUS=Y muss gesetzt werden. Weitere Informationen finden Sie unter Berechtigungen Automation Enginegewähren und UC_HOSTCHAR_DEFAULT - Host-Charakteristika
  • Schließen Sie die vollständige Wortfolge UC_LOGIN=Login-Objekt in Anführungszeichen ein.
  • (z/OS) UserIDs ohne Kennwort (z. B. PROTECTED-UserIDs im Login-Objekt) können seit v12.1 nicht mehr verwendet werden, da die Anmeldesicherheit verbessert und die Passwortanforderungen geändert wurden. Siehe Login (LOGIN).

Hinweis: Fügen Sie Kommas zwischen den Parametern ein, auch wenn Sie Parameter auslassen. Setzen Sie nach dem letzten Parameter, den Sie angeben, kein Komma.

Spalten definieren

Um die Datensequenz Zeilen in Spalten aufzuteilen, geben Sie den Parameter für die Spaltentrennung folgendermaßen an:

COL=Definition1[, Definition2]

Wobei

• COL
  
  Schlüsselwort für Spaltentrennung

• Definition1
  
  Definiert, ob die Datensequenzzeilen in Spalten unterteilt sind
  Format: Script-Literal oder Script-Variable
  Zulässige Werte:

  • NONE
    Zeilen werden nicht in Spalten aufgeteilt
  • LENGTH
    Legt eine vordefinierte Spaltengröße fest
    Hinweis: Verwenden Sie LENGTH_TAB in Definition2, um die Größe anzugeben.
  • DELIMITER
    Trennt Spalten mit einem Trennzeichen
    Hinweis: Verwenden Sie DELIMITER in Definition2, um das Trennzeichen anzugeben.

• Definition2
  (Optional) Definiert Spaltengrößen und Namen oder das Trennzeichen
  Hinweis: Wenn Sie Definition2 angeben, müssen Sie Definition1 angeben.
  Format: Script-Literal oder Script-Variable
  Zulässige Werte:

  • LENGTH_TAB
    Gibt die Spaltengrößen und Spaltennamen an
    Beispiel:"COL=LENGTH,LENGTH_TAB='3=drive,100=file name'"
    Hinweise:
    • Trennen Sie einzelne Spaltendefinitionen durch Kommas.
    • Geben Sie bis zu 22 Spalten mit einer Gesamtzahl von 2.048 Byte an.
    • Geben Sie die Spaltengröße als Anzahl der Zeichen an. Die maximale Größe ist 255 Zeichen.
    • (Optional) Geben Sie Spaltennamen an. Namen können bis zu 32 Zeichen lang sein.
    • Verwenden Sie Anführungszeichen vor der ersten und nach der letzten Spaltendefinition. Verwenden Sie doppelte Anführungszeichen, wenn Sie einfache Anführungszeichen für Script-Literale in Definition2 verwenden, oder umgekehrt.
  • DELIMITER
    Definiert ein Trennzeichen, das Spalten trennt.
    Die Zeilen der Datensequenz werden als Spalten zurückgegeben, die vor, zwischen oder nach dem Trennzeichen-String platziert werden.
    Beispiel:
    "COL=DELIMITER,DELIMITER=*'*"
    'COL=DELIMITER,DELIMITER=@"@'
    Standardwert: ;
    Hinweise:
    • Sie können beliebige Zeichen als Trennzeichen verwenden.
    • Das Trennzeichen kann ein String mit bis zu 10 Zeichen sein.
    • Schließen Sie das Trennzeichen mit einem beliebigen Zeichen ein: *Trennzeichen*. Die umschließenden Zeichen werden in der Ausgabe nicht angezeigt.
    • Eine Spalte wird nicht getrennt, wenn eine Zeile kein Trennzeichen enthält.
    • Wenn Sie einfache Anführungszeichen als Trennzeichen verwenden, müssen Sie Definition2 in doppelte Anführungszeichen einschließen und umgekehrt.

Rückgabewerte

Die Script-Funktion ruft einen Verweis auf eine Datensequenz ab, die eine Liste der abgerufenen Dateinamen enthält. Die folgenden Rückgabewerte zeigen Fehler an:

• 20240
  Fehlende Login-Information
• 20303
  Automation Engine Autorisierungsfehler
• 20349
  Agent ist nicht verfügbar
• 20510
  Es wurde ein CP oder WP anstelle eines Agenten angegeben
• 20514
  Ungültige Angabe bei Verwendung von Platzhalterzeichen
  

Beispiele

Das folgende Beispiel listet alle HTML-Dokumente aus der WebHelp der Automation Engine-Dokumentation auf. Die Verwendung von Platzhalterzeichen ist ausdrücklich angegeben. Die resultierende Dateiliste wird im Aktivierungsreport ausgegeben.

:SET &HND# = PREP_PROCESS_FILENAME("WIN01","c:\AUTOMIC\documentation\webhelp\german\uc*.htm","Y",,,,"UC_LOGIN=WIN_LOGIN")
:PROCESS &HND#
:   SET &LINE# = GET_PROCESS_LINE(&HND#)
:   PRINT &LINE#
:ENDPROCESS

Das folgende Beispiel erstellt eine Liste aller Stylesheets, die mit der Automation Engine-Dokumentation ausgeliefert werden. Alle Unterordner des Dokumentationsverzeichnisses werden in die Suche einbezogen. Das Ergebnis enthält keine Laufwerksangabe und wird in das Aktivierungslog geschrieben.

:SET &HND# = PREP_PROCESS_FILENAME("WIN01", "\AUTOMIC\documentation\uc*.css","Y","Y",)
:PROCESS &HND#
:   SET &LINE# = GET_PROCESS_LINE(&HND#)
:   PRINT &LINE#
:ENDPROCESS

Das folgende Beispiel erstellt eine Liste aller AE-Programme. Die einzelnen Zeilen werden in Spalten aufgeteilt, wobei die Spalten durch umgekehrte Schrägstriche voneinander getrennt sind. Das Script ruft die fünfte Spalte in der Datensequenz ab, die den Dateinamen des Programms enthält, und schreibt die Ergebnisse in den Aktivierungsreport.

:SET &HND# = PREP_PROCESS_FILENAME("WIN01","c:\AUTOMIC\server\bin\*.exe",,,,"COL=DELIMITER,DELIMITER=*\*")
:PROCESS &HND
: SET &LINE# = GET_PROCESS_LINE(&HND#,5)
: PRINT &LINE#
:ENDPROCESS

Im folgenden Beispiel werden die gleichen Dateien abgerufen, jedoch schließt ein Filter alle Dateien außer denen aus, die den String "Server" im Dateinamen enthalten.

:SET &HND# = PREP_PROCESS_FILENAME("WIN01","c:\AUTOMIC\server\bin\*.exe",,,"*server*","COL=DELIMITER,DELIMITER=*\*")
:PROCESS &HND#
: SET &LINE# = GET_PROCESS_LINE(&HND#,5)
: PRINT &LINE#
:ENDPROCESS

Siehe auch: