DSIV DM GET STATUS (2531)    REMOTE PROCEDURE (8994)

Name Value
NAME DSIV DM GET STATUS
TAG STATUS
ROUTINE DSIVDM
RETURN VALUE TYPE GLOBAL ARRAY
AVAILABILITY AGREEMENT
WORD WRAP ON TRUE
DESCRIPTION
This RPC has been archived as of June 20, 2005.  No applications should 
use this RPC after this date.  Please use the new RPC: DSIV DM GET STATUS1
INPUT PARAMETER
  • 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.
    
  • 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.  
    
RETURN PARAMETER DESCRIPTION
On error, return a single message:
 
Every record will have at least two lines, the TranID line and the $END 
line.  A record may or may not have optional text.
 
Status will be one of three: Error, Successfully Imported, Pending
Status may or may not have additional text following the status name.
  List[0] := -1^message
 
Otherwise, return a multi-line list for each record whether only one 
record is returned or multiple records are returned.  The format for each 
returned record is:
  List[n]     := transaction ID ^ status [- additional msg]
  List[n+m]   := optional text for errors or successful imports
  List[n+m+1] := $END