Elements with the suffix _r are NCBs issued by the redirector as part of the typical process of maintaining remote network connections.
The function in the Statistics category retrieves the operating statistics for clients and servers.
|
Function |
Description |
|
Retrieves a client’s or server’s operating statistics. |
Advanced Server accumulates a set of operating statistics for clients and servers from the time the network software is installed.
NetStatisticsGet2 retrieves these statistics.
NetStatisticsGet2 returns a stat_workstation_0 data structure when workstation statistics are requested; it returns a stat_server_0 data structure when server statistics are requested.
The stat_workstation_0 data structure has the following format:
struct stat_workstation_0 {
unsigned long stw0_start;
unsigned long stw0_numNCB_r;
unsigned long stw0_numNCB_s;
unsigned long stw0_numNCB_a;
unsigned long stw0_fiNCB_r;
unsigned long stw0_fiNCB_s;
unsigned long stw0_fiNCB_a;
unsigned long stw0_fcNCB_r;
unsigned long stw0_fcNCB_s;
unsigned long stw0_fcNCB_a;
unsigned long stw0_sesstart;
unsigned long stw0_sessfailcon;
unsigned long stw0_sessbroke;
unsigned long stw0_uses;
unsigned long stw0_usefail;
unsigned long stw0_autorec;
unsigned long stw0_bytessent_r_hi;
unsigned long stw0_bytessent_r_lo;
unsigned long stw0_bytesrcvd_r_hi;
unsigned long stw0_bytesrcvd_r_lo;
unsigned long stw0_bytessent_s_hi;
unsigned long stw0_bytessent_s_lo;
unsigned long stw0_bytesrcvd_s_hi;
unsigned long stw0_bytesrcvd_s_lo;
unsigned long stw0_bytessent_a_hi;
unsigned long stw0_bytessent_a_lo;
unsigned long stw0_bytesrcvd_a_hi;
unsigned long stw0_bytesrcvd_a_lo;
unsigned long stw0_reqbufneed;
unsigned long stw0_bigbufneed;
};
Within this structure, the following parameters are defined:
stw0_start specifies the time statistics collection started. This element also indicates when the statistics were last cleared. The value is stored as the number of seconds elapsed since 00:00:00, January 1, 1970. To calculate the length of time that statistics have been collected, subtract this value from the present time.
stw0_numNCB these three elements indicate the total number of network control blocks (NCBs) issued from each source (the counts include failed NCBs). To calculate the total number of successful NCBs, subtract the number of failed NCBs from stw0_numNCB.
These numbers are held in the stw0_fiNCB and stw0_fcNCB elements, and are explained in the stw0_fiNCB and stw0_fcNCB descriptions following this list.
stw0_numNCB_r specifies the total number of NCBs issued by the redirector.
stw0_numNCB_s specifies the total number of NCBs issued by the server.
stw0_numNCB_a specifies the total number of NCBs issued by applications.
stw0_fiNCB these three elements indicate the number of NCBs that failed for any reason when they were issued. These NCBs are included in the "total issued" count specified by stw0_numNCB.
stw0_fiNCB_r specifies the number of NCBs that failed when issued by the redirector.
stw0_fiNCB_s specifies the number of NCBs that failed when issued by the server.
stw0_fiNCB_a specifies the number of NCBs that failed when issued by applications.
stw0_fcNCB these three elements indicate the number of NCBs that failed after issue, at or before completion. These NCBs are also included in the "total issued" count specified by stw0_numNCB .
stw0_fcNCB_r specifies the number of NCBs that were issued by the redirector and that failed before completion.
stw0_fcNCB_s specifies the number of NCBs that were issued by the server and that failed before completion.
stw0_fcNCB_a specifies the number of NCBs that were issued by applications and that failed before completion.
stw0_sesstart specifies the number of workstation sessions started.
stw0_sessfailcon specifies the number of workstation sessions that failed to connect, not counting those that failed due to "name not found."
stw0_sessbroke specifies the number of workstation sessions that failed after the session was established.
stw0_uses specifies the number of workstation uses.
stw0_usefail specifies the number of workstation use failures. This is a count of the times the tree connections failed, when a server is found but the resources are not found.
stw0_autorec specifies the number of workstation auto connections.
The following 12 elements form six quad-words that contain very large counters. (A quad-word is a data area twice as large as a double word.) The high double word (dword) of each is the value divided by 2; the low dword is the value module of 2. The counter value equals (high dword * 2 + (low dword).
These elements count total bytes in all NCBs sent and received for all categories.
Note the following for all the NCB-related and byte-count counters:
Elements with the suffix _r are NCBs issued by the redirector as part of the typical process of maintaining remote network connections.
Elements with the suffix _s are server-related, sent by the redirector on behalf of the server to maintain shared resource connections.
Elements with the suffix _a are application-generated NCBs.
stw0_bytessent_r_hi specifies the number of workstation bytes sent to the network (high dword).
stw0_bytessent_r_lo specifies the number of workstation bytes sent to the network (low dword).
stw0_bytesrcvd_r_hi specifies the number of workstation bytes received from the network (high dword).
stw0_bytesrcvd_r_lo specifies the number of workstation bytes received from the network (low dword).
stw0_bytessent_s_hi specifies the number of server bytes sent to the network (high dword).
stw0_bytessent_s_lo specifies the number of server bytes sent to the network (low dword).
stw0_bytesrcvd_s_hi specifies the number of workstation bytes received from the network (high dword).
stw0_bytesrcvd_s_lo specifies the number of workstation bytes received from the network (low dword).
stw0_bytessent_a_hi specifies the number of application bytes sent to the network (high dword).
stw0_bytessent_a_lo specifies the number of application bytes sent to the network (low dword).
stw0_bytesrcvd_a_hi specifies the number of application bytes received from the network (high dword).
stw0_bytesrcvd_a_lo specifies the number of application bytes received from the network (low dword).
stw0_reqbufneed specifies the number of times the workstation required a request buffer but failed to allocate one. This element indicates that the workstation parameters may need adjustment.
stw0_bigbufneed specifies the number of times the workstation required a big buffer but failed to allocate one. This element indicates that the workstation parameters may need adjustment.
Note
A value of STATS_NO_VALUE for any element means that information is not available. A value of STATS_OVERFLOW means that the element has overflowed. The netstats.h header file defines these constants.
The stat_server_0 data structure has the following format:
struct stat_server_0 {
unsigned long sts0_start;
unsigned long sts0_fopens;
unsigned long sts0_devopens;
unsigned long sts0_jobsqueued;
unsigned long sts0_sopens;
unsigned long sts0_stimedout;
unsigned long sts0_serrorout;
unsigned long sts0_pwerrors;
unsigned long sts0_permerrors;
unsigned long sts0_syserrors;
unsigned long sts0_bytessent_low;
unsigned long sts0_bytessent_high;
unsigned long sts0_bytesrcvd_low;
unsigned long sts0_bytesrcvd_high;
unsigned long sts0_avresponse;
unsigned long sts0_reqbufneed;
unsigned long sts0_bigbufneed;
};
Within this structure, the following parameters are defined:
sts0_start specifies the time statistics collection started. This element also indicates when the statistics were last cleared. The value is stored as the number of seconds elapsed since 00:00:00, January 1, 1970. To calculate the length of time that statistics have been collected, subtract this value from the present time.
sts0_fopens specifies the number of server file opens. This includes opens of named pipes.
sts0_devopens specifies the number of server device opens.
sts0_jobsqueued specifies the number of server print jobs spooled.
sts0_sopens specifies the number of times the server session started.
sts0_stimedout specifies the number of times the server session automatically disconnected.
sts0_serrorout specifies the number of times the server sessions failed with an error.
sts0_pwerrors specifies the number of server password violations.
sts0_permerrors specifies the number of server access permission errors.
sts0_syserrors specifies the number of server system errors. The following four elements form two quad-words, which contain very large counters. (A quad-word is a data area twice as large as a double word.) The high dword of each is the value divided by 2 ; the low dword is the value module of 2 . The counter value equals (high dword * 2 + (low dword).
sts0_bytessent_low specifies the number of server bytes sent to the network (low dword).
sts0_bytessent_high specifies the number of server bytes sent to the network (high dword).
sts0_bytesrcvd_low specifies the number of server bytes received from the network (low dword).
sts0_bytesrcvd_high specifies the number of server bytes received from the network (high dword).
sts0_avresponse specifies the average server response time (in milliseconds).
sts0_reqbufneed specifies the number of times the server required a request buffer but failed to allocate one. This value indicates that the server parameters may need adjustment.
sts0_bigbufneed specifies the number of times the server required a big buffer but failed to allocate one. This value indicates that the server parameters may need adjustment.
A value of STATS_NO_VALUE for any element means that information is not available. A value of STATS_OVERFLOW means that the element has overflowed. The netstats.h header file defines these constants.
