sepdcrec

La fonction sepdcrec obtient des informations de configuration. L’application appelle cette fonction pour obtenir les informations de configuration 3270 pour le nom avec lequel l’utilisateur s’est connecté au système d’exploitation réseau. L’appel inscrit également ce nom d’utilisateur dans la table de service.

Syntaxe

  
USHORT sepdcrec(   
UCHAR *pBuffer,  
USHORT length,  
USHORT *numbytes  
);  

Paramètres

pBuffer
Pointeur vers une mémoire tampon fournie par l’application, dans laquelle les informations de configuration sont retournées.

length
Taille de la mémoire tampon fournie.

numoctets
Utilisé par Host Integration Server pour retourner le nombre d’octets d’informations retournés dans la mémoire tampon.

Valeur renvoyée

NO_ERROR (0)
OK.

NOCSSRVR (1)
Aucun serveur de fichiers de configuration disponible.

NODGNREC (2)
Aucun enregistrement diagnostics trouvé dans le fichier de configuration.

NOUSRREC (3)
Aucun enregistrement utilisateur trouvé dans le fichier de configuration pour cet utilisateur.

BUF2SMAL (4)
La mémoire tampon fournie était trop petite.

NONOS (5)
Le système d’exploitation réseau n’est pas démarré.

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

READERR (7)
Échec de la lecture à partir du fichier de configuration.

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

MAXAPP (9)
Windows uniquement : nombre maximal d’applications simultanées dépassé.

ERROR_SERVER (14)
Erreur à l’extrémité du serveur de l’appel de procédure distante (RPC).

ERROR_LOCAL_FAILURE (15)
Erreur à l’extrémité locale du RPC.

Remarques

La fonction sbpuinit doit toujours être appelée avant tout autre point d’entrée DL-BASE ou DMOD (Dynamic Access Module) à 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é.)

En cas de retour réussi, la mémoire tampon contient des pointeurs vers l’enregistrement utilisateur 3270 approprié et l’enregistrement diagnostics, suivis des enregistrements eux-mêmes. Il est mis en forme comme suit :

TECWRKUS *pUserRecord,   
TEDIAGNS *pDiagRecord   
);  

(UserRecord : longueur variable)

(DiagRecord)

Les deux enregistrements doivent être accessibles à l’aide des pointeurs fournis.

Consultez Informations de configuration pour plus d’informations sur le format de ces enregistrements et sur la façon dont l’application utilise les informations du fichier de configuration.

S’il n’existe pas d’enregistrement utilisateur 3270 pour cet utilisateur dans le fichier de configuration, ou si aucun enregistrement diagnostics n’est trouvé dans le fichier de configuration (erreur interne), l’application doit se terminer et ne pas autoriser l’utilisateur à utiliser l’émulation 3270. Les messages du journal des erreurs Host Integration Server COM0438 et COM0437 peuvent être utilisés pour signaler ces échecs.

Si la mémoire tampon fournie est trop petite pour les informations retournées, le contenu de la mémoire tampon n’est pas défini et ne doit pas être examiné, mais le paramètre numbytes contient le nombre total d’octets d’informations disponibles (autrement dit, la taille des deux pointeurs plus les deux enregistrements de configuration). L’application doit réessayer avec une mémoire tampon d’au moins cette taille.