VIAA ENG GET CATEGORY (3779)    REMOTE PROCEDURE (8994)

This RPC requires three input parameters and returns all the entries
in the Engineering file Equipment Category, #6911.

• RETSTA
  PARAMETER TYPE:   LIST
  MAXIMUM DATA LENGTH:   32000
  REQUIRED:   YES
  DESCRIPTION:   

  This is the array for the return data from the call.
  

• REQDATA
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   255
  REQUIRED:   YES
  SEQUENCE NUMBER:   1
  DESCRIPTION:   

  This is the keyword "CATEGORY" to indicate the return of all the entries
  in the Equipment Category file, #6911.
  

• DATAID
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   255
  REQUIRED:   YES
  SEQUENCE NUMBER:   2
  DESCRIPTION:   

  Defines the scope of the data requested: 'ALL' for all the data on file.
  

For a successful call execution, the output for the client will be placed
the client using the following format in ^TMP:
 
^TMP("VIAACATEGORY",$J,0)="-###^reason_for_failure", where '###'
is a 3-digit http status code. The piece 'reason_for_failure' explains
what caused the error in VistA.
in ^TMP("VIAACATEGORY",$J,count,0) and returned via the variable RETSTA; 
it will consist of the following fields from file #6911 using '^' as a
delimiter:
 
^TMP("VIAACATEGORY",$J,count,0)=categoryIEN^categoryDescription
. . .
 
If an error occurs during call execution, a message will be returned to