Table of Contents

GETSUB Method

Description

Method for getting a list of "sub-entities" (entities using entID).

Syntax

retval = Repository('GETSUB', entID)

Parameters

The GETSUB method has the following parameters.

ParameterDescription
Message'GETSUB'
entIDentID consists of four elements, which are '*' (asterisk) delimited:

* Application name
* Type ID
* Class ID
* Entity name

Methods are executed as follows: if class specific, execute at the class level; if type specific, execute at the type level; otherwise, execute the method.

Returns

A field mark delimited list of entities using entid.

Note: Always call the Get_Status function after calling Repository.

See Also

Repository() function, SETSUB Method, Get_Repos_Entities(). Also, Stored Procedures chapter in the Guide to Application Development.

Example

/* Return entities "sub" (child) to the CENTERWINDOW stored procedure into the variable called result */

Declare Function Get_Repos_Entities, Repository, Get_Status

AppID = @APPID<1>  ;* current application

TypeID = "STPROC"  ;* OpenInsight stored procedures

ClassID = ""  ;* Not Applicable

Stored_Proc_Name = 'CENTERWINDOW'

entid = AppID : '*' : TypeID : '*' : ClassID : '*' : Stored_Proc_Name
 

result = Repository("GETSUB", entid)

/*  result now contains a field mark delimited list of entities sub (children) to the CENTERWINDOW stored procedure. */

If Get_Status(ErrCode) then

  call msg(@window, 'Error Message returned: ' : ErrCode)

end