srcstattxt_r Subroutine

AIX Version 4.3 Base Operating System and Extensions Technical Reference, Volume 2

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

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.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

The src_err_msg_r, srcsbuf_r, srcsrqt_r, srcrrqs_r, and srcstat_r subroutines.

List of SRC Subroutines in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.

Programming Subsystem Communication with the SRC in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.

System Resource Controller (SRC) Overview for Programmers in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.