j9j24jb

Serviciile de comunicatie prin mesaje permit programelor de aplicatie: a) sa emita mesaje de 1 pina la 55 de octeti vederea difuzarii la mai multe destinatii; b) sa stabileasca unul sau mai multe canale de mesaje cu anumite statii de lucru, legate la acelasi file server. Un astfel de canal ofera posibilitatea transmiterii de mesaje de 1 pina la 126 de octeti.

Difuzarea de mesaje si comunicatia prin canale consuma timp calculator pe server. Pentru o adevarata comunicatie de la egal la egal intre statiile de lucru, programele de aplicatie pot folosi functiile IPX (Internetwork Packet Exchange) sau SPX
(Sequenced Packet Exchange), sau NetBIOS. Aceste functii nu folosesc timp pe server si deci ofera performante mai bune si o flexibilitate crescuta.

Pentru serviciul de difuzare a mesajelor, fiecare coonexiune a unui file server are asociat un buffer de 55 de octeti; pentru serviciul de comunicatie prin canale, serverul mentine pentru fiecare conexiune o coada de mesaje (capacitatea maxima a cozii este de 6 mesaje).

In mod normal, odata ce o conexiune trimite un mesaj spre difu zare catre o alta conexiune, acesta este depus in bufferul de mesaje difuzate sau in coada de mesaje primite ale conexiunii destinatare, de unde este preluat de supervizor (shell) si afisat pe linia cea mai de jos (a 25-a linie) a ecranului.

Fiecare conexiune are un mod de tratare a mesajelor (un numar intre 0 si 3, care poate fi modificat prin program), care preci zeaza daca bufferul destinat mesajelor difuzate este deschis sau nu, si daca supervizorul are sau nu voie sa preia automat mesa jele difuzate.

Functiile de comunicare prin mesaje sint folosite de programele utilitare SEND, CASTON si CASTOFF, care se folosesc pentru a emite mesaje in vederea difuzarii, a permite sau a interzice receptionarea mesajelor difuzate. Mesajele transmise cu ajutorul acestor functii pot fi inregistrate intr-un fisier jurnal spe cial, accesibil administratorului retelei.

Fisiere antet necesare:

nit.h niterror.h

BroadcastToConsole
IIIIIIIIIIIIIIIIII
Trimite un mesaj care va fi afisat la consola serverului implicit. Mesajele afisate la consola sterg mesajele precedente.

Parametri:

char * message sir de caractere continind mesajul de trimis.
Lungimea maxima este de 60 de caractere, inclusiv NULul terminator. Sint permise numai caracterele imprimabile din setul ASCII.

Rezultat:

int SUCCESSFULL
MESSAGE_QUEUE_FULL
IO_FAILURE (lipsa spatiu dinamic de lucru).

CheckPipeStatus
IIIIIIIIIIIIIII
Determina starea uneia sau a mai multor canale de mesaje.

Parametri:

WORD * connectionList tablou continind numerele de conexiune ale statiilor la care este legat fiecare dintre canalele asupra carora se face interogarea.
BYTE * resultList fiecare element din acest tablou va primi ca valoare un cod indicind starea canalului identificat de elementul corespunzator din connectionList. Sint definite urmatoarele valori: 0x00 --> canal in stare de functionare, 0xFE --> cealalta conexiune nu a deschis canalul corespunzator, 0xFF --> canalul nu a fost deschis, sau numarul conexiunii este eronat.
WORD connectionCount numarul de canale (elemente in tablou rile precedente).

Rezultat:

int SUCCESSFUL

CloseMessagePipe
IIIIIIIIIIIIIIII
Inchide unul sau mai multe canale de mesaje.

Parametri:

WORD * connectionList tablou continind numerele de conexiune ale statiilor la care este legat fiecare dintre canalele care trebuie inchise.
BYTE * resultList fiecare element din acest tablou va primi ca valoare un cod indicind starea canalului identificat de elementul corespunzator din connectionList. Sint definite urmatoarele valori: 0x00 --> canalul a fost inchis cu succes, 0xFD --> eroare, cealalta conexiune nu mai este valida, 0xFF --> eroare, canalul nu era deschis.
WORD connectionCount numarul de canale (elemente in tablou rile precedente).

Rezultat:

int SUCCESSFULL
MESSAGE_QUEUE_FULL
IO_FAILURE (lipsa spatiu dinamic de lucru).

GetBroadcastMessage
IIIIIIIIIIIIIIIIIII
Preia un mesaj transmis prin difuzare. Apelarea acestei functii are sens numai daca modul de tratare a mesajelor difuzate este 2 sau 3.

Parametri:

char * messageBuffer va receptiona mesajul (cel mult 56 de caractere, inclusiv NULul terminator). Daca nici un mesaj nu este disponibil, atunci messageBuffer a0i va lua valoare '\0'
(lungimea minima a unui mesaj este 1).

Rezultat:

int SUCCESSFULL
MESSAGE_QUEUE_FULL
IO_FAILURE (lipsa spatiu dinamic de lucru).

GetBroadcastMode
IIIIIIIIIIIIIIII
Permite aflarea modului curent de tratare a mesajelor difuzate.
Un mesaj din partea serverului poate elimina din buffer un mesaj din partea unei statii de lucru.

Rezultat:

