WESCL

 

Wprowadzenie do języka WESCL

WESCL: Rev. 2.19

Pełna definicja gramatyki i opis języka WESCL pt. "Get Going with WESCL" znajdują się w kartotece "Dokumentacja języka WESCL" dyskietki firmowej NETICA. Zaznajomienie się z tym dokumentem ułatwi Ci pracę i zaoszczędzi wiele czasu !

 
co to jest WESCL opis języka WESCL wysyłanie poczty
e-mail
  WESCL - co to jest i jak działa

WESCL
co to jest

 

WebEmbed Simple Control Logic (WESCL) jest prostym, aczkolwiek bardzo silnym i elastycznym językiem programowania sterowników WebEmbed.

Dzięki niemu WebEmbed staje się programowalnym sterownikiem (PLC), który potrafi autonomicznie monitorować i kontrolować lokalne urządzenia podłączone do wejść/wyjść WebEmbed. Dodatkowo, WESCL zawiera unikalne mechanizmy do komunikacji z siecią WEB i do wizualizacji. Pozwala to na zdalne monitorowanie i zmianę stanu tych lokalnie podłączonych urządzeń z każdego niemal komputera na świecie, jeśli wyposażony on jest w standardową przeglądarkę HTML i dostęp do linii telefonicznej lub internetu.

WESCL jest jedną z możliwych aplikacji zaimplementowanych na WebEmbed.

 

