Toolmaker Produkt-Dokumentation

RPGWX - Befehle

Inhaltsübersicht



Zur weiteren Administration von RPGWX stehen nachstehende IBM i-Befehle zur Verfügung. Bitte beachten Sie, dass vor dem Befehl die Umgebung mit ADDLIBLE DIRWEB vorbereitet werden muss.

STRDIRWEB RPGWX-Server starten

RPGWX wird mit dem Befehl STRDIRWEB gestartet.


War der Start erfolgreich erscheint folgende Hinweismeldung:

0191 – Meldung DIRWEB gestartet

Hinweis: Mit diesem Befehl wird automatisch der E-Mail Dienst mitgestartet.

ENDDIRWEB - RPGWX-Server

RPGWX wird mit dem Befehl ENDDIRWEB beendet.

0192 – Meldung DIRWEB beendet

CFGDIRWEB RPGWX konfigurieren

Die aktuellen Parameter der RPGWX-Konfiguration werden aus dem Datenbereich DWDTAARA ausgelesen und können geändert werden.

0123 Konfiguration CFGDIRWEB

# DWCFGWEB.BILD.SINSTANCEInstanz

Eingabe Name der HTTP-Server Instanz (max. 10 Zeichen, ohne Leerzeichen). Diese wird auch IBM-Server Instanz genannt.

# DWCFGWEB.BILD.SPORTPort

Eingabe Portnummer der Serverinstanz. Der HTTP-Server wird mit dieser Portnummer angesprochen. Für HTTP ist dies der Port 80, für HTTPS 443. Andere häufig genutzte Ports sind 8008 und 8080.

# DWCFGWEB.BILD.SSERVERServername

Eingabe Servername (max. 50 Zeichen, ohne Leerzeichen).

Keine Änderung

Bei Drücken der Eingabetaste wird der aktuelle, in dem Datenbereich DWDTAARA auf Stelle 721 gespeicherte Server beendet.

Instanz Änderung

Ändert sich der Name der Instanz, so wird die Instanz in der Datei QUSRSYS/QATMHINSTC unter der Teildatei mit dem Instanznamen registriert. Diese beinhaltet den Pfad ins IFS, in der die Konfigurationsdaten dieser Instanz gespeichert werden. Als Basis dient eine Kopie der DIRWEB-Instanz. In diesen Konfigurationsdaten sind u.a. Port- und Servername zu finden.

Port-/Servernameänderung :

Werden nur Port und/oder Servername geändert, so werden diese in der aktuellen Konfigurationsdatei gespeichert und der Server am Ende mit den neuen Werten gestartet.

Beispiel einiger relevanter Zeilen der Konfigurationsdatei \www\dirweb\conf\httpd.conf:

Listen *:80 Port

DocumentRoot /www/dirweb/htdocs Instanz

ServerName dirweb.toolmaker.de:80 Servername:Port

Die neue Instanz wird in die DWDTAARA an die Stelle 721 geschrieben.

Zuletzt wird mit dem Startbefehls für den HTTP-Server STRTCPSVR der Name der Serverinstanz aus der DWDTAARA geholt und mit den Daten aus der Konfigurationsdatei gestartet.

STRWEBEML E-Mail-Dienst starten

Mit dem Befehl STRWEBEML wird der E-Mail-Dienst gestartet.

0212 – Befehl STRWEBEML E-Mail-Dienst gestartet

ENDWEBEML E-Mail-Dienst beenden

Mit dem Befehl ENDWEBEML wird der E-Mail-Dienst beendet.

CVTIMG Image konvertieren

Mit dem Befehl CVTIMG wird eine Grafikdatei (JPG, GIF, PNG) in ein neues Format zu konvertieren. Dabei kann nicht nur ein neues Dateiformat (JPG, GIF, PNG) angegeben werden, sondern auch die Farbpalette, Rotation, Auflösung und Größe der neuen Grafik angegeben werden.

0209 - Befehl CVTIMG

# *CMD.CVTIMG.OBJQuelldatei

Eingabe der Quelldatei die als Vorlage zur Konvertierung verwendet werden soll.

# *CMD.CVTIMG.DELETEQuelldatei löschen

Die Quelldatei kann nach der Konvertierung automatisch gelöscht werden.

Gültige Werte sind:

*NO    Quelldatei wird nach der Konvertierung gelöscht

*YES  Quelldatei wird nach der Konvertierung nicht gelöscht

# *CMD.CVTIMG.TGTOBJZieldatei

Eingabe der Zieldatei in die die Konvertierung erfolgen soll.

# *CMD.CVTIMG.REPLACEDatei überschreiben

Ist die Zieldatei bereits vorhanden, so kann diese überschrieben werden.

Gültige Werte sind:

*NO     Zieldatei wird nicht überschreiben falls diese bereits vorhanden ist

