DSIC XPD INSTALL LIST (2431)    REMOTE PROCEDURE (8994)

This will return a list of all the entries in the INSTALL file.  You pass 
in either a KIDS Build name or the name portion of the Build name (a 
Build name without the version number or patch number).  All Installs 
matching that name will be returned in reverse chronological order (the 
newest first).

• DSIKID
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   30
  REQUIRED:   YES
  SEQUENCE NUMBER:   1
  DESCRIPTION:   

  This value will be used to do a Fileman lookup on the INSTALL file .01 
  Name field.  This value can be a full Build name in the form:
    <test><space><version>  or a patch <text>*<version>*<patch>
  This value can just be the text portion of the Build name.
  

• DSIALL
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   1
  REQUIRED:   NO
  SEQUENCE NUMBER:   2
  DESCRIPTION:   

  This parameter will only be used if the DSIKID input value is a patch 
  designation name, that is a Build name with "*".
   
  This is a Boolean value: 1/0   Default value = 0
    if 1 then return only Installs whose Build name exactly matches the
      value passed in DSIKID
    if 0 then return all Installs whose Build name starts with the text 
      portion of a patch designation:  <text>*<version>*<patch>
  

• DSISTAT
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   5
  REQUIRED:   NO
  SEQUENCE NUMBER:   3
  DESCRIPTION:   

  This is a string of numbers which can be 0,1,2,3,4
       this status code.
   
  Default value = 23
  These numbers indicate the status of the KIDS Install Status
    0:Loaded   1:Queued   2:Install Started   3:Install Completed
    4:De-installed
   
  The only statuses that indicate a Build was actually installed are 2,3
    3 indicates the install ran to completion successfully
    2 indicates that the install started but never ran to completion.
       There is no way to determine how far the install got just looking at
  

Return List[n] := p1^p2^p3  for n=1,2,3,4,...  where
 
If there are problems, return List[1] := -1^message
  p1 = ifn to file 9.7    p2 = Build name
  p3 = date [return INSTALL COMPLETE DATE if present, else return
       DATE LOADED]
 
The return list is sorted by Build name root and within name root sort by
date in reverse chronological order.  The Build name root is the root 
portion of a valid Build name:
  <root><space><version>      <root>*<version>*<patch>