MAGV GET NEXT WORK ITEM (3122)    REMOTE PROCEDURE (8994)

Name Value
NAME MAGV GET NEXT WORK ITEM
TAG GETNEXT
ROUTINE MAGVIM01
RETURN VALUE TYPE ARRAY
AVAILABILITY RESTRICTED
DESCRIPTION 
 +---------------------------------------------------------------+
 | a medical device.  As such, it may not be changed in any way. |
 | Modifications to this software may result in an adulterated   |
 | medical device under 21CFR820, the use of which is considered |
 | to be a violation of US Federal Statutes.                     |
 +---------------------------------------------------------------+
 
This RPC returns the work item with the oldest LAST UPDATED date/time
with the specified expected status and work item type.
 | Property of the US Government.                                |
 | No permission to copy or redistribute this software is given. |
 | Use of unreleased versions of this software requires the user |
 | to execute a written test agreement with the VistA Imaging    |
 | Development Office of the Department of Veterans Affairs,     |
 | telephone (301) 734-0100.                                     |
 |                                                               |
 | The Food and Drug Administration classifies this software as  |
INPUT PARAMETER
  • TYPE
    PARAMETER TYPE:   LITERAL
    REQUIRED:   YES
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    This is the IEN of the related work list entry in the MAG WORK ITEM file (#2006.941).
  • EXPSTAT
    PARAMETER TYPE:   LITERAL
    REQUIRED:   YES
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
    This is the expected status of the work item.  If the work item does not have the expected status the work item elements will not be  returned and the work item status will not be updated.
  • NEWSTAT
    PARAMETER TYPE:   LITERAL
    REQUIRED:   YES
    SEQUENCE NUMBER:   3
    DESCRIPTION:   
    This is the new status to be filed in the work item.
  • UPDUSR
    PARAMETER TYPE:   LITERAL
    SEQUENCE NUMBER:   4
    DESCRIPTION:   
    This is the user that has updated the work item entry.
  • UPDAPP
    PARAMETER TYPE:   LITERAL
    SEQUENCE NUMBER:   5
    DESCRIPTION:   
    This is the application/service that has updated the work item entry.
  • PLACID
    PARAMETER TYPE:   LITERAL
    MAXIMUM DATA LENGTH:   30
    SEQUENCE NUMBER:   6
    DESCRIPTION:   
    The location name associated with the work item.
RETURN PARAMETER DESCRIPTION 
The return parameter returns a "0" for success. "-1" followed by an error message is returned if an error has occurred.
A successful look up will return all data elements filed for the entry.