Inainte ca un utilizator, sau un alt obiect din bindery, sa poata folosi resursele unui file server, el trebuie sa stabileasca o conexiune fizica si una logica intre statia de lucru si file server. Pentru a stabili conexiunea fizica utilizatorul trebuie sa insereze cite o placa de interfata in statia de lucru si in server, si sa lege cele doua interfete printr-un mediu de comuni catie adecvat.

In vederea stabilirii conexiunii logice cu reteaua utilizatorul trebuie sa faca mai multe lucruri, printre care a) sa inregis treze numele si adresa serverului in doua tabele ale statiei de lucru si b) sa solicite serverului atribuirea unui numar de conexiune (de la 1 la 100) statiei de lucru.

Aceste actiuni conduc la stabilirea unei conexiuni intre server si statia de lucru. Utilitarele LOGIN, ATTACH sau LOGOUT gestio neaza conexiunile logice, dar utilizatorul poate scrie propriile sale programe similare, folosind serviciile de conectare. Se ofera functii pentru efectuarea operatiilor de login sau logout, atasare si detasare la / de la un server; aflarea de informatii referitoare la o conexiune, etc.

Fiecare statie de lucru mentine doua tabele, tabela numelor serverilor si tabela adreselor serverelor. Cele doua tabele au cite 8 intrari; statia de lucru identifica o conexiune prin pozitia serverului respectiv in aceste tabele (un numar intre 1 si 8, numit identificator de conexiune).

La rindul lui, fiecare server are tot doua tabele, tabela conexiunilor (cuprinzind adresele statiilor de lucru conectate), si tabela parolelor (cuprinzind printre altele identificatorul de obiect al utilizatorului care a stabilit conexiunea intre statia de lucru si server). Serverul identifica o conexiune (atit statia de lucru conectata, cit si obiectul care a initiat conexiunea) prin pozitia ei in aceste tabele (un numar intre 1 si 100 numit numar de conexiune). Valoarea 100 este valabila numai pentru o7u6ut
Advanced Netware, folositi functiile de interogare a starii serverului pentru a afla valoarea reala.

Toate functiile de mai jos care nu specifica un anumit server se refera la serverul implicit curent.

Fisiere antet necesare:

nit.h niterror.h

AttachToFileServer
IIIIIIIIIIIIIIIIII
Atasaza statia de lucru la un file server. Statia de lucru trebuie sa fie deja atasata la un server in momentul apelarii acestei functii (este nevoie de acces la bindery a acelui server). In urma executiei functiei, statia de lucru primeste un numar de conexiune in tabelele serverului; numai statiile atasate unui server pot executa operatia login la acest server.

Parametri:

char * serverName numele serverului la care trebuie atasata statia de lucru (cel mult 48 de caractere, inclusiv NULul terminator).
WORD * connectionID primeste ca valoare identificatorul de cone xiune al serverului proaspat atasat (1..8).

Rezultat:

int SUCCESSFUL
ALREADY_ATTACHED_TO_SERVER
NO_FREE_CONNECTION_SLOTS
NO_MORE_SERVER_SLOTS
UNKNOWN_FILE_SERVER
SERVER_BINDERY_LOCKED
NO_RESPONSE_FROM_SERVER

DetachFromFileServer
IIIIIIIIIIIIIIIIIIII
Executa operatia logout (daca acest lucru este necesar) si apoi detaseaza statia de lucru de la serverul indicat. Prin detasare se elibereaza intrarile in tabele ocupate de aceasta conexiune; conexiunea intre statia de lucru si server este distrusa.

Parametri:

WORD connectionID identificatorul conexiunii care trebuie distrusa (un numar de la 1 la 8).

Rezultat:

int SUCCESSFUL
CONNECTION_DOES_NOT_EXIST

EnterLoginArea
IIIIIIIIIIIIII
Schimba subdirectorul din care se executa utilitarul LOGIN.
Scopul este acela de a permite statiilor de lucru fara discuri sa poata lansa sistemul de operare corespunzator. Incarcatorul din
ROM trebuie sa fie destul de inteligent pentru a putea deschide si citi fisierele care contin sistemul de operare. Aceasta functie nu este folosita curent pentru aplicatiile obisnuite.

Parametri:

char * loginSubdirectory sir de caractere continind numele subdirectorului in care se gaseste utilitarul
LOGIN; numele acestui subdirector este intot deauna relativ la SYS:LOGIN -- de exemplu, daca loginSubdirectory este "" atunci LOGIN se va executa din SYS:LOGIN; daca acest parametru este "IBM/V3.3", atunci LOGIN se va executa din SYS:LOGIN/IBM/V3.3. int numberOfLocalDrives numarul de unitati de disc locale ale statiei de lucru.

