CALL gm.get.state (state, vid, $state, status)

Function

This routine accesses a State record in the GEM Items database to retrieve the name of a state associated with a particular state variable.

Input Parameters

state	The identification number for the state of interest
vid	The identification number of the state variable expected to be associated with the specified state

Output Parameter

$state	The name of the state (1-15 characters)
status	Status indicator. Values interpreted as: 0 Success 1 Specified State record does not exist in the GEM Items database.  2 Specified State record does exist, but the associated VID specified in the record does not match the vid input parameter. < 0 Standard AIM database status return code

 Details

File: GEMDBASE.SQU

Related Routines

gm.eps.get (task, prev.state, eps.state)
gm.get.sinfo (vid, state, $spawn, id[], act.val, status)