WESCL
jak to działa
wescl jest jednym z procesów (task'ów) wielozadaniowego systemu czasu rzeczywistego w WebEmbed. Jego częściami składowymi są:
  1. kompilator języka WESCL: wczytuje on program WESCL z pliku auto.scl (w kartotece home) do pamięci programu, i tłumaczy go na kod wewnętrzny,
  2. egzekutor wescl: program pracujący w pętli nieskończonej, wykonując program w kodzie wewnętrznym, wygenerowanym przez kompilator z pliku auto.scl,
  3. cgi-bin wescl: program umożliwiający wymianę danych między egzekutorem a przegladarką HTML,

Kompilator WESCL wczytuje do pamięci i tłumaczy (rekompiluje) program auto.scl w następujących przypadkach:

  • przy włączeniu zasilania,
  • po zerowaniu (reset),
  • po ustawieniu rejestru S0 na "1" przez program sterujący auto.scl lub ze strony HTML użytkownika.

Egzekutor wescl w cyklu co 100ms (wartość standardowa, możliwa do zwiększenia) wykonuje następującą sekwencję kroków:

  1. początek,
  2. wczytanie sygnałów wejściowych do zmiennych wejściowych,
  3. wykonanie instrukcji z programu auto.scl (wszystkie operacje logiczne i arytmetyczne po kolei),
  4. zdekrementowanie wszystkich liczników (zmiennych Cx) o jeden,
  5. przepisanie stanu zmiennych wyjściowych do wyjść,
  6. koniec.

Cgi-bin wescl pozwala na komunikację między egzekutorem wescl a przegladarką komputera zdalnego w obu kierunkach:

Komunikacja przeglądarka HTML -> wescl:

zmienne WESCL mogą być zmieniane od strony browsera poprzez wywołanie programu cgi-bin wescl wraz z odpowiednimi parametrami (wg syntaktyki zgodnej z RFC 1738). Wywołania typu

wescl?zmienna=wartość&zmienna=wartość

mogą się znajdować zarówno jako hyperlinki w kodzie HTML, jak i w linii URL przeglądarki. I tak dla przykładu wywołanie

http://<adres IP>wescl?O1=1

ustawia wyjście binarne WebEmbed na wartość logiczną "1".

Komunikacja  wescl -> przeglądarka HTML:

Istotną częścią składową programu cgi-bin wescl jest tzw. preprocesor HTML. Generuje on z szablonu strony HTML (tzw. plik p-HTML) stronę wynikową, która następnie zostanie wysłana z WebEmbed do przeglądarki. Każda odpowiedź cgi-bin wescl jest "przepuszczana" przez taki preprocesor. Stanowi on swoisty filtr: wszystkie łańcuchy zaków typu &IOString(regname) zostają w stronie p-HTML znalezione i zastąpione aktualnym stanem zmiennej WESCL regname, przed odesłaniem jej do przeglądarki. Tak więc użytkownik, chcąc przedstawić aktualny stan zmiennej WebEmbed na przeglądarce, przygotowuje stronę HTML (a dokładniej: szablon takiej strony), gdzie w miejscach prezentacji stanu zmiennych wpisuje zastrzeżony łańcuch &IOString(regname), wstawiając w miejsce regname nazwę odpowiedniej zmiennej (rejestru) WESCL, np. &IOString(M1) dla wyświetlenia aktualnej wartości zmiennej M1, jak w przykładzie:

<br>M1=&IOString(M1)

Stroną p-html jest plik HTML, którego nazwa (link) jest aktualnie umieszczona w zmiennej V. Oczywiście można zmieniać zawartość zmiennej V (w programie auto.scl lub w wywołaniach cgi-bin wescl). Istnieje jednak tylko jedna zmienna wizualizacji V, jako, że w danym momencie może być wysłana tylko jedna strona HTML, jako odpowiedź cgi-bin wescl.


Użytkownik (projektant) tworząc własną aplikację przygotowuje następujące pliki:

  • plik tekstowy auto.scl, stanowiący program sterujący dla WebEmbed zgodnie z semantyką i syntaktyką języka WESCL.

  • stronę/strony HTML (ewentualnie z elementami Java, Javascript, itp.), stanowiącą/stanowiące de facto szablon/szablony strony HTML dla preprocesora WebEmbed. Strona/strony taka/takie zawierają zarówno hyperlinki do cgi-bin wescl (tam, gdzie mają być zmieniane wartości zmiennych WESCL), jak i słowa kluczowe &IOString(regname), stanowiące parametry formalne dla cgi-bin wescl (tam, gdzie zmienne WESCL mają być wizualizowane na przeglądarce).

  • wszystkie ewentualne dodatkowe pliki graficzne, itp.

Wszystkie powyższe pliki zostają następnie załadowane do kartoteki home WebEmbed przez FTP-upload. Po ponownej rekompilacji pliku auto.scl, w przypadku braku błędów, WebEmbed autonomicznie wykonuje program sterujący tam zapisany, niezależnie, czy jest połaczony do sieci web, czy też nie.

Zewnętrzny użytkownik/obserwator może się z nim łączyć w dowolnej chwili i oglądać/zmieniać stan zmiennych systemowych (jeśli posiada uprawnienia typu użytkownik/hasło), przeglądając odpowiednie strony HTML i wywołując cgi-bin wescl.

 

Uwaga:

  • nie myl pojęcia WESCL, będącego definicją języka, w którym kodujesz programy sterujące auto.scl, z wywołaniem cgi-bin wescl, które umieszczasz jako hyperlink w Twojej stronie HTML lub wprowadzasz w linii URL Twojej przeglądarki !

  • nie zapominaj o odpowiednim ustawieniu/ustawianiu zmiennej wizualizacji V !

  • nie zapominaj o rekompilacji pliku auto.scl, po każdej jego zmianie !

 

Porada:

Podczas projektowania aplikacji możesz zechcieć na Twojej aktualnej stronie roboczej umieścić hyperlink, powodujący rekompilację pliku auto.scl. Może to wyglądać następująco:

<a HREF="wescl?V=Mypage.htm&S0=1">recompile "auto.scl" and start Mypage</a>

  WESCL - elementy języka
WESCL
Typy danych
Język WESCL rozróżnia trzy typy danych:
  •  logiczne (boolean: true, false)
  •  całkowite 16-bitowe ze znakiem (signed integer: -32768 .. 32767)
  •  łańcuchy (string)

Konwersje typów są przeprowadzane wyłącznie między wartościami integer i boolean:

  • integer do boolean: wartość nierówna zero jest true, a równa zeru jest false,
  • boolean do integer: true równa się 1, false równa się 0.

 

WESCL
Zmienne (rejestry)
Język WESCL operuje na następujących zmiennych (rejestrach):

1.) zmienne/rejestry boolean:

  • wejścia cyfrowe I0 .. I99
    (w WebEmbed-IND3: I1 .. I12)
  • wyjścia cyfrowe O0 .. O99
    (w WebEmbed-IND3: O1 .. O8, O0 - jt. piszczek (buzzer))

 

