Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Inhaltsübersicht

Table of Contents
maxLevel2

Es gibt drei Möglichkeiten directmedia aufzurufen bzw. der Übergabe der Dokumentennamen der anzuzeigenden Bild-, Ton- oder Videodateien.

Aufruf von directmedia mittels eines Hotkeys und eines direkt vom IBM i-Bildschirm eingelesenen Dokumentennamens. (=Aktionstyp der Schablone = 2 bzw. Feldliste als Dokumentenname)

Aufruf von directmedia mittels eines Hotkey und eines über ein IBM i-Programm eingelesenen Dokumentennamens. (=Aktionstyp der Schablone = 3 bzw. Dokumentenname von IBM i-Datenbank).

Aufruf von directmedia über einen CALL-Befehl von einem IBM i-Programm heraus. (Ohne Verwendung von Hotkeys und Schablonen).Anstelle der Verwendung von Hotkeys, Schablonen und Felddefinitionen wird directmedia direkt von einem IBM i-Programm mittels eines CALL-Befehles aufgerufen. Das aufzurufende Programm FSTCALL befindet sich in der Bibliothek DIRMEDIA. Die Übergabe des Pfades und des Dokumentennamens sowie der übrigen Einstellungen für die Anzeige des Windows erfolgt über 17 Parameter, wovon der 1. Parameter immer den Pfad und den Dokumentennamen beinhalten muss.

Aufruf von directmedia mit Hotkeys und vom Bildschirm eingelesenen Dokumenten

Zum Aufruf von directmedia mittels eines Hotkeys und eines vom IBM i-Bildschirm direkt eingelesenen Dokumentes sind folgende Schritte notwendig.

Erstellen einer Schablone mit Aktionstyp = 2 bzw. Feldliste als Dokument, wo einerseits der Hotkey andererseits sämtliche Einstellungen für das anzuzeigende Window anzugeben sind. Details siehe Kapitel 4.1 und 5.2. (Erstellen und Ändern von Schablonen)

Erstellen ein oder mehrerer Felddefinitionen, mit Angabe der genauen Positionen und Längen auf Ihrem IBM i-Bildschirm, deren eingelesene Inhalte dann den Namen des anzuzeigenden Dokumentes bilden. Details siehe Kapitel 4.1 und 5.2. (Erstellen und Ändern von Felddefinitionen)

Das Serverprogramm TCPDMSERV muss nicht gestartet sein. Es kommt beim Starten des directmedia am PC zwar ein Hinweis, dass der Server nicht aktiv ist, lokales Arbeiten ist jedoch trotzdem möglich.

Aufruf von directmedia mit Hotkeys und IBM i-Programmen

Zum Aufruf von directmedia mittels eines Hotkeys und eines von einem IBM i-Programm übergegebenen Dokumentennamen sind folgende Schritte notwendig.

Erstellen einer Schablone mit Aktionstyp = 3 bzw. Dokumentenname von IBM i, wo einerseits der Hotkey andererseits sämtliche Einstellungen für das anzuzeigende Window anzugeben sind, sowie auch der Name und die Bibliothek jenes IBM i-Programmes, welches den Dokumentennamen von einer IBM i-Datenbank einliest und an directmedia zurückgibt. Details siehe Kapitel 4.1 und 5.2. (Schablonen)

Erstellen ein oder mehrere Felddefinitionen, mit Angabe der genauen Positionen und Längen auf Ihrem IBM i-Bildschirm, deren eingelesene Feldinhalte dem IBM i-Programm, welches den Dokumentennamen ermittelt, als Eingangsparameter dienen. Diese Feldinhalte können zum Beispiel eine Kundennummer oder Personalnummer sein. Das IBM i-Programm ermittelt auf Grund dieser übergebenen Feldinhalte im Anschluss daran den Namen und Pfad des auf einer Datenbank hinterlegten Dokumentes. Details siehe Kapitel 4.1 und 5.2. (Felddefinitionen)

Erstellen eines IBM i-Programmes, welches als Eingangsparameter die Inhalte der eingelesenen Felder der entsprechenden Schablone erhält und als Übergabeparameter den Pfad und den Dokumentennamen an directmedia zurückgibt.

Eingangsparameterliste für das IBM i-Programm:

Parameterbeschreibung

Parametertyp

Gültige Parameterargumente

Key-String (beinhaltet die eingelesenen Felder vom Bildschirm)

Text 1024

Strings bis Gesamtlänge 1024

Ausgangsparameterliste für das IBM i-Programm:

Parameterbeschreibung

Parametertyp

Gültige Parameterargumente

Dokumentenname

Text 256

Strings bis Gesamtlänge 256

Dokumentenpfad

Text 1024

String bis Gesamtlänge 1024

Hinweis

