$TXT Created by DAWSON,MICHAEL at TST.DEV.ISC-CHICAGO.VA.GOV  (KIDS) on THURSDAY, 04/20/00 at 11:08
=============================================================================
Run Date: APR 27, 2000                     Designation: MC*2.3*27
Package : MC - MEDICINE                        Priority: Mandatory
Version : 2.3        SEQ #25                    Status: Released
=============================================================================

Associated patches: (v)MC*2.3*18   <<= must be installed BEFORE `MC*2.3*27'

Subject: API FOR RESULT PRINTING FROM MEDICINE FILES

Category: 
  - Routine
  - Enhancement (Mandatory)

Description: 
============

  Test Site:
  =========
  Consult/Request Tracking Developer.
   
 1)  This patch introduces a new entry point, a new extrinsic function,
     and a new routine, MCAPI to the Medicine Package.
  
 2)  Routine MCARP has been modified to generate the display of a single patient
     procedure.  These modifications have been made per request of the
     Consult/Request Tracking Developer and will be entered as a private
     Integration Agreement.
  
    ROUTINE: MCAPI
  COMPONENT: $$SINGLE(RESULT)
             Retrieval of a single patient procedure.
 
             (e.g. S VARIABLE=$$SINGLE(RESULT))
  
  VARIABLES: RESULT   Input (required)
                            = "IEN;ROOT"
                            (e.g. "12;MCAR(691.5,")
 
                            IEN is the file number of the desired patient 
                            procedure.
  
                            ROOT is the global root of the medicine file
                            containing the desired patient procedure.
 
  
  VARIABLES: VARIABLE   Output
                            Variable containing a single patient procedure
                            for display by Consult/Request Tracking. This
                            reference is used as input for the modified 
                            patient display.
  
                            $P(VARIABLE,U,1)=Print Name
                               ...),U,2)=Pointer to Procedure
                               ...),U,3)=Print Line
                               ...),U,4)=Print Routine
                               ...),U,5)=Print Name
                               ...),U,6)=Date/Time of procedure
                               ...),U,7)=Gross Evaluation
                               ...),U,10)=Summary Title
                               ...),U,11)=Procedure
                               ...),U,12)=Pointer to Procedure
                               ...),U,13)=Patient DFN
  
                     *****************************
 
  COMPONENT: EN(RESULT,FLG)
             Produces modified display for a single patient procedure.
             This call is used in conjunction with another call to an 
             MC routine.
  
             $$SINGLE^MCAPI => gets patient related data.
              
  
  VARIABLES: RESULT    Input (required)
                             = "IEN;ROOT"
                               (e.g. "12;MCAR(691.5,"
 
                             IEN is the file number of the desired patient
                             procedure.
 
                             ROOT is the global root of the medicine file
                             containing the desired patient procedure.
     
             FLG       Input (required)
                             =1 if report is to contain a modified header
                                omitting the patient's information.
                                Any other value in the variable FLG will
                                result in the report containing the 
                                patient's information in the header.
 
                       Output
                             = Modified display of a single patient
                               procedure. The display is defined by the input
                               variables and is to be displayed in the
                               Consult/Request Tracking Package.
                     ********************************
    
  Solution/Routine(s) changed: MCARP,MCAPI.
  
  Routine Summary:
  ================
  The following routines are included in this patch.  The second line of the
  routines will look like the following:
   
  <tab>;;2.3;Medicine;**[Patch List]**;09/13/1996
   
  Routine Name     Before Patch      After Patch     Patch List
  ================================================================
  MCARP            12825436          12876925        6,14,15,18,27
  MCAPI              N/A             2989774         27
  
  Installation Instructions: 
  ==========================
  This patch may be installed with users on the system.
  
  Installation of this patch will take less than 5 minutes.
  
  1.  Use the INSTALL/CHECK MESSAGE option on the PackMan menu, to
      load the KIDS Transport Distribution global.
  
  2.  Review your mapped set.  If any of the routines listed in
      the ROUTINE SUMMARY section are mapped, they should be
      removed from the mapped set at this time.
  
  3.  From the Kernel Installation and Distribution System (KIDS) Menu,
      select the Installation menu.
  
  4.  From the Install menu, you may elect to use the following
      options (when prompted for INSTALL NAME, enter MC*2.3*27):
  
       a.  Verify Checksums in Transport Global
       b.  Print Transport Global
       c.  Compare Transport Global to Current System
       d.  Backup a Transport Global
  
  5.  Use the Install Package(s) option and select the package
      MC*2.3*27.
  
  6.  When prompted 'Want KIDS to INHIBIT LOGONS during the install? YES//'
      answer no.
  
  7.  When prompted 'Want to DISABLE Scheduled Options,
      Menu Options, and Protocols? YES//' answer no.
  
  8.  If routines were unmapped as part of step 2, they 
      should be returned to the mapped set once the installation
      has run to completion.

Routine Information:
====================

Routine Name:
  - MCAPI


Routine Checksum:

Routine Name:
  - MCARP


Routine Checksum:

=============================================================================
User Information:                               
Entered By  : DAWSON,MICHAEL                 Date Entered : FEB 08, 2000
Completed By: REZNIK,CHARMAINE              Date Completed: APR 24, 2000
Released By : BELSCHWINDER,MICHAEL          Date Released : APR 27, 2000
=============================================================================


Packman Mail Message:
=====================

$END TXT