src_err_msg_r Subroutine

AIX Version 4.3 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.