2.) zmienne/rejestry numeryczne (16- bit signed integer):

  • zmienne bez podtrzymania "volatile" (zerowane przy każdym restarcie systemu) B0 .. B99
  • zmienne z podtrzymaniem (bateryjnym) zawartości "non-volatile" (zachowują swoją zawartość nawet po odłaczeniu zasilania, nie zerowane przy restartach) M0 .. M99. Przy starcie systemu WebEmbed rozpoznaje, czy podtrzymanie bateryjne było cały czas obecne. Jeśli nie (słaba bateria lub wymiana baterii) zmienne te są zerowane.

  • wejścia analogowo-cyfrowe D0 .. D19
    (w WebEmbed-IND3: D1 .. D8)

  • liczniki cyklów wescl C0 .. C99
    Pod koniec każdego cyklu egzekutora wescl wszystkie liczniki, których wartość jest większa od 0, są automatycznie dekrementowane o 1.

  • specjalne rejestry kontrolne S0 .. S99
    Rejestry kontrolne Sxx służą do monitorowania i kontrolowania stanu systemu WebEmbed oraz niektórych jego opcji sprzętowych. Rejestry te są dokładniej opisane w "Dokumentacji języka WESCL" (rozdział 3).
    Można je pogrupować według funkcjonalności:
    S0 - identyfikuje i wymusza pierwszy cykl egzekutora wescl (rekompilacja programu auto.scl)
    S12, S13 - tylko w WebEmbed-IND3: obsługa binarnego wejścia liczącego I12
    S20 .. S28 - czas i data WebEmbed
    S30 .. S33, S40 .. S57 - kontrola wysyłania poczty e-mail (patrz opis agenta WCA)
    S91 - mnożnik czasu cyklu egzekutora wescl. Wykorzystywany dla wydłużania cyklu o wielokrotność 100ms, wg formuły:
    Czas cyklu wescl: S91 * 100ms
    np. (w pliku HTML):
    <a HREF="wescl?S91=3">prolong wescl cycle by 3</a>
    Wartość domyślna S91 wynosi 1.

Dzięki konwersji typów, zmienne numeryczne mogą być również wykorzystywane jako zmienne typu boolean.

 

3.) zmienne/rejestry łańcuchowe (string variables):

Są to zmienne A0 .. A99, przechowujące łańcuchy znakowe ASCII i wykorzystywane do sterowania wyglądem stron HTML na przeglądarce. Używa się ich zwykle do deklarowania zmiennych elementów stron HTML, przygotowując szablon takich stron dla preprocesora. Zawartości zmiennych łańcuchowych w auto.scl muszą być deklarowane w cudzysłowiu, np.

I1 and not O5 : A1 = "obrazek1.gif";
I1 and O5 : A1 = "obrazek2.gif";


Wykorzystanie powyższego zapisu w przygotowywanej przez projektanta stronie HTML (pliku p-html) mogłoby, dla przykładu, wyglądać następująco:
<img src="&IOString(A1)" width="350" height="285">
co spowodowałoby wyświetlenie w tym miejscu na przeglądarce różnych obrazków, zależnie od stanu wyjść O5.

Sam znak cudzysłowia, jeśli ma być jednym ze znaków łańcucha, musi być poprzedzony znakiem backslash'u, tzn. \". Można wówczas uzyskać ten sam efekt z powyższego przykładu, inaczej umieszczając znaki cudzysłowia:

I1 and not O5 : A1 = "\"obrazek1.gif\"";
I1 and O5 : A1 = "\"obrazek2.gif\"";

a na stronie HTML wykorzystanie zmiennej A1 wyglądałoby:
<img src=&IOString(A1) width="350" height="285">

Opis pozostałych znaków specjalnych znajdziesz w rozdziale 2.3.1 "Dokumentacji języka WESCL".

 

4.) zmienna/rejestr wizualizacji: V

Jest to (jedyna) zmienna zawierająca link do strony HTML (a dokładniej do szablonu takiej strony, nazywanym umownie plikiem p-html), która ma być przesłana do preprocesora HTML przed wysłaniem odpowiedzi do przeglądarki przez cgi-bin wescl. Użytkownik sam ustawia jej zawartość w pliku auto.scl lub na stronach HTML. Typowe jej wykorzystanie w pliku HTML:

