Diagnostics Record Format

The format of the Diagnostics record is shown below. The first structure definition is an Alert information record, which includes details of a 3270 NetView user alert; the second is the Diagnostics record, which includes a number of Alert information records.

typedef struct tedalert {
    UCHAR    dalrtnam[53];
    UCHAR    daparam1[33];
    UCHAR    daparam2[33];
    UCHAR    daparam3[33];
} TEDALERT;
 

Members

dalrtnam[53]

Description of the alert number.

daparam1[33]

Description of parameter 1.

daparam2[33]

Description of parameter 2.

daparam3[33]

Description of parameter 3.

typedef struct tediagns {
    USHORT   dilen;
    USHORT   ditype;
    UCHAR    dinetmgt[9];
    USHORT   disrtmco;
    USHORT   disrtmub;
    USHORT   diwruldr;
    USHORT   dirtmth1;
    USHORT   dirtmth2;
    USHORT   dirtmth3;
    USHORT   dirtmth4;
    TEDALERT dialerts[20];
    UCHAR    diaudit[128];
    UCHAR    dierror[128];
    USHORT   diaudlev;
    UCHAR    dipad[16];
} TEDIAGNS;
 

Members

dilen

Length of record.

ditype

Type of record.

dinetmgt[9]

Network management connection name.

disrtmco

Send RTM data at counter overflow.

disrtmub

Send RTM data at UNBIND.

diwruldr

RTM timers run until:

dirtmth1

RTM threshold #1.

dirtmth2

RTM threshold #2.

dirtmth3

RTM threshold #3.

dirtmth4

RTM threshold #4.

dialerts[20]

Alert description records.

diaudit[128]

Audit log file name.

dierror[128]

Error log file name.

diaudlev

Default audit level.

dipad[16]

Sixteen bytes of padding.

The following paragraphs explain the meaning of each field in the structures that is relevant to the application and indicate how the application should use it. Fields that are not included in the list below are used by other Microsoft® SNA Server components and need not concern the application; in particular, the network management connection name and the times at which RTM data is sent to the host are handled by the local node on behalf of the application.

Note that the application should determine whether the user is permitted to send NetView user alerts and/or view RTM data (see 3270 User Record Format); it should not display the appropriate information, as described below, if the user does not have permission to use it. The host can also override whether the application is permitted to send and/or to display RTM data (see RTM Parameters for more information).

For more information on how the application uses the RTM parameters, see RTM Parameters, Response Time Monitor Data, and Status-RTM.

Members

dalrtnam

The description (up to 52 characters) of the alert corresponding to a particular alert number. The application should display this information to help the user determine which alert to send.

daparam1

The descriptions (each up to 32 characters) of up to three parameters.

daparam2

Required for the alert; depending on the specific alert.

daparam3

One or more of these descriptions can be blank, indicating that the parameter is not used. For each of these descriptions that is not blank, the application should display this string to prompt the user for the appropriate parameter.

diwruldr

The definition by which response times are to be measured. The application should measure the response time from the time the user presses ENTER or an AID key to send data to the host, until one of the following events as defined by this field:

CERTWRIT (0)

The first host data reaches the 3270 display.

CERTUNLK (1)

The host unlocks the user's keyboard.

CERTDIRE (2)

The host gives the application direction so that the user can send further data.

Note that the host can override these definitions; see RTM Parameters for more information.

dirtmth1, dirtmth2, dirtmth3, dirtmth4

The thresholds that define the bands into which response times are to be classified. Note that the host can override these definitions; see RTM Parameters for more information.

dialerts

Up to 20 alert records that define the alerts SNA Server users can send to a host. There are always 20 records, but some of these can be blank, indicating that they are not used; the application should display the descriptions of any nonblank alerts together with the alert number (from 1 to 20) defined by the position of the alert record in this array.