sepdcrec

La funzione sepdcrec ottiene informazioni di configurazione. L'applicazione chiama questa funzione per ottenere le informazioni di configurazione 3270 per il nome con cui l'utente ha eseguito l'accesso al sistema operativo di rete. La chiamata registra anche questo nome utente nella tabella del servizio.

Sintassi

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

Parametri

pBuffer
Puntatore a un buffer fornito dall'applicazione, in cui vengono restituite informazioni di configurazione.

length
Dimensioni del buffer fornito.

Numbytes
Usato da Host Integration Server per restituire il numero di byte di informazioni restituite nel buffer.

Valore restituito

NO_ERROR (0)
OK.

NOCSSRVR (1)
Nessun file server di configurazione disponibile.

NODGNREC (2)
Nessun record di diagnostica trovato nel file di configurazione.

NOUSRREC (3)
Nessun record utente trovato nel file di configurazione per questo utente.

BUF2SMAL (4)
Il buffer fornito era troppo piccolo.

NONOS (5)
Il sistema operativo di rete non viene avviato.

NOTLOGON (6)
L'utente non è connesso al sistema operativo di rete.

READERR (7)
Impossibile leggere dal file di configurazione.

NONAP (8)
Il programma di accesso alla rete (NAP) non viene avviato.

MAXAPP (9)
Solo Windows: numero massimo di applicazioni simultanee superate.

ERROR_SERVER (14)
Errore nella fine del server della chiamata di routine remota (RPC).

ERROR_LOCAL_FAILURE (15)
Errore alla fine locale di RPC.

Commenti

La funzione sbpuinit deve essere sempre chiamata prima di qualsiasi altro punto di ingresso DL-BASE o Dynamic Access Module (DMOD) tranne SNAGetVersion. Per i nuovi emulatori, sepdcrec deve essere chiamato dopo sbpuinit. A causa dell'ordine di chiamate usate negli emulatori meno recenti, una chiamata a sepdcrec prima che sbpuinit sia ancora supportata, ma questo ordine non è consigliato.

Al termine della restituzione, il buffer contiene puntatori al record utente appropriato 3270 e al record di diagnostica, seguito dai record stessi. Il token è formattato come illustrato di seguito:

TECWRKUS *pUserRecord,   
TEDIAGNS *pDiagRecord   
);  

(UserRecord- lunghezza variabile)

(DiagRecord)

I due record devono essere accessibili usando i puntatori forniti.

Per informazioni dettagliate sul formato di questi record e sul modo in cui l'applicazione usa le informazioni sul file di configurazione, vedere Informazioni sulla configurazione .

Se non è presente alcun record utente 3270 per questo utente nel file di configurazione o se non viene trovato alcun record di diagnostica nel file di configurazione (errore interno), l'applicazione deve terminare e non consentire all'utente di usare 3270 emulazione. I messaggi di log degli errori di Host Integration Server COM0438 e COM0437 possono essere usati per segnalare questi errori.

Se il buffer fornito è troppo piccolo per le informazioni restituite, il contenuto del buffer non è definito e non deve essere esaminato, ma il parametro numbyte conterrà il numero totale di byte di informazioni disponibili, ovvero le dimensioni dei due puntatori e i due record di configurazione. L'applicazione deve riprovare con un buffer di almeno questa dimensione.