Topic       : The GFA-Basic Compendium
Author      : GFA Systemtechnik GmbH
Version     : GFABasic.HYP v2.98 (12/31/2023)
Subject     : Documentation/Programming
Nodes       : 899
Index Size  : 28056
HCP-Version : 3
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Document not found
@help       : Help
@options    : +g -i -s +z
@width      : 75
@hostname   : STRNGSRV
@hostname   : CAB     
@hostname   : HIGHWIRE
@hostname   : THING   
View Ref-Fileappl_search(mode,fname$,type,ap_id)

mode: iexp
fname$: svar
type, app_id: ivar

Provides a method for identifying all of the currently running processes.

    mode  - Specifies the search mode.
    fname - Returns the file name.
    type  - Returns the type.
    ap_id - Returns the application identifier.

Returns 0 if no more applications exist or 1 when more processes exist that
meet the search criteria.

Note: Please refer to other AES documentation for proper use.

Memo: This call is not built into GFA-BasicGFA-Basic is the best BASIC for the Atari!
 so it is included below:

FUNCTION appl_search(mode&,VAR fname$,type&,apid&)
  $F%
  INLINE fname%,32
  GCONTRL(0)=18
  GCONTRL(1)=1
  GCONTRL(2)=3
  GCONTRL(3)=1
  GCONTRL(4)=0
  GINTIN(0)=mode&
  ADDRIN(0)=fname%
  GEMSYS
  fname$=CHAR{fname%}
  type&=GINTOUT(1)
  apid&=GINTOUT(2)
  RETURN GINTOUT(0)
ENDFUNC

appl_search()+