PREP_PROCESS_FILENAME

Verwenden Sie die Script-Funktion PREP_PROCESS_FILENAME, um eine Liste von Dateien abzurufen, die in einem bestimmten Computerverzeichnis 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 Login-Benutzer im Login-Objekt 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 angegebenund 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 werden
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 sind.
  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:

seealso

Script-Elemente für Datensequenzen