tpm_traceelemget

Up a level

tpm_traceelemget

Network Tracing Functions

Lists information about a tracing model element.

struct resbuf

*tpm_traceelemget(

ade_id trace_id,

ade_id elem_id);

Returns an information list in a resbuf or NULL

The contents of a resbuf for a node element could be as follows.

The contents of a resbuf for a link element could be as follows.

The list format depends on the element type. For each a-list, the first component is an integer code for the information type, and the second is the information.

The following sample opens a network trace topology for read using tpm_acopen(). A tracing model is allocated using tpm_tracealloc() with the topology id returned by tpm_acopen(). A trace element id is obtained using tpm_elemid(), which is used in the call to tpm_traceelemget(). A resbuf is populated with information associated with the specified element, a portion of which is then displayed. The resbuf is then released as required.

char* pszTopoName = "BestRouteTopology1";
int topoWriteAccess = 0;
ade_id topoId = tpm_acopen(pszTopoName, topoWriteAccess);
ade_id traceId = tpm_tracealloc(topoId, NULL, NULL, NULL, NULL);
int elementType = 2;
long elementIndex = 5;
ade_id elementID = tpm_elemid(topoId, elementType, elementIndex);
struct resbuf* pTraceElementInfoRb = tpm_traceelemget(traceId, elementID);
if (NULL != pTraceElementInfoRb){
    struct resbuf* rb = pTraceElementInfoRb;
    while(NULL != rb) {
        if (rb->restype == RTSHORT) {
            const int nTraceVal = rb->resval.rint;
            switch(nTraceVal)
            {
                case 1:
                    acutPrintf(
                        "\nThe topology id of the starting node is: %0.lf"
                        , rb->rbnext->resval.rreal);
                    break;
                case 70:
                    acutPrintf(
                        "\nThe element direction is: %d"
                        , rb->rbnext->resval.rint);
                    break;
                    default:
                        break;
            }
        }
        rb = rb->rbnext;
    }
}
else {
    acutPrintf(
        "\nThe specified element was not found.");
}
acutRelRb(pTraceElementInfoRb);
tpm_acclose(topoId);