DSIV DM GET STATUS

TITLEVALUE
NAMEDSIV DM GET STATUS
DESCRIPTIONThis 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
TAGSTATUS
ROUTINEDSIVDM
INPUT PARAMETERSSEQUENCE NUMBER1
INPUT PARAMETERTRANID
DESCRIPTIONThis is the transaction ID that was passed to the VistA Imaging Import
Queue. It must be in the format DSS;xxxxxx.
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH50

INPUT PARAMETERSSEQUENCE NUMBER2
INPUT PARAMETERWHICH
DESCRIPTIONThis 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
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH4

INPUT PARAMETERSSEQUENCE NUMBER3
INPUT PARAMETERDEL
DESCRIPTIONThis 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.
PARAMETER TYPELITERAL
REQUIREDNO
MAXIMUM DATA LENGTH1

INPUT PARAMETERSSEQUENCE NUMBER4
INPUT PARAMETERAPP
DESCRIPTIONThis is the application code assigned to a DSS application.
PARAMETER TYPELITERAL
REQUIREDYES
MAXIMUM DATA LENGTH7

RETURN VALUE TYPEGLOBAL ARRAY
RETURN PARAMETER DESCRIPTIONOn error, return a single message:
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

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.
AVAILABILITYAGREEMENT
INACTIVE
CLIENT MANAGER
WORD WRAP ONTRUE
VERSION
SUPPRESS RDV USER SETUP
APP PROXY ALLOWED