srcstattxt_r Subroutine
Purpose
Gets the status text representation for an SRC status code.
Library
System Resource Controller Library (libsrc.a)
Syntax
#include <spc.h>
char *srcstattxt_r (StatusCode, Text)
short StatusCode;
char *Text;Description
The srcstattxt_r subroutine, given an SRC status code, gets the text representation and returns it in a caller-supplied buffer. This routine is threadsafe and reentrant.
Parameters
| Item | Description |
|---|---|
| StatusCode | Specifies an SRC status code to be translated into meaningful text. |
| Text | Points to a caller-supplied buffer where the text will be returned. If the length of the text is unknown, the maximum text length can be used when allocating the buffer. The maximum text length is SRC_STAT_MAX in /usr/include/spc.h (64 bytes). |
Return Values
Upon successful completion, the srcstattxt_r subroutine returns the address of the caller-supplied buffer. Otherwise, no text is returned and the subroutine returns NULL.