BYTE 0 --> mesajele sint admise atit din partea altor statii de lucru cit si din partea serverului. Supervizorul statiei preia automat si afiseaza fiecare mesaj.
1 --> mesajele sint admise numai din partea serverului. Supervizorul statiei preia automat si afiseaza fiecare mesaj.
2 --> mesajele sint admise numai din partea serverului. Este sarcina utilizatorului sa preia mesajele.
3 --> sint admise mesaje atit din partea serverului cit si a altei statii de lucru.
Este sarcina utilizatorului sa preia mesajele.

GetPersonalMessage
IIIIIIIIIIIIIIIIII
Preia un mesaj din coada de mesaje asociata statiei de lucru.

Parametri:

char * messageBuffer primeste ca valoare un sir de caractere reprezentind cel mai vechi mesaj din coada
(cel mult 127 de caractere, inclusiv NULul terminator).
WORD * connectionNumber primeste ca valoare numarul conexiunii care a emis mesajul, sau 0 daca nu exista nici un mesaj in coada.

Rezultat:

int SUCCESSFUL
IO_FAILURE (lipsa spatiu dinamic de lucru).

LogNetworkMessage
IIIIIIIIIIIIIIIII
Depune un mesaj in fisierul NET$LOG.MSG al serverului implicit.
Intrarea in fisier va avea urmatorul format:

luna/zi/an ore:minute STN numar_statie: mesaj

Functia poate fi utilizata de utilitare sau de programe de aplicatie care au nevoie sa intregistreze informatii, de exemplu cu scopul de a le folosi pentru contabilitate.

Parametri:

char * message sir de caractere imprimabile continind mesajul de inregistrat (cel mult 80 de caractere, inclusiv NULul terminator).

Rezultat:

int SUCCESSFUL.

OpenMessagePipe
IIIIIIIIIIIIIII
Creaza o jumatate de canal de comunicatie intre statia de lucru si una sau mai multe conexiuni; cealalta jumatate a canalului
(canalelor) trebuie create de conexiune (conexiunile) destina tara, cu ajutorul aceleiasi functii.

Parametri:

WORD * connectionList un tablou continind numerele conexiuni lor la care trebuie conectata statia de lucru. Pentru fiecare element din acest tablou se afla un element coorespunzator in tabloul resultList.
BYTE * resultList elementele acestui tablou primesc ca valoare un cod care indica rezultatul incercarii de a deschide o conexiune intre statia de lucru si conexiunea indicata de elementul corespunzator din connectionList. Valorile acestui cod pot fi: 0x00 --> succes, conexiunea destinatara crease deja jumatatea ei de canal, 0xFE --> canal incomplet, conexiunea destinatara exista, dar nu a creat inca jumatatea ei de canal, 0xFF --> esec, conexiunea destinatara nu exista.
WORD connectionCount numarul de intrari in connectionList.

Rezultat:

int SUCCESSFUL
IO_FAILURE (lipsa spatiu dinamic de lucru).

SendBroadcastMessage
IIIIIIIIIIIIIIIIIIII
Trimite un mesaj spre difuzare la un numar de conexiuni de pe acelasi server.

Parametri:

char * message mesaj de difuzat (cel mult 56 de caractere, inclusiv terminatorul NUL).
WORD * connectionList tablou continind numerele conexiunilor catre care trebuie difuzat mesajul.
BYTE * resultList tablou ale carui elemente primesc ca valoare un cod indicind modul in care s-a desfasurat difuzarea mesajului catre conexiunea corespunzatoare din connectionList. Valorile acestui cod pot fi: 0x00 --> succes, mesajul a fost depus in bufferul de mesaje ddifuzate al conexiunii destinatare, 0xFC --> esec, bufferul de mesaje difuzate al conexiunii destinatare este deja plin, 0xFD --> numarul conexiunii destinatare este eronat, 0xFF --> esec, conexiunea destinatara nu exista sau modul ei de tratare a mesajelor difuzate nu permite acceptarea mesajului.
WORD connectionCount numarul de intrari in connectionList.

Rezultat:

int SUCCESSFUL
IO_FAILURE (lipsa spatiu dinamic de lucru).

SendPersonalMessage
IIIIIIIIIIIIIIIIIII
Trimite un mesaj catre una sau mai multe conexiuni cu care statia de lucru a deschis canale de mesaje.

Parametri:

char * message mesaj de trimis (cel mult 127 de caractere, inclusiv terminatorul NUL).
WORD * connectionList tablou continind numerele conexiunilor catre care trebuie trimis mesajul.
BYTE * resultList tablou ale carui elemente primesc ca valoare un cod indicind modul in care s-a desfasurat trimiterea mesajului catre conexiunea cores punzatoare din connectionList. Valorile aces tui cod pot fi: 0x00 --> succes, mesajul a fost depus in bufferul de mesaje ddifuzate al conexiunii destinatare, 0xFC --> esec, coada de mesaje a conexiunii destinatare este deja plina, 0xFE --> conexiunea destinatara nu a deschis acest canal, 0xFF --> esec, conexiu nea destinatara nu exista sau statia de lucru nu a deschis un canal de comunicatie spre aceasta conexiune.
WORD connectionCount numarul de intrari in connectionList.

Rezultat:

int SUCCESSFUL
IO_FAILURE (lipsa spatiu dinamic de lucru).

SetBroadcastMode
IIIIIIIIIIIIIIII
Stabileste modul in care sint tratate mesajele difuzate destinate acestei statii de lucru.

Parametri:

BYTE broadcastMode o valoare intre 0 si 3 specificind modul de tratare a mesajelor difuzate. Modul implicit este zero. Pentru semnificatia valorilor vezi functia GetBroadcastMode.