sepdcrec

The sepdcrec function gets configuration information. The application calls this function to obtain the 3270 configuration information for the name with which the user logged on to the network operating system. The call also registers this user name in the service table.

Win32

USHORT sepdcrec(

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

MS-DOS, Windows Version 3.x, and OS/2

USHORT FAR sepdcrec(

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

Parameters

pBuffer: Pointer to a buffer supplied by the application, in which configuration information is returned.
length: Size of the supplied buffer.
numbytes: Used by SNA Server to return the number of bytes of information returned in the buffer.

Return Values

NO_ERROR (0): OK.
NOCSSRVR (1): No configuration file server available.
NODGNREC (2): No diagnostics record found in configuration file.
NOUSRREC (3): No user record found in configuration file for this user.
BUF2SMAL (4): Supplied buffer was too small.
NONOS (5): Network operating system is not started.
NOTLOGON (6): User is not logged on to the network operating system.
READERR (7): Failed to read from configuration file.
NONAP (8): The NAP is not started.
MAXAPP (9): Windows only:
Maximum number of concurrent applications exceeded.
ERROR_SERVER (14): Error on the server end of the RPC.
ERROR_LOCAL_FAILURE (15): Error on the local end of the RPC.

Remarks

The sbpuinit function should always be called before any other DL-BASE/DMOD entry points except SNAGetVersion. For new emulators, sepdcrec should be called after sbpuinit. (Because of the order of calls used in older emulators, a call to sepdcrec before sbpuinit is still supported, but this order is not recommended.)

On successful return, the buffer contains pointers to the appropriate 3270 user record and the diagnostics record, followed by the records themselves. It is formatted as follows:

Win32

TECWRKUS *pUserRecord,
TEDIAGNS *pDiagRecord
);

(UserRecord—variable length)

(DiagRecord)

MS-DOS, Windows Version 3.x, and OS/2

TECWRKUS FAR *pUserRecord,
TEDIAGNS FAR *pDiagRecord
);

(UserRecord—variable length)

(DiagRecord)

The two records should be accessed using the supplied pointers.

See Configuration Information for details of the format of these records and of how the application uses the configuration file information.

If there is no 3270 user record for this user in the configuration file, or if no diagnostics record is found in the configuration file (an internal error), the application should terminate and not allow the user to use 3270 emulation. The SNA Server error log messages COM0438 and COM0437 can be used to report these failures.

If the supplied buffer is too small for the returned information, the contents of the buffer are undefined and should not be examined, but the numbytes parameter will contain the total number of bytes of information available (that is, the size of the two pointers plus the two configuration records). The application should retry with a buffer of at least this size.