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

Item Description
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.