[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Base Operating System and Extensions Technical Reference, Volume 1

getssys Subroutine

Purpose

Reads a subsystem record.

Library

System Resource Controller Library (libsrc.a)

Syntax

#include <sys/srcobj.h>
#include <spc.h>
int getssys( SubsystemName, SRCSubsystem)
char *SubsystemName;
struct SRCsubsys *SRCSubsystem;

Description

The getssys subroutine reads a subsystem record associated with the specified subsystem and returns the ODM record in the SRCsubsys structure.

The SRCsubsys structure is defined in the sys/srcobj.h file.

Parameters

SRCSubsystem Points to the SRCsubsys structure.
SubsystemName Specifies the name of the subsystem to be read.

Return Values

Upon successful completion, the getssys subroutine returns a value of 0. Otherwise, it returns a value of -1 and the odmerrno variable is set to indicate the error, or an SRC error code is returned.

Error Codes

If the getssys subroutine fails, the following is returned:

SRC_NOREC Subsystem name does not exist.

Implementation Specifics

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

Files

/etc/objrepos/SRCsubsys SRC Subsystem Configuration object class.

Related Information

The addssys subroutine, delssys subroutine, getsubsvr subroutine.

Defining Your Subsystem to the SRC, List of SRC Subroutines, System Resource Controller (SRC) Overview for Programmers in AIX Version 4.3 General Programming Concepts: Writing and Debugging Programs.


[ Previous | Next | Contents | Glossary | Home | Search ]