Das IBM i-Programm kann ein CL-, ein RPG/400- oder auch ein ILE-RPG-Programm sein.

Nachfolgend finden Sie ein Beispielprogramm für ein IBM i-Programm, welches einen Dokumentennamen zurückgibt. (in Bearbeitung)


***************** Datenanfang *****************************************

0008.00 PGM PARM(&KEY &DOCNAM &PATH)

0009.00 /* INPUT PARAMETER: CONTAINS THE CONCATENATED TEMPLATE FIELDS */

0010.00 DCL VAR(&KEY) TYPE(*CHAR) LEN(1024)

0011.00 DCL VAR(&KEY1) TYPE(*CHAR) LEN(8)

0012.00 DCL VAR(&KEY2) TYPE(*CHAR) LEN(8

0013.00 /* OUTPUT PARAMETER: CONTAINS THE DOCUMENT NAME (E.G.: TEST.BMP */

0014.00 DCL VAR(&DOCNAM) TYPE(*CHAR) LEN(256

0015.00 /* OUTPUT PARAMETER: CONTAINS THE PATH NAME OR PATHES LIST */

0016.00 DCL VAR(&PATH) TYPE(*CHAR) LEN(1024

0017.00 CHGDTAARA DTAARA(*LDA (1 1024)) VALUE(&KEY

0018.00 RTVDTAARA DTAARA(*LDA (1 8)) RTNVAR(&KEY1

0019.00 RTVDTAARA DTAARA(*LDA (9 8)) RTNVAR(&KEY2

0020.00 /* CALL A PROGRAM WHICH ACCESSES YOUR DATA BASE TO RETRIEVE DATA */

0021.00 /* CALL PGM(RPGPGM) PARM(&KEY &DOCNAM &PATH) */

0024.00 CHGVAR VAR(&PATH) VALUE('C:/TEST/')

0025.00 CHGVAR VAR(&DOCNAM) VALUE('TEST.BMP')

Beispielprogramm für die Übergabe eines Dokumentes aufgerufen durch einen Hotkey, welcher in der Schablone dazu hinterlegt ist

Hinweis

Bitte übergeben Sie an directmedia keine Backslash >>> {color} <<< bei Pfadübergaben, sondern immer nur einfache Slash >>> / <<<

Aufruf von directmedia über einen CALL-Befehl (CALL FSTCALL)

Zusätzlich zum Aufruf von directmedia mittels Hotkeys kann der Aufruf auch direkt über einen CALL-Befehl erfolgen. Das dabei aufzurufende Programm FSTCALL befindet sich in der Bibliothek

DIRMEDIA und benötigt folgende 17 Eingangsparameter wie folgt:

Parameterliste für das Programm FSTCALL:

Parameterbeschreibung

Parametertyp

Gültige Parameterargumente

Pfad und Dokumentenname(Command)

Text 128

z.B.: C:/BITMAP/TEST.BMP

Horizontale Anfangsposition(PX)

Numerisch 4(0)

z.B.: 0050 (50 Pixel von links)Blank für Standardwert

Vertikale Anfangsposition(PY)

Numerisch 4(0)

z.B.: 0040 (40 Pixel von oben)Blank für Standardwert

Breite des Windows(SX)

Numerisch 4(0)

z.B.: 0250 (250 Pixel breit)Blank für Standardwert

Höhe des Windows(SY)

Numerisch 4(0)

z.B.: 0300 (300 Pixel hoch)Blank für Standardwert

Unterdrückung Anzeige Menüs(NM)

Text 1

'1' Keine Anzeige von MenüsBlank für Menüs anzeigen

Unterdrückung Anzeige Toolbar(NT)

Text 1

'1' Keine Anzeige der ToolbarBlank für Toolbar anzeigen

Unterdrückung Anzeige Statusbar (NS)

Text 1

'1' Keine Statusbar anzeigenBlank für Statusbar anzeigen

Unterdrückung Anzeige Caption(=Fenstertitel) (NC)

Text 1

'1' Keine Caption anzeigenBlank für Caption anzeigen

Schließen aller von directmedia vorher geöffneten Windows(CA)

Text 1

'1' Schließen aller WindowsBlank für nicht schließen

Schließen des zuletzt von directmedia geöffneten Windows(CP)

Text 1

'1' Schließen des letzten WindowBlank für nicht schließen

Kontrolle (Focus) an IBM i(CL)

Text 1

'1' Kontrolle geht an IBM iBlank für Kontrolle im Window (Focus)

Horizontale Scrollbalkenposition(SCX)

Numerisch 4(0)

z.B.: 0100 (100 Pixel von links)Blank für Position links

Vertikale Scrollbalkenposition(SCY)

Numerisch 4(0)

z.B.: 0200 (200 Pixel von oben)Blank für Position oben

Zoomfaktor in %(ZM)

Numerisch 3(0)

z.B.: 150 (150 %)Blank für 100%

Drehwinkel des Bildes(AG)

Numerisch 3(0)

z.B.: 090 (um 90° gedreht)Blank für keine DrehungErlaubte Werte: 090, 180, 270

Editierung(ED)

Text 1

'1' Editierung zulässigBlank für keine Editierung

Achtung: Dieser Parameter wird am PC z.Zt. noch nicht unterstützt, muss aber übergeben werden!


Hinweis

Bitte beachten Sie, dass alle Parameter in derselben wie oben angeführten Reihenfolge an das Programm FSTCALL übergeben werden müssen.

Nachfolgend finden Sie ein Beispiel für ein RPG/400-Program, welches obig beschriebene 17 Parameter an das Programm FSTCALL übergibt und dieses aufruft.


***************** Datenanfang *****************************************

0001.00 H* ÜBERGABE DER PARAMETER UND AUFRUF VON FSTCALL

0002.00 E BILD 128 1 ARRAY BITMAP

0003.00 C****************************************************************

0004.00 C MOVEA*BLANKS BILD 0003.00 C MOVEA'C:/TEST/'BILD,1 PFAD

0003.00 C MOVEA'TEST.BMP'BILD,9 BITMAPDATEI

0003.00 C*

0004.00 C CALL 'FSTCALL' 97

0005.00 C PARM BILD PFAD UND DATEINAME

0006.00 C PARM '0050' POSX 4 HORIZ. ANFANGSPOSITION IN PIXEL

0007.00 C PARM '0050' POSY 4 VERT. ANFANGSPOSITION IN PIXEL

0008.00 C PARM '0200' SIZEX 4 BREITE IN PIXEL

0009.00 C PARM '0300' SIZEY 4 HÖHE IN PIXEL

0010.00 C PARM '1' NOMENU 1 KEINE MENÜBAR

0011.00 C PARM '1' NOTOOL 1 KEINE TOOLBAR

0012.00 C PARM '1' NOSTAT 1 KEINE STATUSBAR

0013.00 C PARM ' ' NOCAPT 1 KEINE CAPTION

0014.00 C PARM ' ' DELALL 1 ALTE FENSTER SCHLIEßEN

0015.00 C PARM '1' DELPRE 1 LETZTES FENSTER SCHLIEßEN

0016.00 C PARM '1' CONTRL 1 KONTROLLE AN IBM i

0017.00 C PARM ' ' SCRLX 4 HORIZ. SCROLL-POSITION

0018.00 C PARM ' ' SCRLY 4 VERTIKALE SCROLL-POSITION

0019.00 C PARM ' ' ZOOM 3 ZOOMFAKTOR in %

0020.00 C PARM ' ' ANGLE 3 DREHWINKEL

0021.00 C PARM ' ' EDIT 1 EDITIEREN

0022.00 C*

0023.00 C SETON LR

Beispielprogramm (RPG/400) für den Aufruf von FSTCALL

Hinweis

Bitte übergeben Sie an directmedia keine Backslash >>> {color} <<< bei Pfadübergaben, sondern immer nur einfache Slash >>> / <<<

Konfiguration für Published Applications

Damit directmedia mit einer Terminalsitzung die als Published Application läuft, funktioniert, muss in der Session auch der Prozess DirectRun laufen.
Um aus einer veröffentlichten Terminalsitzung directmedia aufrufen zu können, muss die Published Application folgendermaßen eingerichtet werden:

  • Reiter „Anwendungsname" für Anzeigename, Anwendungsname und Anwendungsbeschreibung z.B. „5250+DirectMedia" verwenden.

...




0125 – Start Published Applikation – Anwendungsname

  • Reiter „Anwendungsstandort" als Anwendungstyp „Anwendung", Befehlszeile„C:\Programme\Toolmaker\Common\ DirectRun.exe
  • „C:\\Mochasoft\mtn5250.exe"" und Arbeitsverzeichnis „C:\Programme\Toolmaker\Directword\Programm\" verwenden.


Image Removed  
126 – Start Published Applikation - Anwendungsstandort


In der Befehlszeile gibt man nicht wie im Normalfall den Namen der 5250-Sitzung an, sondern das Utility Programm DirectRun.exe mit dem vollen Pfad zur 5250-Sitzung als Parameter. Im abgebildeten Beispiel ist die Befehlszeile:

C:\Programme\Toolmaker\Common\DirectRun.exe "C:\Mochasoft\mtn5250.exe"

In den anderen Fenstern kann man die normalen Einstellungen eingeben.


Image Removed  
127 0127 – Start Published Application - Citrix



0128 – Start Published Application - 5250-directmedia