| TITLE | VALUE | |
|---|---|---|
| NAME | DSIC DM GET STATUS | |
| DESCRIPTION | 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. | |
| TAG | STATUS | |
| ROUTINE | DSICDM | |
| INPUT PARAMETERS | SEQUENCE NUMBER | 1 |
| INPUT PARAMETER | TRANID | |
| 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. | |
| PARAMETER TYPE | LITERAL | |
| REQUIRED | NO | |
| MAXIMUM DATA LENGTH | 50 | |
| INPUT PARAMETERS | SEQUENCE NUMBER | 2 |
| INPUT PARAMETER | WHICH | |
| 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 | |
| PARAMETER TYPE | LITERAL | |
| REQUIRED | NO | |
| MAXIMUM DATA LENGTH | 4 | |
| INPUT PARAMETERS | SEQUENCE NUMBER | 3 |
| INPUT PARAMETER | DEL | |
| 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. | |
| PARAMETER TYPE | LITERAL | |
| REQUIRED | NO | |
| MAXIMUM DATA LENGTH | 1 | |
| INPUT PARAMETERS | SEQUENCE NUMBER | 4 |
| INPUT PARAMETER | APP | |
| DESCRIPTION | This is the application code assigned to a DSS application. | |
| PARAMETER TYPE | LITERAL | |
| REQUIRED | YES | |
| MAXIMUM DATA LENGTH | 7 | |
| RETURN VALUE TYPE | GLOBAL ARRAY | |
| RETURN PARAMETER DESCRIPTION | This will return a list: 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 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 | |
| AVAILABILITY | AGREEMENT | |
| INACTIVE | ||
| CLIENT MANAGER | ||
| WORD WRAP ON | TRUE | |
| VERSION | ||
| SUPPRESS RDV USER SETUP | ||
| APP PROXY ALLOWED | ||