VEJD TPA GET KIDS STATUS (1065)    REMOTE PROCEDURE (8994)

This does a Fileman lookup on the INSTALL file and returns the last entry
for the value passed.

• VAL
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   50
  REQUIRED:   YES
  SEQUENCE NUMBER:   1
  DESCRIPTION:   

  Enter the name of the KIDS build for which you which to see its
  installation state.  Pass the name of the KIDS build as it appears in the
  INSTALL file.  You may pass a partial name, but this call will only return
  the data on the last entry installed
  

An array is returned in case an error is encountered or if multiple
 
The array returned is RET(x)= 1^message (if successfully installed)
                            =-1^error message (could be multiple lines)
 
Since one can load and install the same KIDS multiple times, this will try
to retrieve the last successfully installed KIDS build.  Success is
defined as STATUS = Install Completed AND there is an INSTALL DATE
COMPLETED
 
Example of possible scenario, install completed but they they reloaded the
entries are found that match the input value.  This RPC will sort all
KIDS build but did not install it.  Then you will receive an array:
  RET(1) = -1^error message
  RET(2) =  1^message
values found by S1,S2,S3 where
  S1 = KIDS NAME
  S2 = install completed date (if present), otherwise install loaded date
  S3 = internal entry number in the INSTALL FILE
 
It starts looking at all entries found in reverse order (most recent
first) for the first successfully installed KIDS build.