SNA Global Information

SNA global information is defined or returned as described here.

Defined by IBM ES for OS/2 Version 1.0

Information on SNA global information is provided in the sna_global_info_sect structure as defined below.

typedef struct sna_global_info_sect {
    unsigned char version;
    unsigned char release;
    unsigned char net_name[8];
    unsigned char pu_name[8];
    unsigned char node_id[4];
    type_product_set_id product_set_id;
    unsigned char alias_cp_name[8];
    unsigned char node_type;
    unsigned char cp_nau_addr;
    unsigned char corr_serv_disk;
    unsigned char reserved;
    unsigned char appc_version;
    unsigned char appc_release;
    unsigned char appc_fixlevel;
} SNA_GLOBAL_INFO_SECT;

Members

version: Communications Manager Extended Edition version number.
release: Communications Manager Extended Edition release number.
net_name: Network name, first part of fully qualified control program (CP) name, in EBCDIC (type A).
pu_name: PU name, second part of fully qualified CP name, in EBCDIC (type A).
node_id: Four-byte hexadecimal exchange identifier.
product_set_id: Computer product data.
alias_cp_name: Node name (local name for CP) in ASCII.
node_type: AP_NN, AP_EN, or AP_LEN.
cp_nau_addr: CP NAU address where 0 means not used (an independent LU). Other legal values are 1 to 254.
corr_serv_disk: Last four digits of corrective service disk number.
appc_version: APPC version number.
appc_release: APPC release number.
appc_fixlevel: APPC fixlevel.

Returned by SNA Server

Information on SNA global information is provided in the sna_global_info_sect structure as defined below.

typedef struct sna_global_info_sect {
    unsigned char version;
    unsigned char release;
    unsigned char net_name[8];
    unsigned char pu_name[8];
    unsigned char node_id[4];
    type_product_set_id product_set_id;
    unsigned char alias_cp_name[8];
    unsigned char node_type;
    unsigned char cp_nau_addr;
    unsigned char corr_serv_disk;
    unsigned char reserved;
    unsigned char appc_version;
    unsigned char appc_release;
    unsigned char appc_fixlevel;
} SNA_GLOBAL_INFO_SECT;

Members

version: Major operating system (OS) version number.
release: Minor OS version number.
net_name: Node network name in EBCDIC (type A).
pu_name: PU name in EBCDIC (type A) associated with connection.
node_id: Node identifier to send.
product_set_id: Set to EBCDIC zeros.
alias_cp_name: Node name, local name for the control program (CP), in ASCII.
node_type: Set to AP_LEN.
cp_nau_addr: CP NAU address where 0 means not used (an independent LU). Other legal values are 1 to 254.
corr_serv_disk: Reserved field set to zero.
appc_version: SNA Server major version number.
appc_release: SNA Server minor version number.
appc_fixlevel: SNA Server patchlevel.

Remarks

SNA Server returns version and release as the major and minor OS version numbers from GetVersion (for Windows NT, Windows 95, or Windows version 3.x systems) or GetDosVersion (for OS/2).

Because SNA Server has no information on the computer type, serial number, and manufacturing, product_set_id is set to EBCDIC zeros.

SNA Server does not support APPN node types, so the node type is returned as 1 (an AP_LEN node), and not 2 or 3 (AP_NN or AP_EN nodes), as defined by IBM ES for OS/2 version 1.0.