#include <qtrc.h> int QtrcWriteText (unsigned int Coded_Level, const char *Component, const char *Subcomponent, const char *Function, const char *Text);Service Program Name: QTRCMGR
The QtrcWriteText() function writes a component trace record as text string data to an active trace collection if certain trace conditions are met.
Each call to the QtrcWriteText() function is considered a trace point. A component trace record is written to the trace collection when all the trace conditions are met for a given trace point. The trace conditions include:
Each trace point must indicate the desired trace level using the Coded_Level parameter. This trace level is compared against the active trace level that was used for the specified Component when the trace collection was started. Components are defined to the trace collection using the Start Trace (STRTRC) CL command. The Coded_Level must be one of the following values:
QTRC_LEVEL_ERROR (1) | ERROR-level trace point. A component trace record is written if the Component has an active trace level of either *ERROR, *INFO, or *VERBOSE. |
QTRC_LEVEL_INFO (2) | INFO-level trace point. A component trace record is written if the Component has an active trace level of either *INFO or *VERBOSE. |
QTRC_LEVEL_VERBOSE (3) | VERBOSE-level trace point. A component trace record is written if the Component has an active trace level of *VERBOSE. |
The trace level of the trace point.
A pointer to the null-terminated component name. The component name should be 10 characters in length or less. If more than 10 characters are specified, only the first 10 characters are used.
A pointer to the null-terminated subcomponent name. The subcomponent name should be 10 characters in length or less. If more than 10 characters are specified, only the first 10 characters are used. This parameter can be set to NULL if no subcomponent is to be defined.
A pointer to the null-terminated function name. The function name should be 512 characters in length or less. If more than 512 characters are specified, only the first 512 characters are used. This parameter can be set to NULL if no function is to be defined.
A pointer to the null-terminated text to be written as trace data. The text should be 2048 characters in length or less. If more than 2048 characters are specified, only the first 2048 characters are used.
None.
If QtrcWriteText() was not successful, the error condition returned usually indicates one of the following errors. Under some conditions, the value returned could indicate an error other than those listed here.
Error condition | Additional information |
---|---|
[EINVAL] |
The specified Coded_Level is not one of the supported trace levels. The specified Component is not a valid component name. |
[EFAULT] | |
[EUNKNOWN] |
None.
The following example uses an ERROR-level trace point to write text trace data for a component named MYCOMP. The component trace record will be written to the active trace collection if the program is called with no parameters and the STRTRC CL command was used before calling the example, specifying either TRCTYPE((MYCOMP *ERROR)), TRCTYPE((MYCOMP *INFO)), or TRCTYPE((MYCOMP *VERBOSE)).
Note: By using the code examples, you agree to the terms of the Code license and disclaimer information.
#include <qtrc.h> #include <stdio.h> #include <errno.h> int main(int argc, char *argv[]) { const char *myComp = "MYCOMP"; int rc; if (argc <= 1) { rc = QtrcWriteText(QTRC_LEVEL_ERROR, myComp, "SUBCOMP", argv[0], "At least one parm required - return EINVAL." ); if (rc != 0) { printf("QtrcWriteText() failed with error %d\n", rc); } printf("Use the ENDTRC CL command with PRTTRC(*YES) in order to\n"); printf("see the component trace records that were written to the\n"); printf("trace collection.\n"); return EINVAL; } return 0; }Example Output:
Use the ENDTRC CL command with PRTTRC(*YES) in order to see the component trace records that were written to the trace collection.
[ Back to top | Problem Management APIs | APIs by category ]