sepdcrec

Die sepdcrec-Funktion ruft Konfigurationsinformationen ab. Die Anwendung ruft diese Funktion auf, um die Konfigurationsinformationen 3270 für den Namen abzurufen, mit dem sich der Benutzer beim Netzwerkbetriebssystem angemeldet hat. Der Aufruf registriert auch diesen Benutzernamen in der Diensttabelle.

Syntax

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

Parameter

pBuffer
Zeiger auf einen von der Anwendung bereitgestellten Puffer, in dem Konfigurationsinformationen zurückgegeben werden.

length
Größe des bereitgestellten Puffers.

Numbytes
Wird von Host Integration Server verwendet, um die Anzahl der Bytes der im Puffer zurückgegebenen Informationen zurückzugeben.

Rückgabewert

NO_ERROR (0)
OK.

NOCSSRVR (1)
Kein Konfigurationsdateiserver verfügbar.

NODGNREC (2)
Kein Diagnose Datensatz in der Konfigurationsdatei gefunden.

NOUSRREC (3)
Kein Benutzerdatensatz in der Konfigurationsdatei für diesen Benutzer gefunden.

BUF2SMAL (4)
Der bereitgestellte Puffer war zu klein.

NONOS (5)
Das Netzwerkbetriebssystem wurde nicht gestartet.

NOTLOGON (6)
Der Benutzer ist nicht beim Netzwerkbetriebssystem angemeldet.

READERR (7)
Fehler beim Lesen aus der Konfigurationsdatei.

NONAP (8)
Das Netzwerkzugriffsprogramm (Network Access Program, NAP) wurde nicht gestartet.

MAXAPP (9)
Nur Windows: Die maximale Anzahl gleichzeitiger Anwendungen wurde überschritten.

ERROR_SERVER (14)
Fehler am Serverende des Remoteprozeduraufrufs (RPC).

ERROR_LOCAL_FAILURE (15)
Fehler am lokalen Ende des RPC.

Hinweise

Die sbpuinit-Funktion sollte immer vor allen anderen DL-BASE- oder DMOD-Einstiegspunkten (Dynamic Access Module) mit Ausnahme von SNAGetVersion aufgerufen werden. Bei neuen Emulatoren sollte sepdcrec nach sbpuinit aufgerufen werden. (Aufgrund der Reihenfolge der in älteren Emulatoren verwendeten Aufrufe wird ein Aufruf von sepdcrec vor sbpuinit weiterhin unterstützt, aber diese Reihenfolge wird nicht empfohlen.)

Bei erfolgreicher Rückgabe enthält der Puffer Zeiger auf den entsprechenden 3270-Benutzerdatensatz und den Diagnose Datensatz, gefolgt von den Datensätzen selbst. Dabei wird das folgende Format verwendet:

TECWRKUS *pUserRecord,   
TEDIAGNS *pDiagRecord   
);  

(UserRecord – Variable Length)

(DiagRecord)

Auf die beiden Datensätze sollte mithilfe der angegebenen Zeiger zugegriffen werden.

Weitere Informationen zum Format dieser Datensätze und zur Verwendung der Konfigurationsdateiinformationen finden Sie unter Konfigurationsinformationen .

Wenn für diesen Benutzer in der Konfigurationsdatei kein Benutzerdatensatz von 3270 vorhanden ist oder kein Diagnose Datensatz in der Konfigurationsdatei gefunden wird (interner Fehler), sollte die Anwendung beenden und dem Benutzer die Verwendung der 3270-Emulation nicht erlauben. Die Host Integration Server-Fehlerprotokollmeldungen COM0438 und COM0437 können verwendet werden, um diese Fehler zu melden.

Wenn der angegebene Puffer für die zurückgegebenen Informationen zu klein ist, ist der Inhalt des Puffers undefiniert und sollte nicht untersucht werden, aber der numbytes-Parameter enthält die Gesamtzahl der verfügbaren Informationen (d. a. die Größe der beiden Zeiger plus die beiden Konfigurationsdatensätze). Die Anwendung sollte mit einem Puffer von mindestens dieser Größe wiederholen.