Lister Query Entry

back to section start!

 ArcDir 

  The  lister query entry  command allows you to find information about an
entry, (file, directory, etc), in a lister.

  The output of the command can be displayed in two ways basically, depending
on how you format the command.

  The first way will output the information in one long string of the form:

  name size type selection seconds protect comment

  This will returned in either  RESULT  or a variable that you specify if you
include the  var  parameter in the command.

  The alternative provides a lot more information which is output in the form
of compound variables, the  stem  of which, you specify.

  A simple description of a compound variable:

      / name     = info.name
 info.- date     = info.date
      \ type     = info.type
   ^                   ^
   |                   |
 This is           These are the
 the 'stem'.      'compound' variables.

  A more involved description of compound variables and stems can be found
in the Amiga ARexx manual.

  Example:


 /* ListerQueryEntry.dopus5 */ 
options results
address 'DOPUS.1'
dopus front
lf = '0a'x
lister new mode name "S:"
handle = result
lister set handle display name comment version filetype
lister refresh handle full
lister wait handle
lister query handle entry "Startup-Sequence" var output
output = 'This is the output from ''lister query entry'' of'||lf||,
         'the file ''S:Startup-Sequence'' without stem variables:'||lf||,
         lf||output
dopus request '"'output'" OK'
lister query handle entry "Startup-Sequence" stem info.
text = 'The following output is using compound variables'||lf||,
       'with a stem of ''info.'''||lf||,
       'info.NAME       = '||info.NAME||lf||,
       'info.SIZE       = '||info.SIZE||lf||,
       'info.TYPE       = '||info.TYPE||lf||,
       'info.SELECTED   = '||info.SELECTED||lf||,
       'info.DATE       = '||info.DATE||lf||,
       'info.PROTECT    = '||info.PROTECT||lf||,
       'info.DATESTRING = '||info.DATESTRING||lf||,
       'info.PROTSTRING = '||info.PROTSTRING||lf||,
       'info.COMMENT    = '||info.COMMENT||lf||,
       'info.FILETYPE   = '||info.FILETYPE||lf||,
       'info.VERSION    = '||info.VERSION||lf||,
       'info.REVISION   = '||info.REVISION||lf||,
       'info.VERDATE    = '||info.VERDATE||lf||,
       'info.DATENUM    = '||info.DATENUM||lf||,
       'info.TIME       = '||info.TIME
dopus request '"'text'" OK'
lister close handle
dopus back
exit

  A description of the various variables above can be found in the
 DOpusM2_ARexx.guide .

NOTE: To obtain some variables, that particular information has to be
      displayed in the lister, for example: you will not get the version
      information if you have not enabled the version display in the lister.

DOpus PLUS - giving you that bit extra...