*YES   Zieldatei wird überschreiben falls diese bereits vorhanden

# *CMD.CVTIMG.SIZEXBreite in Pixel

Eingabe der Grafikbreite in Pixel.

Gültige Werte sind:

*SAME    Pixelwert der Quelldatei wird beibehalten

5-99999  Gültige Pixelwerte für die Grafikbreite

# *CMD.CVTIMG.SIZEYHöhe in Pixel

Eingabe der Grafikhöhe in Pixel.

Gültige Werte sind:

*SAME    Pixelwert der Quelldatei wird beibehalten

5-99999  Gültige Pixelwerte für die Grafikhöhe

# *CMD.CVTIMG.ROTATERotation

Eingabe der Rotation für die zu neu erstellende Grafik.

Gültige Werte sind:

*SAME   Rotationswert der Quelldatei wird beibehalten

0 Rotationswert der Quelldatei wird beibehalten

90 Rotationswert der Quelldatei um 90 Grad

180 Rotationswert der Quelldatei um 180 Grad

270 Rotationswert der Quelldatei um 270 Grad

# *CMD.CVTIMG.COLORSPACEFarbpalette

Auswahl einer Farbpalette für die zu erstellende Grafik. Standardwert: *RGB.

Gültige Werte sind: *RGB, *CMYK, *GRAY,*CMY, *SRGB, *HSB, *HWB, *LAB, *LOG, *OHTA

CVTPDF PDF-Datei konvertieren

Mit dem Befehl CVTPDF wird eine PDF-Datei in eine andere Pixel-Grafik konvertiert. Dabei werden verschiedene Grafikformate (Treiber), Farbpaletten und Auflösungen unterstützt. Weiterhin kann der Seitenbereich eingegrenzt werden.


0208 - Befehl CVTPDF


# *CMD.CVTPDF.OBJPDF Datei

Eingabe der PDF-Datei die konvertiert werden soll.

# *CMD.CVTPDF.DELETEPDF-Datei löschen

Die PDF-Datei kann nach der Konvertierung automatisch gelöscht werden.

# *CMD.CVTPDF.TGTOBJZieldatei

Eingabe der Zieldatei in die die PDF-Konvertierung erfolgen soll.

# *CMD.CVTPDF.REPLACEDatei überschreiben

Ist die Zieldatei bereits vorhanden, so kann diese überschrieben werden.

# *CMD.CVTPDF.DRIVERTreiber

Auswahl eines Treibers, der für die PDF-Konvertierung verwendet werden soll. Standardwert: *JPG.

Gültige Werte sind: *JPG, *JPGGRAY, *BMPMONO, *BMP1, *BMP8, *BMP16, *BMP256, *BMP16M, *BMP32B, *PCXMONO, *PCXGRAY, *PCX16, *PCX256, *PCX24B, *PCXCMYK, *PNG, *PNG24, *PNG8, *PNG4, *PNGGRAY, *PSDCMYK, *PSDRGB, *TIF, *TIF12RGB, *TIF24RGB, *TIF32CMYK, *TIFGRAY, *TIFG2, *TIFG3, *TIFG4, *TIFLZW, *TIFPACK

# *CMD.CVTPDF.RESXX-Auflösung

Eingabe des Wertes für die X-Achse der Grafik.

# *CMD.CVTPDF.RESYY-Auflösung

Eingabe des Wertes für die X-Achse der Grafik.

# *CMD.CVTPDF.PAGERANGESeitenbereich

Festlegung der Seitenbereiche für die neue PDF-Grafik.

Seite von

Eingabe der Seitenzahl, ab der die Konvertierung beginnen soll. Standardwert: 1.

Seite bis

Eingabe der Seitenzahl, bis wie weit die Konvertierung erfolgen soll. Standardwert: *LAST.

Gültige Werte sind:

1 – 999999  Gültiger Zahlenbereich

*LAST Konvertierung bis zur letzten Seite

*END Konvertierung bis zum Ende

MRGPDF PDF-Dateien zusammenfügen

Mit dem Befehl MRGPDF werden eine oder mehrere PDF-Dateien mit einer anderen PDF-Datei zusammengefügt.


0232 – Befehl MRGPDF


# *CMD.MRGPDF.PDFOBJBestehende PDF-Datei

Ein +-Zeichen eröffnet weitere Eingabefelder für eine PDF-Datei.

PDF-Datei

Eingabe der PDF-Datei, die mit einer anderen PDF-Datei zusammengeführt werden soll.

Seitenauswahl

Eingabe einer Seitenauswahl, ab der die PDF-Datei zusammengefügt werden soll.

Gültige Werte sind:

Seite Eingabe einer Seitenzahl

von–bis Eingabe eines Seitenbereiches von-bis

