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

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

Item	Description
SRC_NOREC	Subsystem name does not exist.

Files

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