sbpuinit

  • Article

La fonction sbpuinit initialise DL-BASE.

Syntaxe

  
USHORT sbpuinit(   
HANDLE *sema4ptr,   
USHORT proctype,   
USHORT servtype,   
UCHAR *uname   
);

Paramètres

sema4ptr
Sémaphore, créé par le module d’accès dynamique (DMOD), effacé par DMOD lorsqu’un message est disponible. Cette adresse est destinée à une utilisation interne par Host Integration Server. L’application ne doit pas tenter de référencer l’adresse par la suite.

proctype
Type de processus : CLIENT-2.

servtype
Type de service/client : CES3270 à 2.

uname
Pointeur vers une mémoire tampon de caractères d’au moins 21 caractères ; le nom d’utilisateur LAN Manager, ou tout autre nom d’identification approprié pour le système d’exploitation réseau, est retourné à l’application dans cette mémoire tampon. L’application n’a pas besoin d’utiliser ce paramètre, mais peut l’utiliser pour l’affichage ou la journalisation.

Valeur renvoyée

NO_ERROR
Initialisation réussie.

Toute autre valeur de retour indique que l’initialisation a échoué. Il s’agit généralement d’un code de retour de système d’exploitation. Les valeurs suivantes sont également utilisées :

DMLTABF (555)
La table L est pleine.

DMMNWGI (562)
Impossible d’obtenir les informations du système d’exploitation réseau.

DMDSTFL (563)
La table de service est pleine.

DMMPIPF (567)
Échec de la création d’un canal nommé.

DMCOMNM (582)
Aucun nom inscrit pour cette application.

DMCOMDUP (596)
Un service est déjà en cours d’exécution avec le même nom.

DMNOTLOG (598)
L’utilisateur n’est pas connecté au système d’exploitation réseau.

DMCFGOPN (616)
Échec de l’ouverture du fichier de configuration.

DMCFGREAD (618)
Échec de la lecture à partir du fichier de configuration.

DMNONAP (625)
Le programme d’accès réseau (NAP) n’est pas démarré.

DMMAXAPP (953)
Windows uniquement : nombre maximal d’applications simultanées dépassé.

Remarques

Le point d’entrée sbpuinit doit toujours être appelé avant tout autre point d’entrée DL-BASE ou DMOD à l’exception de SNAGetVersion. Pour les nouveaux émulateurs, sepdcrec doit être appelé après sbpuinit. (En raison de l’ordre des appels utilisés dans les anciens émulateurs, un appel à sepdcrec avant sbpuinit est toujours pris en charge, mais cet ordre n’est pas recommandé.)