Nach Zusammenfügen löschen

Dieser Parameter steuert, ob eine PDF-Datei nach dem Zusammenfügen gelöscht werden soll.

Gültige Werte sind:

*YES PDF-Datei wird nach dem Zusammenfügen gelöscht

*NO Defaultwert. PDF-Datei wird nicht gelöscht.

# *CMD.MRGPDF.NEWPDFNeue PDF-Datei

Eingabe der PDF-Datei die zur Ausgabe erstellt oder ersetzt werden soll.

# *CMD.MRGPDF.REPLACEBestehende Datei löschen

Ist die angegebene PDF-Datei bereits vorhanden, so wird mit diesem Parameter gesteuert, ob diese ersetzt werden soll.

Gültige Werte sind:

*YES PDF-Datei wird nach dem Zusammenfügen gelöscht

*NO Defaultwert. PDF-Datei wird nicht gelöscht.

PRTPDF PDF-Datei drucken

Mit dem Befehl PRTPDF kann eine PDF-Datei gedruckt werden.


0233 – Befehl PRTPDF Seite 1


# *CMD.PRTPDF.OBJPDF-Datei

Name der zu druckenden PDF-Datei.

# *CMD.PRTPDF.DELETEDatei löschen

Dieser Parameter steuert, ob die PDF-Datei nach dem Druck gelöscht werden soll.

Gültige Werte sind:

*YES PDF-Datei wird nach dem Druck gelöscht

*NO Defaultwert. PDF-Datei wird nicht gelöscht.

# *CMD.PRTPDF.DRIVERTreiber

Auswahl des zu verwendenden Treibers für den Druck. Defaultwert: LJET4.

# *CMD.PRTPDF.PAGERANGESeitenbereich

Eingabe des zu druckenden Seitenbereiches.

Seite von

Seitenzahl, ab der der Druck erfolgen soll.

Seite bis

Seitenzahl, bis zu der der Druck erfolgen soll.

# *CMD.PRTPDF.OUTQAusgabewarteschlange

Eingabe der Ausgabewarteschlange für den Druck.

Bibliothek

Eingabe der Bibliothek für den Druck.

# *CMD.PRTPDF.SPLFNAMEDateiname

Soll der Ausdruck unter einem anderen Namen erfolgen, so kann dieser hier angegeben werden. Eingabe eines Namens von max. 10 Zeichen möglich. Defaultwert: *DFT

# *CMD.PRTPDF.HOLDDruckausgabe anhalten

Der Druckjob kann angehalten werden.

Gültige Werte sind:

*YES Der Druckjob wird angehalten.

*NO Defaultwert. Der Druckjob wird nicht angehalten.

# *CMD.PRTPDF.SAVEDruckausgabe sichern

Der Druckjob kann gesichert werden.

Gültige Werte sind:

*YES Der Druckjob wird gesichert.

*NO Defaultwert. Der Druckjob wird nicht gesichert.

# *CMD.PRTPDF.FORMTYPEFormularart

Eingabe einer Formularart. Defaultwert: *STD.

# *CMD.PRTPDF.USRDTABenutzerdaten

Eingabe von Benutzerdaten. Defaultwert: *STD.

# *CMD.PRTPDF.COPIESKopien

Anzahl der Kopien. Defaultwert: 1.

Gültige Werte sind:

1-255 Gültige Werte für Anzahl der Kopien.

1 Defaultwert.

# *CMD.PRTPDF.OUTPTYAusgabepriorität

Eingabe der Ausgabepriorität. Defaultwert: 1.

Gültige Werte sind:

1-9 Gültige Werte für die Ausgabepriorität.

*JOB Defaultwert. Ausgabepriorität des Jobs.


0262 - Befehl PRTPDF Seite 2


# *CMD.PRTPDF.DRAWERPapierfach 1.Seite

Gibt das Papierfach an, das für die Zuführung von Einzelblättern (angegebenen durch FORMFEED(*AUTOCUT)) für die 1.Seite verwendet wird.

Gültige Werte sind:

1-100 Auswahl des Papierfaches für die Druckausgabe

*STD Standardfach des Druckers wird verwendet

# *CMD.PRTPDF.DRAWER2Papierfach Folgeseite

Gibt das Papierfach an, das für die Zuführung von Einzelblättern (angegebenen durch FORMFEED(*AUTOCUT)) für die Folgeseiten verwendet wird.

Gültige Werte sind:

1-100 Ausgabepriorität. Default:1.

*JOB Wert aus der Jobbeschreibung verwenden.

# *CMD.PRTPDF.DUPLEXBeidseitig drucken

Gibt an, ob die Ausgabe auf eine oder beide Seiten des Papiers gedruckt wird.

Gültige Werte sind:

*NO Druckausgabe erfolgt nicht beidseitig.

