DSIC DM GET STATUS (1594)    REMOTE PROCEDURE (8994)

This will return the status(es) of import requests for an individual DSS 
application. If you pass the transaction ID then the status of that
transaction will be returned.  You can also retrieve the statuses of all
requests or all requests of a certain status.

• TRANID
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   50
  REQUIRED:   NO
  SEQUENCE NUMBER:   1
  DESCRIPTION:   

  This is the transaction ID that was passed to the VistA Imaging Import 
  Queue.  It must be in the format DSS;xxxxxx.
  unique identifier.
  

• WHICH
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   4
  REQUIRED:   NO
  SEQUENCE NUMBER:   2
  DESCRIPTION:   

  This is a string of codes to determine which transaction statuses to 
  return.  The parameter WHICH and TRANID are mutually excluded.  That is 
  if TRANID is passed, the parameter WHICH will not even be evaluated or 
  acted upon.
   
  If WHICH contains A, then retrieve all transactions for all statuses
  If WHICH contains E, then retrieve all ERROR transactions
  If WHICH contains S, then retrieve all SUCCESSFUL transactions
  If WHICH contains P, then retrieve all PENDING transactions
  

• DEL
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   1
  REQUIRED:   NO
  SEQUENCE NUMBER:   3
  DESCRIPTION:   

  This flag (0 or 1) will control whether or not the transaction record 
  should be deleted from file 19621.   Default value is 0, do not delete
   
  If DEL=1 then delete all SUCCESSFUL transactions returned in the RPC
  call.  So this will not delete import requests in an error state or
  pending.
  

• APP
  PARAMETER TYPE:   LITERAL
  MAXIMUM DATA LENGTH:   7
  REQUIRED:   YES
  SEQUENCE NUMBER:   4
  DESCRIPTION:   

  This is the application code assigned to a DSS application.  
  

This will return a list:
         array[n+j] = any messages passed back by Vista Imaging
                      where j = 1,2,3,...
         array[n+m] = $END  indicating the end of this transaction
                      where m = the value of the last j plus 1
         The status text is as follows:
             Error
             Successfully Imported
             Successfully Imported, record deleted (only if DEL=1)
             Pending
  on error, return error message(s) as array[n] = -1^error message
  if no errors, then return data as follows: 
    1. The return array will be sorted by status and then by tranID
         Any transaction in an error state come first
         Then come the successfully imported transactions
         Then come the pending transactions
    2. Each transaction returned will be multi-line
         array[n] = tranID ^ status