src_err_msg_r Subroutine

Base Operating System and Extensions Technical Reference, Volume 2

src_err_msg_r Subroutine

Purpose

Gets the System Resource Controller (SRC) error message corresponding to the specified SRC error code.

Library

System Resource Controller (libsrc.a)

Syntax

#include <spc.h>

int src_err_msg_r (srcerrno, ErrorText) 
int srcerrno;
char **ErrorText;

Description

The src_err_msg_r subroutine returns the message corresponding to the input srcerrno value in a caller-supplied buffer. This subroutine is threadsafe and reentrant.

Parameters

srcerrno	Specifies the SRC error code.
ErrorText	Pointer to a variable containing the address of a caller-supplied buffer where the message will be returned. If the length of the message is unknown, the maximum message length can be used when allocating the buffer. The maximum message length is SRC_BUF_MAX in /usr/include/spc.h (2048 bytes).

Return Values

Upon successful completion, the src_err_msg_r subroutine returns a value of 0. Otherwise, no error message is returned and the subroutine returns a value of -1.

Implementation Specifics

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

Related Information

The srcsbuf_r, srcsrqt_r, srcrrqs_r, srcstat_r, and srcstattxt_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.