*YES Gibt an, ob die Druckausgabe auf eine oder beide Seiten des Papiers erfolgt.

*TUMBLE Die Ausgabe wird beidseitig gedruckt. Der Text aufeinanderfolgender Druckseiten beginnt abwechselnd einmal am oberen und einmal am unteren Blattende. Dieses Verfahren wird in der Regel für Druckausgaben verwendet, die am oberen Rand gebunden werden.

CHGWEBLNG – Sprache ändern

Mit dem Befehl CHGWEBLNG können die Spracheinstellungen von RPGWX auf Seiten der IBM i geändert werden.


0248 – Sprache ändern


Sprache^#^ *CMD.CHGWEBLNG.LNG

Hier können folgende Sprachen ausgewählt werden:

DES Deutsch (Schweiz)

DEU Deutsch

ENG Englisch

FRA Französisch

ITA Italienisch

FRS Französisch (Schweiz)

POL Polnisch

Nach Auswahl der Sprache erscheinen weitere Parameter:


0249 – Sprache ändern Zusatzparameter


Nach Eingabe der Sprache erscheinen zusätzliche Parameter.

Befehle in Bibliothek kopieren^#^ *CMD.CHGWEBLN1.ADD

Hiermit wird gesteuert, ob die wichtigsten RPGWX-Befehle in eine weitere Bibliothek kopiert werden sollen (z.B. QGPL, QUSRSYS). Wird dies genützt, können diese Befehle immer aufgerufen werden, auch wenn die Bibliothek DIRWEB nicht Bestandteil der Bibliotheksliste ist.

Bibliothek^#^ *CMD.CHGWEBLN1.LIB

Wurde im o. g. Parameter *YES ausgewählt, ist hier die entsprechende Bibliothek (QUSRSYS, bzw. QGPL) anzugeben.

ASP-Gruppe^#^ *CMD.CHGWEBLN1.ASP

Wird mit iASP (independent Auxiliary Storage Pools) gearbeitet, ist hier der Name des Pools einzugeben, in dem die Bibliothek DIRWEB gespeichert ist (Standardmäßig IASP33). Gültige Werte sind 1 – 32.

ASP-Einheit^#^ *CMD.CHGWEBLN1.ASPDEV

Eingabe eines Namens für die ASP-Einheit.

*SYSBASSpeicherbereich der Originaleinheit (Systembasis)

SNDSMS – SMS senden

Mit dem Befehl *SNDSMS kann eine SMS (Nachricht) gesendet werden.


0275 – Befehl SNDSMS


# *CMD.SNDSMS.DIALRufnummer

Eingabe der Rufnummer an die die SMS gesendet werden soll.

# *CMD.SNDSMS.MSGNachricht

Eingabe des SMS Textes, der verschickt werden soll.

# *CMD.SNDSMS.POOLSendepool

Auswahl des Sendepools, wenn die Nachricht nicht über den Standardpool versendet werden soll.

# *CMD.SNDSMS.HOLDNachricht anhalten

Nachrichten können gleich versendet oder angehalten werden.

Gültige Werte sind:

*NO    Nachricht wird gleich gesendet

*YES  Nachricht wird angehalten

# *CMD.SNDSMS.PTYPriorität

SMS können mit unterschiedlichen Prioritäten versendet werden. Standardwert: 50.

Gültige Werte sind:

1-99   Nachricht wird mit ausgewählter Priorität versendet. 1=hoch, 99=niedrig.

*STD  Nachricht wird mit der Standardpriorität versendet

# *CMD.SNDSMS.SCHEDULEVersandzeit

Für den Versand der SMS kann eine Versandzeit mit Datum und Uhrzeit festgelegt werden.

Uhrzeit

Eingabe der Uhrzeit wann die SMS versendet werden soll.

Gültige Werte sind:

Zeit Eingabe der Versandzeit im Format HH:MM:SS

*CURRENT Aktuelle Uhrzeit wird zum Versand verwendet

Datum

Eingabe des Datums wann die SMS versendet werden soll.

Gültige Werte sind:

Datum Eingabe des Versanddatums im Format TT.MM.YYYY

*CURRENT Aktuelles Datum wird zum Versand verwendet

# *CMD.SNDSMS.SNDUSRMSGBenutzernachricht senden

Es kann nach dem Senden der SMS Nachricht auch eine Benutzernachricht erstellt und versendet.

Gültige Werte sind:

*NO    Nachricht wird gleich gesendet

*YES  Nachricht wird angehalten

# *CMD.SNDSMS.CCSIDCCSID der Nachricht

Hier wird festgelegt, welche CCSID zur Ausgabe der Nachricht verwendet werden soll.

Gültige Werte sind:

Zahl  Eingabe der zu verwendenden CCSID

*JOB Es wird die CCSID des Jobs verwendet