<a HREF="wescl?V=Anypage.htm">Goto Anypage</a>

Przy starcie programu, dopóki użytkownik samemu nie zainicjalizuje zmiennej V, jej wartość domyślna wskazuje na plik default.htm.

 

5.) zmienna/rejestr stanu kompilatora i egzekutora wescl: E

Jest to preformatowana zmienna, informująca o statusie kompilatora (ewentualne błędy kompilacji), jak i stanie procesu egzekutora wescl. Więcej informacji na temat zmiennej E znajdziesz w rozdz. 4.2.2 "Dokumentacji języka WESCL".

 

WESCL
Instrukcje
  • Instrukcje WESCL są oddzielane średnikiem,

  • komentarze i tzw. znaki białe (tabulator, nowa linia, spacja) są ignorowane,

  • komentarze w pojedynczej linii rozpoczynają się podwójnym ukośnikiem '//', a wielowierszowe muszą zawierać się między znakami '/*' a '*/' (podobnie jak w języku C),

  • jedna instrukcja może zajmować wiele wierszy; w jednym wierszu może być więcej niż jedna instrukcja,

Instrukcje WESCL mają ogólną postać:

<expression> : <action>;

Zależnie od tego, co znajduje się po stronie action, instrukcje dzielą się na dwa rodzaje:

  1. w przypadku, gdy <action> zawiera operator przypisania "=", instrukcja taka wykonywana jest wg reguły:

    jeśli <expression> ma wartość true, to wykonaj <action>

    np.
    I3 and I2 : O2=ON;
    I1 : M5 = B9+M5;

  2. w przypadku, gdy <action> nie zawiera operatora przypisania "=", a więc tylko nazwę zmiennych, instrukcja taka wykonywana jest wg reguły:

    przepisz bezwarunkowo wartość <expression> do zmiennej (zmiennych) stojących po stronie <action>

    np.
    B3-M1 : C9;
    I3 : O5;

Dopuszczalne są również instrukcje z wielokrotnością operacji po stronie <action>, rozdzielonych przecinkiem,

np.
jednorodne:

not C2: O1, O8, M1;
M1 : M2, M3, M4, M5;
M7 == -44 : O1=1, O2=0, B9=33;

lub mieszane:

M9 != 10 : M5=M3+1; B3, O2, C22=9;
!O1 : O1, B0=0;

Język WESCL dopuszcza również umieszczanie operacji w nawiasach, podnosząc w ten sposób ich priorytet. Dopuszczalne jest zagnieżdżanie w nawiasach do 5 poziomów.

np.
(M1 + M2) * 10 / (C3 - C4) : B20;
(I1 || I2) && B0 : M2 = ((M3 - B0) % 8) * B1;

 

WESCL
Operatory
Język WESCL oprócz operatora przypisania definiuje następujące operatory:

operatory logiczne (wg malejącego priorytetu):

not
!

logiczna negacja

and
&&

logiczny iloczyn

or
||

logiczna suma

operatory arytmetyczne (wg malejącego priorytetu):
- negacja znaku
*
mnożenie
/
dzielenie
% dzielenie modulo
+
dodawanie
-
odejmowanie

Operatory arytmetyczne mogą występować po obydwu stronach instrukcji: zarówno po stronie <expression>, jak i <action> (jeśli jest to przypisanie).

operatory porównania:
<
mniejszy niż
>
większy niż
<=
mniejszy lub równy
>=
większy lub równy
!=
różny od
==
równy

Wszystkie operatory oraz ich bezwzględne priorytety są dokładniej opisane w rozdziale 2.6 "Dokumentacji języka WESCL".

Niektóre operatory i słowa kluczowe języka WESCL mają swoje aliasy, (np. ':' i '==>', 'true' i 'ON'), dokładniej opisane w rozdziale 2.9 "Dokumentacji języka WESCL".

 

 WESCL
