The SNA Server DISPLAY verb is compatible with the IBM ES for OS/2 version 1.0 DISPLAY verb. However, since IBM ES for OS/2 version 1.0 is a single-server system and SNA Server is a multiple-server client/server system, DISPLAY has been extended to allow the user to target the SNA server by which the DISPLAY verb will be processed.
To direct a DISPLAY verb at a particular SNA server, place the ASCII string CSEXTNID, followed by the computer name of the SNA server, at the start of the buffer pointed to by buffer_ptr. The computer name is a 32-byte ASCII string and can be zero or padded with spaces.
Because the local node identifier is configured on a per-node basis for IBM ES for OS/2 version 1.0 and can be different for each connection in SNA Server, SNA Server also allows you to specify an optional connection name. This is an 8-byte ASCII string, which is placed after the 32-byte computer name. Again, the string can be zero or padded with spaces. The following example illustrates the CSEXTNID extension:
csextnid computername 00000000000000000000 name
If you do not specify a connection name, SNA Server returns information about the first connection configured for the SNA Server system.
If you do not specify a computer name, SNA Server will randomly choose a default DISPLAY computer and connection, unless a specific default DISPLAY connection has been configured in SNA Server Manager. DISPLAY will behave as if you specified the connection and the computer name of the server that owns the verb. For additional information about using default LUs, see the Microsoft SNA Server Administration Guide.
SNA Server also allows you to use DISPLAY to return a list of active servers. To do so, place the string CSEXTNIDCSLISTND in the DISPLAY buffer and set the supplied parameters sna_global_info, lu62_info, and so on, to AP_NO. The information is returned in the DISPLAY buffer in the following format:
#activenodes - 2 bytes
node_name 1 - 8 bytes
box_name 1 - 32 bytes
.
node_name m
box_name m
In the current version of SNA Server, node_name is always SNASERVR and box_name is the computer name of the server.