[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Technical Reference: Base Operating System and Extensions , 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 (src_err_msg_r Subroutine), srcsbuf_r (srcsbuf_r Subroutine), srcsrqt_r (srcsrqt_r Subroutine), srcrrqs_r (srcrrqs_r Subroutine), and srcstat_r (srcstat_r Subroutine) subroutines.

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

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

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


[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]