Przykłady
Poniżej przedstawiono kilka prostych przykładów użycia języka WESCL i jego elementów:
  1. w pliku auto.scl:

    I1 and I2 or I3 : B1=-10, B2=M1+M2;
    Do B1 jest wpisywana wartość -10, a do B2 suma aktualnych wartości M1 i M2 pod warunkiem, że obydwa wejścia I1 i I2 lub wejście I3 jest w stanie true. W przeciwnym razie, zmienne B1 i B2 pozostają nie zmienione.

    D1 > M20 ==> O1;
    Jeśli D1 jest większe od M20, to wyjście O1 zostanie ustawione w stan true ('ON'). W przeciwnym razie wyjście O1 będzie w stanie false ('OFF').

    S0 : C1=10;
    C1 : O1;

    Wyjście O1 jest ustawione w stan ON przez 1 sekundę od startu systemu. Następnie wyjście to przechodzi w stan OFF.

    not C90 and O5 : B1=0;
    not C90 and not O5 : B1=1;
    B1 : O5;
    not C90 : C90 = 10;

    Wyjście O5 zmienia cyklicznie stan: 1 sekunda ON / 1 sekunda OFF.

    not S27 and !(S26%5) : O3;
    Co pełne 5 minut ustaw wyjście O3 w stan ON na czas 1 sekundy.

  2. ustawianie zmiennej WESCL na stronie HTML:

    <a HREF="wescl?C10=600"><img src="button.gif">Timer to 1 Minute</a>
    Kliknięcie na ikonkę pt. button.gif lub na link powoduje ustawienie licznika C10 w WebEmbed na 1 minutę.

  3. wyświetlanie aktualnego stanu zmiennych WESCL na stronie HTML:

    a) dla zmiennych boolean i integer (preprocesor wstawia aktualną wartość zmiennej):
    <br>D12 = &IOString(D12)
    <br>The value of I3 is &IOString(I3)

    Na przeglądarce widoczne będą nazwy obydwu zmiennych i ich aktualne wartości.


    b) dla zmiennych łańcuchowych (preprocesor wpisuje do strony HTML cały aktualny łańcuch, będący zawartością zmiennej):
    <a HREF="wescl?O1=&IOString(A5)></a>
    gdzie zmienna A5 została przygotowana w pliku auto.scl na przykład w następujący sposób:
    O1 : A5="OFF\">Output 1 is ON - Turn it OFF";
    not O1 : A5="ON\">Output 1 is OFF - Turn it ON";
    Powyższy przykład, choć wydaje się bardzo skomplikowany, jest typowym przykładem wizualizacji dynamicznego hyperlinka na stronie HTML, zależnego od stanu zmiennej, którą steruje.

    Zastosowanie zmiennych łańcuchowych do manipulacji plikami HTML daje niemal nieograniczone możliwości.

    Przykład zmiany koloru na stronie HTML, w zależności od stanu zmiennej:
    <font color="&IOString(A1)">
    przy czym zmienna A1 jest w pliku auto.scl np. zdefiniowana jako:
    M3<=10: A1 = "#0000FF";
    M3>10 : A1 = "#FF0000";

 

  Wysyłanie wiadomości e-mail
(WESCL Communication Agent WCA)
 WCA
możliwości
WebEmbed pozwala na kontrolowane, autonomiczne wysyłanie poczty elektronicznej e-mail.
W tym celu nawiązuje on kontakt z zadeklarowanym przez użytkownika rzeczywistym serwerem poczty wychodzącej (tzw. serwerem SMTP), którego adres IP użytkownik definiuje na stronie konfiguracyjnej WebEmbed. Jeśli serwer SMTP dostarcza dodatkowo usługę automatycznego przekazywania wiadomości elektronicznych na wiadomości SMS, odbiorcy mogą być natychmiastowo powiadamiani o wystąpieniu określonych zdarzeń w systemie kontrolowanym przez WebEmbed.

Wysyłanie poczty email jest w pełni zintegrowane z egzekutorem wescl, co pozwala na:

a) pełną kontrolę zdarzeń warunkujących wysyłanie wiadomości e-mail (w pliku auto.scl lub p-html),

b) pełną integrację zmiennych (rejestrów) WESCL w treści tych wiadomości i ich załącznikach.

