MAGV FIND WORK ITEM (3117)    REMOTE PROCEDURE (8994)

Name Value
NAME MAGV FIND WORK ITEM
TAG FIND
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 an array of work items with values that match the
parameters provided.
 | 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
    SEQUENCE NUMBER:   1
    DESCRIPTION:   
    This is the type of work item.  Work item types are stored in the
    WORKLIST file (#2006.9412).
    
  • SUBTYPE
    PARAMETER TYPE:   LITERAL
    SEQUENCE NUMBER:   2
    DESCRIPTION:   
    This is the subtype of the work item.
    
  • STATUS
    PARAMETER TYPE:   LITERAL
    SEQUENCE NUMBER:   3
    DESCRIPTION:   
    This is the current status of the work item.
    
  • PLACEID
    PARAMETER TYPE:   LITERAL
    SEQUENCE NUMBER:   4
    DESCRIPTION:   
    This is a place ID of a work item.  The place ID is an entry in the
    INSTITUTION file (#4).
    
  • PRIORITY
    PARAMETER TYPE:   LITERAL
    SEQUENCE NUMBER:   5
    DESCRIPTION:   
    This is the numeric priority given to a work item.
    
  • TAGS
    PARAMETER TYPE:   LIST
    SEQUENCE NUMBER:   8
    DESCRIPTION:   
    This is an array of tag names and values.
    
  • STOPTAG
    PARAMETER TYPE:   LITERAL
    SEQUENCE NUMBER:   6
    DESCRIPTION:   
    If this parameter is set then the tag list may be truncated. If a tag
    value matching the parameter value is returned then no more tags will
    be returned.
    
  • MAXROWS
    PARAMETER TYPE:   LITERAL
    SEQUENCE NUMBER:   7
    DESCRIPTION:   
    This parameter determines the number of work items to return.  If this
    parameter is not set all matching work items will be sent.  If this parameter
    is defined it will determine the maximum number of work items to return
    
RETURN PARAMETER DESCRIPTION
The return parameter returns a "0" for success. "-1" followed by an error message is returned if an error has occurred.
Subsequently an array of all matching work items and field values are returned.