SNAGetSystemInfo

The SNALink calls the SNAGetSystemInfo function to obtain information about SNA Server and the network operating system.

INTEGER SNAGetSystemInfo(
    struct cs_info *pCSInfo
);

Parameters

pCSInfo

Pointer to buffer supplied by application, containing a data structure in which system information is returned. The application must set the length field in this data structure (see Remarks); the other fields should be set to nulls or blanks.

struct cs_info {
    unsigned short  length;
    unsigned char   major_ver;
    unsigned char   minor_ver;
    unsigned char   config_share[80];
    unsigned short  nos;
};
 

Members

length

Length of the data structure supplied by the application.

major_ver

Major version number:

1 for Comm Server 1.1

2 for SNA Server 2.0/2.1

3 for SNA Server 3.0

4 for SNA Server 4.0

minor_ver

Minor version number (decimal):

10 for Comm Server 1.1

00 for SNA Server 2.0

20 for SNA Server 2.1

00 for SNA Server 3.0

00 for SNA Server 4.0

config_share[80]

The name of the share point of the current configuration file (\\server\share\, for example). This path name must be a null-terminated string.

nos

Transport protocol in use:

bit 0: LAN Manager/LAN Server (named pipes)

bit 1: NetWare (IPX/SPX)

bit 2: AppleTalk

bit 3: Banyan VINES (VINES IP)

bit 4: TCP/IP

Return Values

NO_ERROR

OK

ERNOCFGSVR

No configuration file server available.

ERMOREDATA

Supplied buffer was too small.

Remarks

The application must set the length parameter to the length of the cs_info structure (86 bytes in the current version). Any other value will be rejected. This parameter is used to ensure compatibility with future versions; an application supplying this length will always obtain the information shown here, but in future versions it may be possible to specify larger values and obtain further information.

On successful return, the cs_info data structure contains the version number of SNA Server (SNA Server 2.x, SNA Server 3.0, or Comm Server 1.x, for older versions), the path to the current configuration file, and the network operating system over which SNA Server is running.

If there is no configuration file server available, only the version number fields are valid; the other fields should not be checked.