CALL user.state.spawn (vid, state_id)

Function

This is a user-written routine that will be executed in response to a state transition.

Usage Considerations

The parameter list for your routine must match the number and type of parameters shown above, although you can use any variable names you wish.

You can create as many different spawn routines of this type as needed.

Routine Name

You can give this spawn routine any valid V+ program name. The name you use must match the name specified in the Spawn Routine field in a State record in the GEM Items database.

Input Parameters

vid	Associated VID (record from the GEM Variables database).
state_id	ID of a State record in the GEM Items database (i.e., the record for the state that has just been entered).

Details

One of the fields in the State database record specifies a routine to be executed when a state transition takes place. Your routine can take whatever steps are necessary to respond to the state change.

File: This is a user-written routine. It is not provided with the AdeptGEM module.

Related Routines

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