Wysyłanie poczty elektronicznej jest w dużym stopniu sparametryzowane, pozwalając m. in. na:

  • elastyczną i zmienną listę odbiorców wiadomości,

  • różnorodny i dynamicznie wybieralny, predefiniowalny tekst wiadomości,

  • opcjonalne dołączanie do wiadomości załącznika, zawierającego rejestr stanów wybranych przez projektanta zmiennych (rejestrów) WESCL w określonych momentach czasu,

  • formatowanie załącznika,

  • kontrolę poprawności wysłania wiadomości e-mail.

Szczegółowy opis agenta pocztowego WCA, wraz z charakterystyką wszystkich jego parametrów znajduje sie w "Dokumentacji języka WESCL", rozdz. 5.

 

Adresowanie i komponowanie wiadomości 1.) Adresowanie

Adresat, wraz z nadawcą i tematem wiadomości są zdefiniowani w pliku address.#n (w kartotece home), gdzie #n jest liczbą od 1 do 32768. Oznacza to, że WebEmbed pozwala na zdefiniowanie do 32768 zestawów adresatów (w plikach address.1 ... address.32768).

Każdy z plików address.#n może składać się tylko z jednej linii (o maks. długości 512 znaków). W linii tej powinny wystąpić wymagane pola adresacji wiadomości e-mail (fraza mailto:), jednoznacznie zdefiniowane w RFC 2368. Są to:

  • from= (obowiązkowe)
  • to=
  • cc=
  • bcc=
  • Reply-To=
  • In-Reply-To=
  • subject=

Przykład zawartości pliku address.#n:

mailto: Piotr Iksinski <Iksinski@friko3.onet.pl>,
<netica@pro.onet.pl>?from=<webembed@interia.pl>
&cc=<webembed@wp.pl>&Reply-To=
<netica@pro.onet.pl>&subject=Exception happened !!

 

2.) Treść wiadomości

Treść wiadomości jest plikiem tekstowym (ASCII) i znajduje się w jednym z plików body.#n (w kartotece home), gdzie #n jest liczbą od 1 do 32768. Oznacza to, że WebEmbed pozwala na zdefiniowanie do 32768  różnych wiadomości (w plikach body.1 ... body.32768).

Treść wiadomości może zawierać łańcuchy &IOString(regname), które przed wysłaniem do odbiorcy są zastępowane aktualnymi wartościami zmiennych (rejestrów) WESCL, podobnie jak to ma miejsce w przypadku strony p-html przed przesłaniem jej do przeglądarki.

Przykład zawartości pliku body.#n:

Both inputs I1 and I2 are true. Today's date is:

day: &IOString(23)

month: &IOString(22)

year: &IOString(20)

 

3.) Załącznik

Jako załącznik wiadomości e-mail może być dołączona część lub całość tzw. bufora cyklicznego.

Bufor cykliczny zapamiętuje do 512 rekordów, po osiem wybranych zmiennych (rejestrów) WESCL każdy. Opcjonalnie, każdy rekord może być poprzedzony datą i godziną jego rejestracji (tzw. timestamp).

Użytkownik ma możliwość wyboru zmiennych zapisywanych w buforze, kontroli stanu zapełnienia bufora, ilości rekordów umieszczanych w załączniku oraz formatowania tegoż załącznika.

W każdym rekordzie zapisywane jest 8 zmiennych WESCL, w kolejności S50 ... S57. Zapisywaniem do bufora steruje rejestr S40. Użytkownik przed zapisaniem rekordu do bufora powinien (w pliku auto.scl lub z przeglądarki) zdefiniować jego aktualną zawartość, przypisując zmiennym S50 ... S57 albo konkretną wartość absolutną, albo (częściej) aktualne wartości innych zmiennych WESCL. Nie trzeba przy tym wykorzystywać wszystkich ośmiu zmiennych: ich ilość w rekordach, pojawiających się w e-mailu, jest określona w pliku formatującym attachment.#n (w kartotece home), chociaż w buforze cyklicznym faktycznie zawsze zapisywane jest wszystkich 8 zmiennych. WebEmbed wysyła jako załącznik e-mail tylko tyle zmiennych rekordu, ile użytkownik zdefiniował w pliku formatującym.

Formatowanie załącznika w plikach formatujących attachment.#n (#n = 1 .. 32768) polega na zadeklarowaniu ilości i formatu zmiennych, wspólnego dla każdego rekordu w buforze. Obowiązują przy tym formaty: %d, %u, %x, %X, zdefiniowane podobnie, jak w języku C.