Rezultat:

int SUCCESSFUL

GetConnectionInformation
IIIIIIIIIIIIIIIIIIIIIIII
Ofera date despre obiectul inregistrat in tabelele serverului ca fiind initiatorul unei conexiuni identificate printr-un numar de conexiune (de la 1 la 100). Aceasta este functia folosita in mod standard pentru a verifica daca supervizorul (shell) este incarcat.

Parametri:

WORD connectionNumber numarul conexiunii pentru care se cer informatii (1 pina la 100). char * objectName primeste un sir de cel mult 48 de caractere reprezentind numele obiectului inregistrat ca initiator al acestei conexiuni. int * objectType va primi tipul obiectului respectiv (OT_USER,
OT_GROUP, OT_PRINT_SERVER etc.). long * objectID primeste identificatorul de obiect care identifica in mod unic initiatorul conexiu nii. Daca valoarea intoarsa este 0, inseamna ca aceasta conexiune nu este folosita. long * loginTime primeste data si ora la care obiectul respec tiv a executat functia login; formatul este: octet 0 = an, 0..99, o valoare sub 80 este in secolul XXI; octet 1 = luna, 1..12; octet 2 = zi, 1..31; octet 3 = ora, 0..23; octet 4 = minut, 0..59; octet 5 = secunda, 0..59; octet
6 = ziua din saptamina, 0..6, 0 = duminica.

Rezultat:

int SUCCESSFUL

GetConnectionNumber
IIIIIIIIIIIIIIIIIII
Intoarce numarul de conexiune care identifica statia de lucru in tabelele serverului. Acest numar este atribuit statiei odata cu atasarea acesteia la server. Numarul respectiv devine disponibil cind statia executa detasarea de la server (dar serverul incearca sa nu-l atribuie altei statii, in vederea unei eventuale reata sari a statiei initiale).

Rezultat:

int numarul de conexiune (1..100).

GetInternetAddress
IIIIIIIIIIIIIIIIII
Determina adresa pe interretea a unei statii de lucru conectate la un server.

Parametri:

WORD connectionNumber numarul de conexiune al statiei a carei adresa trebuie aflata. char * networkNumber numarul retelei in care se gaseste statia de lucru respectiva (4 octeti). char * physicalNodeAddress adresa placii de interfata a statiei respective in cadrul retelei din care aceasta face parte (6 octeti).
WORD * socketNumber numarul punctului de acces folosit de super vizor pentru comunicatia cu serverul
(utilizatorii nu au voie sa foloseasca acest punct de acces; cel mai bine este sa se foloseasca puncte de acces dinamice).

Rezultat:

int SUCCESSFUL

GetObjectConnectionNumbers
IIIIIIIIIIIIIIIIIIIIIIIIII
Determina numerele conexiunilor initiate de un acelasi obiect.

Parametri:

char * objectName numele obiectului pentru care se cere determinarea conexiunilor (cel mult 48 de caractere cu NUL cu tot). int objectType tipul acelui obiect (OT_USER, OT_GROUP etc.).
WORD * numberOfConnections primeste numarul de conexiuni initiate de acel obiect (0 la 100).
WORD * connectionList tablou ale carui elemente vor primi ca valoare numarul de conexiune al fiecarei conexiuni a obiectului indicat.
WORD maxConnections numarul maxim de intrari in connectionList.

Rezultat:

int SUCCESSFUL

GetStationAddress
IIIIIIIIIIIIIIIII
Afla adresa statiei de lucru in cadrul retelei. Pentru aflarea adresei pe interretea, folositi functia GetInternetAddress.

Parametri:

BYTE * physicalNodeAddress primeste adresa fizica a placii de interfata in cadrul retelei (6 octeti).

LoginToFileServer
IIIIIIIIIIIIIIIII
Executa operatia login pe serverul implicit.

Parametri:

char * objectName numele obiectului pentru care se executa login (cel mult 48 de caractere cu NUL cu tot). int objectType tipul obiectului (OT_USER etc.). char * objectPassword parola obiectului (cel mult 128 de caractere inclusiv NULul terminator).

Rezultat:

int SUCCESSFUL

Logout
IIIIII
Inchide toate fisierele, executa operatia logout pentru toate serverele. Statia ramine atasata la toate serverele la care era atasata. Unitatatea de disc implicita se mapeaza pe SYS:LOGIN la serverul implicit.

LogoutFromFileServer
IIIIIIIIIIIIIIIIIIII
Executa operatia logout de la un anumit server. Statia de lucru nu este detasata de la acest server. Supervizorul anuleaza toate maparile de unitati de disc care se refereau la acest server.

Parametri:

WORD connectionID identifica serverul de la care se face logout
(un numar de la 1 la 8).