getsubsvr Subroutine
Purpose
Reads a subsystem record.
Library
System Resource Controller Library (libsrc.a)
Syntax
#include <sys/srcobj.h>
#include <spc.h>Description
The getsubsvr subroutine reads a subsystem record associated with the specified subserver and returns the ODM record in the SRCsubsvr structure.
The SRCsubsvr structure is defined in the sys/srcobj.h file and includes the following fields:
| Item | Description |
|---|---|
| char | sub_type[30]; |
| char | subsysname[30]; |
| short | sub_code; |
Parameters
| Item | Description |
|---|---|
| SRCSubserver | Points to the SRCsubsvr structure. |
| SubserverName | Specifies the subserver to be read. |
Return Values
Upon successful completion, the getsubsvr 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 getsubsvr subroutine fails, the following is returned:
| Item | Description |
|---|---|
| SRC_NOREC | The specified SRCsubsvr record does not exist. |
Files
| Item | Description |
|---|---|
| /etc/objrepos/SRCsubsvr | SRC Subserver Configuration object class. |