Timestamp każdego rekordu (%t), jeśli pożądany, musi występować na pierwszej pozycji formatowania.

Przykład formatowania rekordu z bufora, przesłanego jako załącznik do wiadomości email (zawartość pliku attachment.#n):

First: %04d ; Second: %3d ; Third: %2d

Oznacza to, że w załączniku wiadomości e-mail będą zamieszczone rekordy z bufora cyklicznego, z których każdy będzie rejestracją stanów trzech zmiennych: S50, S51, S52. Stany tych zmiennych wynikają z ich aktualnego przyporządkowania innym zmiennym WESCL (lub wartościom absolutnym), zazwyczaj wg programu auto.scl. Ilość rekordów bufora wysyłanych wraz z wiadomością e-mail określa zmienna S33.

Załącznik wiadomości sformatowany wg powyższego przykładu będzie mógł u odbiorcy wyglądać np. w sposób następujący (przy założeniu, że S33=3):

First: 0012 ; Second: 764 ; Third: 21
First: 0008 ; Second:     5 ; Third:   1
First: 7712 ; Second:   11 ; Third: 82

 

Wysyłanie poczty

Wysyłaniem i kontrolą poprawności wysyłania wiadomości e-mail rządzi zestaw zmiennych (rejestrów) WESCL. Najważniejsze z nich to:

S30 wybór pliku address.#n (S30=5 wskazuje na address.5)
S31 wybór pliku body.#n (S31=1 wskazuje na body.1). Wartość 0 oznacza brak treści (body).
S32 wybór pliku attachment.#n (S32=22 wskazuje na attachment.22). Wartość 0 oznacza brak załącznika.
S33 ilość rekordów z bufora, która ma być załączona w wiadomości. Wartość 0 powoduje wysłanie całego aktualnego bufora. Rekordy wysłane zostają wykasowane z bufora.
S40 zapis rekordu do bufora cyklicznego
S41 kasowanie całości bufora
S42 wysyłanie wiadomości
S43 przerwanie wysyłania wiadomości
S44 wskaźnik zakończenia wysyłania wiadomości
S45 kod błędu wysyłania (major)
S46 aktualna ilość rekordów w buforze
S47 pojemność bufora cyklicznego (w rekordach)
S48 wskaźnik przepełnienia bufora
S49 kod błędu wysyłania (minor)

Pełny wykaz i opis wszystkich rejestrów (zmiennych) WCA oraz możliwe kody błędów znajdziesz w "Dokumentacji języka WESCL", w rozdz. 5.

Przykłady sterowania procesem wysyłania wiadomości e-mail w programie auto.scl:

  • zapisywanie rekordu do bufora:
    true: S50=B1, S51=M1, S52=D1, S53=-99, S40=1;

  • zerowanie bufora:
    true: S41 = 1;

  • wysłanie wiadomości wg wybranych plików adresacji, treści i formatowania (kompletny bufor):
    !S44 ==> S30=1, S31=1, S32=1, S33=0; S42=1;

  • sprawdzenie poprawności wysłania wiadomości (z przygotowaniem tekstu dla strony HTML):
    !S44 && !S45 && !S49 : A1="message sent";

Więcej przykładów znajdziesz zarówno w "Dokumentacji języka WESCL", rozdz. 5, jak i w kartotece SMTP-test na dyskietce firmowej.

 

Wskazówki Kilka pożytecznych rad na zakończenie:
  1. aby WebEmbed potrafił wysyłać wiadomości e-mail, łącząc się bezpośrednio z internetem (poprzez modem), adres IP jego domyślnej bramy (Gateway) musi być 0.0.0.0,

  2. aby znaleźć adres IP konkretnego (znanego Ci) serwera SMTP, wykorzystaj na Twoim komputerze komendę 'PING' z podaniem nazwy tego serwera, po uprzednim połączeniu się z internetem,

  3. serwery SMTP, chociaż nie wymagają autoryzacji (użytkownik/hasło), często mają inne ograniczenia (różne dla różnych serwerów). Np. niektóre przyjmuja pocztę do wysłania tylko od zarejestrowanych (znanych im) użytkownikom (analizują pole from= frazy mailto:)

 

powrót do początku strony