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