RPLSTRIFS, Zeichenkette in Eingabedatei ersetzen

Verwendung

Mit dem Befehl RPLSTRIFS kann eine Zeichenkette in der Eingabedatei durch einen anderen Wert ersetzt werden.

Parameter und Ihre Bedeutung

Der Befehl hat folgende Parameter

Parameter	Element	Wert	Beschreibung
FRMPATH			Name der Eingabepfad im IFS Dateisystem. Sollte der Befehl im i-effect SERVER IFS Servereintrag als *USERDEFINED Verarbeitungschritt definiert werden, kann die %IFSPATH% Servervariable verwendet werden.
FRMIFSFILE			Name der Eingabedatei im IFS Dateisystem ohne Pfad. Sollte der Befehl im i-effect SERVER IFS Servereintrag als *USERDEFINED Verarbeitungschritt definiert werden, kann die %IFSFILE% Servervariable verwendet werden.
FRMCCSID			Die CCSID der Eingabedatei. Default ist 1252.
CASE	*YES		Groß- und Kleinschreibung wird beachtet
	*NO		Groß- und Kleinschreibung wird nicht beachtet
REPLACE			Hier wird festgelegt welche Suchmuster mit welchem Wert in der Eingabedatei ersetzt werden. Es können hier bis zu 50 Ersetzungsvorgaben definiert werden.
	Element 1		Dieses Element definiert ein Suchmuster, nach dem gesucht wird.
		HEXSuchmuster	Mit Angabe der Zeichenfolge HEX vor dem eigentlichen Suchmuster kann die zu suchende Zeichenfolge in hexadezimaler Schreibweise angegeben werden. Um also ein ';' Zeichen am Ende einer Zeile ( Hexadezimalwert x'540d25') durch einen Zeilenvorschub zu ersetzen (Hexadezimal x'0d25') kann folgende Parameterdefinition verwendet werden: `REPLACE((HEX5E0D25 HEX0D25))` Um einen Zeilenvorschub zu entfernen kann folgende Parameterdefinition verwendet werden: `Beispiel: REPLACE((HEX0D25))`
	Element 2		Dieses Element definiert die Ersatzzeichenkette, mit der jeder gefundene Zeichenkettenwert des Elements 1 ersetzt wird.
		HEXZeichenkette	Mit Angabe der Zeichenfolge HEX vor der eigentlichen Ersetzungszeichenkette kann die Ersetzung in Hexadezimalform angegeben werden. `REPLACE((HEX5E0D25 HEX0D25))`
		*CRLF	Die gefundene Zeichenkette wird mit einem Zeilenvorschub (CRLF) ersetzt. `REPLACE((HEX5E0D25 *CRLF))`
		*ADDCRLF	Der gefundenen Zeichenkette wird ein Zeilenvorschub (CRLF) hinzugefügt. `REPLACE((HEX5E0D25 *ADDCRLF))`
USESEPCHAR			Dieser Parameter wird nicht mehr verwendet und entfällt in einer zukünftigen Version
USEBUFFER			Dieser Parameter wird nicht mehr verwendet und entfällt in einer zukünftigen Version

Anwendungsbeispiele

Beschreibung	Befehlparameterdefinitionen
Ersetzten der Zeichenfolge ENACOM durch die Zeichenfolge UN in der Eingabedatei	`RPLSTRIFS FRMPATH('/home/ieffect/as/receive') FRMIFSFILE(orders.edi) REPLACE((EANCOM UN))`
Ersetzen des EBCDIC-Zeichen (x'5E') durch die EBCDIC-Zeichen für Zeilenvorschub (x'5E0D25')	`RPLSTRIFS ... REPLACE((HEX5E0D25 HEX0D25))`
Entfernen eines Zeilenvorschubzeichen (x'0D25') aus einer Datei	`RPLSTRIFS ... REPLACE((HEX0D25))`