Umgebungsvariablen
Die folgende Übersicht zeigt alle in i-effect verwendeten Umgebungsvariablen und erläutert Ihre Verwendung und Bedeutung.
Name | Ebene | Funktion | Wert |
---|---|---|---|
IEFFECT_<Befehl>_RESULT | *JOB | Für die im folgenden aufgelisteten Befehl wird am Ende eines Funktionsaufrufs eine Umgebungsvariable gesetzt, aus der abgeleitet werden kann, ob der Aufruf erfolgreich war, oder nicht. *OK Der Aufruf war erfolgreich *ERROR Beim Aufruf ist ein Fehler aufgetreten ADDARCHIVE, ARCPDF, CRTARCHIVE, CVTARCHIVE, DLTARCHIVE, ENCRYPT, DECRYPT, CRTOCSP, EXTARCHIVE, EXTFILEPDF, RCVEMAIL, RCVFTP, RUNMAP, RUNREPORT, SIGNQDATA, SIGNXML, SNDAS2, SNDEMAIL, SNDFTP, SNDHTTP, STRGZIP, STROFTP2, STRPGP, STRSOACLT, VERIFYPDF, MRGFILEPDF, OFTP2CRTX | *OK *ERROR |
IEFFECT_AUTOSTARTSBS | *SYS | Legt fest, ob ein nicht laufendes i-effect Subsystem automatisch gestartet wird. *YES Das Subsystem wird gestartet, wenn es noch nicht aktiv ist. *NO Das Subsystem wird nicht automatisch gestartet. Diese Umgebungsvariable kann verwendet werden um zu verhindern, dass Subsysteme starten an der Konfiguration Änderungen vorgenommen werden. | *YES *NO |
IEFFECT_COMMAND | *JOB | Eine interne Umgebungsvariable von i-effect. Sie enthält den hex-codierten Namen des zuletzt verwendeten i-effect Befehls mit all seinen Parametern. IEFFECT_COMMAND1 wird zusätzlich verwendet, wenn die Länge des Befehls und seiner Parameter die Länge von 1024 Bytes überschreitet. | |
IEFFECT_COMMANDNAME | *JOB | Der Name des zuletzt verwendeten i-effect Befehls. | RUNMAP |
IEFFECT_CORRECT_XML_CLRF | *JOB | Erstes auftretendes CRLF in Datei entfernen. Hotfix für RPLSTRIFS um diesen Sonderfall behandeln zu können:
CODE
| *YES |
IEFFECT_EMAIL_MSGTEXT | *JOB | Kann einen Text enthalten, der von einem SNDEMAIL automatisch als Nachrichtentext verwendet wird. | ‘Text’ |
IEFFECT_ERRORWORKFLOW_SERVERENTRY | *JOB | Startet automatisch den in der Umgebungsvariablen angegeben ServerTask, wenn eine Sitzung auf Abbruch geht. | 1510 |
IEFFECT_FTP_DELAY | *JOB | Anzahl an Sekunden, die zwischen einzelnen FTP Übertragungen gewartet werden soll. | 60 |
IEFFECT_FTP_REPLACE | *JOB | Eine bestehende Datei wird in einer FTP Übertragung nicht auf dem Zielsystem ersetzt, wenn diese Variable gesetzt ist | *NONE |
IEFFECT_VxRyMz_FTP_SINGLE_RECEIVE | *JOB | Vor jeder Übertragung wird die Verbindung erneut aufgebaut, wenn diese Variable gesetzt ist | *YES |
IEFFECT_MESSAGEKEY | *JOB | Interne Variable. Enthält den Nachrichtenschlüssel der ersten i-effect Nachricht nach einem Sitzungsstart | |
IEFFECT_PARAMETERSETS_SERVERENTRY | *JOB | Die Umgebungsvariable IEFFECT_PARAMETERSETS_SERVERENTRY legt für den Dialog WRKEFSPLF und für die WEBCONTROL Spool Verarbeitungen die Standardvorgaben fest. Hierzu werden in einem I-EFFECT Server Task die entsprechenden Standardvorgaben für die einzelnen Verarbeitungen definiert. In der Umgebungsvariable wird dazu die Nummer des entsprechenden Servertasks(*SINGLE/*SPOOL) als Wert eingetragen. So können durch einen Eintrag für *CONVERT/*SPOOL/*PDF im Servertask die Standardwerte für die PDF Generierung aus Spools festgelegt werden.
CODE
| 9999 |
IEFFECT_PGM | *JOB | Interne Variable. Name des zuletzt gestarteten i-effect Prozesses | SNDEMAIL |
IEFFECT_RGZPFM_LOGFILES | *JOB | Überschreibt den Parameter RGZPFM() in STREFREORG und kann damit die Reorganisation von Dateien im Reorg forcieren, auch wenn der Parameter bei Start der Reorganisation nicht eingeschaltet war. | *YES |
IEFFECT_RPLSTRIFS_USEBUFFER | *JOB | Forciert RPLSTRIFS dazu einen größeren Puffer für die Verarbeitung zu verwenden. Damit wird die Verarbeitungsgeschwindigkeit bei großen Datenmengen beschleunigt. | *YES |
IEFFECT_RPLSTRIFS_USESEPCHAR | *JOB | Weist RPLSTRIFS an, einen anderen Satztrenner als das Zeilenvorschubzeichen zu verwenden | | |
IEFFECT_RUNNINGVERSION | *JOB | Interne Variable. Enthält das i-effect Release des zuletzt aufgerufenen i-effect Befehls | V3R1M0 |
IEFFECT_SAVSESNR | *JOB | (Veraltet). Ersetzt durch IEFFECT_SESSION. | 4354 |
IEFFECT_SERVER_CHECKINUSE | *JOB | Legt fest, ob überprüft werden soll, ob eine Datei im IFS die in einem Servertask verarbeitet werden soll, aktuell verwendet wird. Der Standardwert ist *YES | *YES *NO |
IEFFECT_SERVER_ENVVAR | *JOB | (Veraltet). Ersetzt durch %GETENVVAR:<name>% | |
IEFFECT_SERVER_ERROR | *JOB | Diese Umgebungsvariable kann im i-effect Server verwendet werden um bei Auftreten eines Fehlers die Verarbeitung fortsetzen zu lassen. Ist diese Variable auf *IGNORE gesetzt, so wird die definierte Fehlerverarbeitung zwar ausgeführt, aber anschließend wird die Verarbeitung fortgesetzt. Mit *IGNORE_WITH_ERROR_WORKFLOW wird auch die Fehlerbehandlung im *ERROR Workflow übersprungen. | *IGNORE *IGNORE_WITH_ERROR_WORKFLOW |
IEFFECT_SERVER_WORKFLOW | *JOB | Diese Umgebungsvariable kann im i-effect Server verwendet werden um alle folgenden Workflowverarbeitungen zu überspringen. Ist diese Variable auf *IGNORE gesetzt, so werden die nachkommenden Workflow Verarbeitungen nicht ausgeführt. Um nach einem Verarbeitungsschritt, das Standardverhalten wiederherzustellen, muss die Umgebungsvariable wieder gelöscht werden. | |
IEFFECT_SERVER_WORKFLOW_LOG | *JOB | Diese Umgebungsvariable kann verwendet werden um in einem EMAIL/SEND Workflow mit MSGTEXT(%STATUS%) im Fehlerfall alle Logdateien aus dem "/home/ieffect/internal” Verzeichnis der betroffenen Sitzung automatisch anzuhängen. | *ADD |
IEFFECT_SESSION | *JOB | Sitzungsnummer der zuletzt gestarteten Sitzung. | 4758 |
IEFFECT_SESSIONREADJOBLOG | *JOB | Legt fest, ob aus dem Jobprotokoll auch Nachrichten ausgelesen werden, die nicht von i-effect geschrieben wurden. Normalerweise werden solche Nachrichten nur im Fehlerfall mit in das i-effect Logbuch aufgenommen. | *YES |
IEFFECT_VxRyMz_LNGCATALOG | *SYS | Name des Katalogs mit den Sprachobjekten der angegebenen i-effect Version | IBMIDB |
IEFFECT_VxRyMz_LNGDEVICE | *SYS | Name der IASP-Einheit oder *SYSBAS mit den Sprachobjekten der angegebenen i-effect Version | *SYSBAS |
IEFFECT_VxRyMz_LNGSCHEMA | *SYS | Name des Schemas mit den Sprachobjekten der angegebenen i-effect Version | IEF31024 |
IEFFECT_VxRyMz_LNGSYSBASLIB | *SYS | Name des Schemas mit den Sysbas-Sprachobjekten der angegebenen i-effect Version | IEF31024S |
IEFFECT_VxRyMz_PRIMARY_LANGUAGE | *SYS | Die i-effect Primärsprache der angegebenen i-effect Version | 2929 |
IEFFECT_VxRyMz_SECONDARY_LANGUAGE | *SYS | Die i-effect Sekundärsprache der angegebenen i-effect Version | 2924 |
IEFFECT_VxRyMz_APPCATALOG | *SYS | Name des Katalogs mit den Anwendungsobjekten der angegebenen i-effect Version | IBMIDB |
IEFFECT_VxRyMz_APPDEVICE | *SYS | Name der IASP-Einheit oder *SYSBAS mit den Anwendungsobjekten der angegebenen i-effect Version | *SYSBAS |
IEFFECT_VxRyMz_APPSCHEMA | *SYS | Name des Schemas mit den Anwendungsobjekten der angegebenen i-effect Version | IEFFECT |
IEFFECT_VxRyMz_DBCATALOG | *SYS | Name des Katalogs mit den Datenbankobjekten der angegebenen i-effect Version | IBMIDB |
IEFFECT_VxRyMz_DBDEVICE | *SYS | Name der IASP-Einheit oder *SYSBAS mit den Datenbankobjekten der angegebenen i-effect Version | *SYSBAS |
IEFFECT_VxRyMz_DBSCHEMA | *SYS | Name des Schemas mit den Datenbankobjekten der angegebenen i-effect Version | IEFFECTDB |
IEFFECT_VxRyMz_DEBUG | *SYS | Mit setzen dieser Umgebungsvariablen werden zusätzliche Informationen in das Logbuch ausgegeben.
| *NONE |
IEFFECT_VxRyMz_IFS_DEVICE | *SYS | Name der IASP-Einheit oder *SYSBAS mit den IFS Objekten der angegebenen i-effect Version | *SYSBAS |
IEFFECT_VxRyMz_IFS_PATH | *SYS | Name des IFS Programmverzeichnis der angegebenen i-effect Version | /i-effect/v3r1m0 |
IEFFECT_VxRyMz_JAVA_HOME | *SYS | Pfad zur JAVA Runtime, die in der angegebenen i-effect Version verwendet wird | /QOpenSys/QIBM/ProdData/JavaVM/jdk80/64bit /QOpenSys/QIBM/ProdData/JavaVM/jdk80/32bit |
IEFFECT_VxRyMz_JVMCLIENT | *SYS | Interne Variable. | |
IEFFECT_VxRyMz_PRVCATALOG | *SYS | Interne Variable. Wird während eines i-effect Upgrades gesetzt um den Namen des Katalogs der vorherigen Version festzuhalten | IBMIDB |
IEFFECT_VxRyMz_PRVDEVICE | *SYS | Interne Variable. Wird während eines i-effect Upgrades gesetzt um den Namen der Einheit der vorherigen Version festzuhalten | *SYSBAS |
IEFFECT_VxRyMz_PRVSCHEMA | *SYS | Interne Variable. Wird während eines i-effect Upgrades gesetzt um den Namen des Schemas der vorherigen Version festzuhalten | IEFFECT27 |
IEFFECT_VxRyMz_PRVVERSION | *SYS | Interne Variable. Wird während eines i-effect Upgrades gesetzt um die Versionsnummer der vorherigen Version festzuhalten | V2R7M0 |
IEFFECT_VxRyMz_REORG_DELETE_WITH_ROWCOUNT | *SYS | Bestimmt in einem STREFREORG die Maximalanzahl an Sätzen, die in einem Aufruf gelöscht werden. Mit Angabe von *NONE werden alle Sätze gelöscht. Das ist der Default. | 10000 |
IEFFECT_VxRyMz_SKIP_CLASSPATH | *SYS | Mit setzen dieser Umgebungsvariablen wird das (erneute) Erstellen des Klassenpfades umgangen. Das kann regelmäßig dann gesetzt werden, wenn keine Änderungen am Klassenpfad erwartet werden und die Aufrufstart der JVM beschleunigt werden muss. | *YES |
IEFFECT_VxRyMz_SYSBASLIB | *SYS | Name des Schemas mit den Sysbas-Objekten der angegebenen i-effect Version | IEFFECTSYS |
IEFFECT_VxRyMz_USER_HOME | *SYS | Name des Benutzerverzeichnisses der angegebenen i-effect Version | /home/ieffect |
IEFFECT_VxRyMz_WEBCONTORL_LINK | *SYS | Die URL zum Aufruf der Weboberfläche von i-effect | https://192.168.1.100’ |
IEFFECT_VxRyMz_WEBCONTROL_PORT | *SYS | Der von der Weboberfläche von i-effect verwendete Port. | 443 |
IEFFECT_VxRyMz_WEBCONTROL_FPMPORT | *SYS | Der von der Weboberfläche von i-effect verwendete FPM-Port (FastCGI Process Manager) | 9000 |