Difference between revisions of "TIU CREATE RECORD"

From VistApedia
Jump to: navigation, search
(Added a glossary link to Clinical Case Procedures~)
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
TIU CREATE RECORD
+
TIU CREATE [[RECORD~|Record]]
  
 
  NUMBER: 97
 
  NUMBER: 97
   NAME: TIU CREATE RECORD
+
   NAME: TIU CREATE [[RECORD~|Record]]
   TAG: MAKE                             
+
   TAG: '''MAKE'''                              
   ROUTINE: TIUSRVP
+
   ROUTINE: '''TIUSRVP'''
 
   RETURN VALUE TYPE: SINGLE VALUE       
 
   RETURN VALUE TYPE: SINGLE VALUE       
 
   AVAILABILITY: SUBSCRIPTION
 
   AVAILABILITY: SUBSCRIPTION
   DESCRIPTION:
+
   ''DESCRIPTION'':
     This remote procedure allows the creation of TIU DOCUMENT records.
+
     This remote procedure allows the creation of TIU DOCUMENT [[record~|Record]]s.
 
   INPUT PARAMETER: '''DFN'''                   
 
   INPUT PARAMETER: '''DFN'''                   
     PARAMETER TYPE: LITERAL
+
     ''PARAMETER TYPE'': LITERAL
     REQUIRED: YES
+
     ''REQUIRED'': YES
     DESCRIPTION:
+
     ''DESCRIPTION'':
       This REQUIRED PARAMETER is the pointer to the patient file.
+
       This ''REQUIRED'' PARAMETER is the pointer to the patient file.
 
   INPUT PARAMETER: '''TITLE'''                   
 
   INPUT PARAMETER: '''TITLE'''                   
     PARAMETER TYPE: LITERAL
+
     ''PARAMETER TYPE'': LITERAL
     REQUIRED: YES
+
     ''REQUIRED'': YES
     DESCRIPTION:
+
     ''DESCRIPTION'':
 
       This is the pointer to the TIU DOCUMENT DEFINITION FILE which  
 
       This is the pointer to the TIU DOCUMENT DEFINITION FILE which  
 
       identifies the TITLE of the document to be filed.
 
       identifies the TITLE of the document to be filed.
 
   INPUT PARAMETER: '''VDT'''                     
 
   INPUT PARAMETER: '''VDT'''                     
     PARAMETER TYPE: LITERAL
+
     ''PARAMETER TYPE'': LITERAL
     REQUIRED: NO
+
     ''REQUIRED'': NO
     DESCRIPTION:
+
     ''DESCRIPTION'':
 
       This optional parameter is the Date/time of visit.  If the parameter  
 
       This optional parameter is the Date/time of visit.  If the parameter  
 
       VSIT is present, this will be ignored.  Otherwise, the RPC will attempt
 
       VSIT is present, this will be ignored.  Otherwise, the RPC will attempt
Line 30: Line 30:
 
       new EVENT-type Visit will be created with the current date/time.
 
       new EVENT-type Visit will be created with the current date/time.
 
   INPUT PARAMETER: '''VLOC'''                   
 
   INPUT PARAMETER: '''VLOC'''                   
     PARAMETER TYPE: LITERAL
+
     ''PARAMETER TYPE'': LITERAL
     REQUIRED: NO
+
     ''REQUIRED'': NO
     DESCRIPTION:
+
     ''DESCRIPTION'':
 
       This optional parameter is the Location of Visit (e.g., Cardiology
 
       This optional parameter is the Location of Visit (e.g., Cardiology
 
       Clinic).  It is a pointer to Hospital location (File #44).
 
       Clinic).  It is a pointer to Hospital location (File #44).
 
   INPUT PARAMETER: '''VSIT'''                   
 
   INPUT PARAMETER: '''VSIT'''                   
     PARAMETER TYPE: LITERAL
+
     ''PARAMETER TYPE'': LITERAL
     REQUIRED: NO
+
     ''REQUIRED'': NO
     DESCRIPTION:
+
     ''DESCRIPTION'':
 
       This is a pointer to the Visit File (#9000010) entry for the visit  
 
       This is a pointer to the Visit File (#9000010) entry for the visit  
 
       to which the document is to be linked.
 
       to which the document is to be linked.
 
   INPUT PARAMETER: '''TIUX'''                   
 
   INPUT PARAMETER: '''TIUX'''                   
     PARAMETER TYPE: LIST
+
     ''PARAMETER TYPE'': LIST
     REQUIRED: YES
+
     ''REQUIRED'': YES
     DESCRIPTION:
+
     ''DESCRIPTION'':
 
       This is the input array in which the identifiers of the document, as  
 
       This is the input array in which the identifiers of the document, as  
 
       well as its text, are to be stored in the format described for the TIU
 
       well as its text, are to be stored in the format described for the TIU
       UPDATE RECORD RPC.
+
       UPDATE [[RECORD~|Record]] RPC.
 
   INPUT PARAMETER: '''VSTR'''                   
 
   INPUT PARAMETER: '''VSTR'''                   
     PARAMETER TYPE: LITERAL
+
     ''PARAMETER TYPE'': LITERAL
     REQUIRED: NO
+
     ''REQUIRED'': NO
     DESCRIPTION:
+
     ''DESCRIPTION'':
 
       This parameter identifies the visit location, date/time, and Service
 
       This parameter identifies the visit location, date/time, and Service
 
       Category (Hospitalization, Ambulatory, Telecommunications, or Event
 
       Category (Hospitalization, Ambulatory, Telecommunications, or Event
     (HISTORICAL)) in the form of a semi-colon delimited string (e.g.,
+
     ([[HISTORICAL~|
 +
Historical]])) in the form of a semi-colon delimited string (e.g.,
 
     "469;2970616.1415;A").
 
     "469;2970616.1415;A").
 
   INPUT PARAMETER: '''SUPPRESS'''               
 
   INPUT PARAMETER: '''SUPPRESS'''               
     PARAMETER TYPE: LITERAL
+
     ''PARAMETER TYPE'': LITERAL
     MAXIMUM DATA LENGTH: 1                 
+
     ''MAXIMUM DATA LENGTH'': 1                 
     REQUIRED: NO
+
     ''REQUIRED'': NO
     SEQUENCE NUMBER: 8
+
     ''SEQUENCE NUMBER'': 8
     DESCRIPTION:
+
     ''DESCRIPTION'':
 
       BOOLEAN flag indicating whether or not to suppress execution of the COMMIT
 
       BOOLEAN flag indicating whether or not to suppress execution of the COMMIT
       ACTION for the document in question. This gives the calling application
+
       [[ACTION~|Action]] for the document in question. This gives the calling [[application~|Application]]
 
       control over the circumstances in which the COMMIT CODE should be
 
       control over the circumstances in which the COMMIT CODE should be
 
       executed.
 
       executed.
 
   INPUT PARAMETER: '''NOASF'''                   
 
   INPUT PARAMETER: '''NOASF'''                   
     PARAMETER TYPE: LITERAL
+
     ''PARAMETER TYPE'': LITERAL
     MAXIMUM DATA LENGTH: 1                 
+
     ''MAXIMUM DATA LENGTH'': 1                 
     REQUIRED: NO
+
     ''REQUIRED'': NO
     SEQUENCE NUMBER: 9
+
     ''SEQUENCE NUMBER'': 9
     DESCRIPTION:
+
     ''DESCRIPTION'':
 
       This parameter can optionally be set to 1 to indicate the ASAVE
 
       This parameter can optionally be set to 1 to indicate the ASAVE
 
       cross-reference in the TIU Document file (#8925) should not be set when
 
       cross-reference in the TIU Document file (#8925) should not be set when
Line 77: Line 78:
 
       sessions where a user could be dropped.  The cross-reference is used to
 
       sessions where a user could be dropped.  The cross-reference is used to
 
       provide the user with an easy way to resume editing the TIU Document they
 
       provide the user with an easy way to resume editing the TIU Document they
       were working on when they were dropped.  In the Clinical Procedures
+
       were working on when they were dropped.  In the [[Clinical Procedures~|Clinical Procedures]]
 
       realm, for example, where the stub is created in the 'background' this
 
       realm, for example, where the stub is created in the 'background' this
 
       cross-reference should not be set since the user is not interactively
 
       cross-reference should not be set since the user is not interactively
       involved in the creation of the record.
+
       involved in the creation of the [[record~|Record]].
   RETURN PARAMETER DESCRIPTION:
+
   RETURN PARAMETER ''DESCRIPTION'':
       If the call is successful, this will be the record number (IEN) of the
+
       If the call is successful, this will be the [[record~|Record]] number (IEN) of the
 
       resulting entry in the TIU DOCUMENT FILE (#8925).  In the event of a
 
       resulting entry in the TIU DOCUMENT FILE (#8925).  In the event of a
 
       filing error, the first "^"-piece will be zero, and the second "^"-piece
 
       filing error, the first "^"-piece will be zero, and the second "^"-piece
 
       of this scalar return variable will be a textual message describing the
 
       of this scalar return variable will be a textual message describing the
 
       nature of the error (e.g., 0^Invalid TITLE Selected.").
 
       nature of the error (e.g., 0^Invalid TITLE Selected.").

Latest revision as of 02:05, 5 September 2012

TIU CREATE Record

NUMBER: 97
 NAME: TIU CREATE Record
 TAG: MAKE                             
 ROUTINE: TIUSRVP
 RETURN VALUE TYPE: SINGLE VALUE       
 AVAILABILITY: SUBSCRIPTION
 DESCRIPTION:
   This remote procedure allows the creation of TIU DOCUMENT Records.
 INPUT PARAMETER: DFN                  
   PARAMETER TYPE: LITERAL
   REQUIRED: YES
   DESCRIPTION:
      This REQUIRED PARAMETER is the pointer to the patient file.
 INPUT PARAMETER: TITLE                  
   PARAMETER TYPE: LITERAL
   REQUIRED: YES
   DESCRIPTION:
      This is the pointer to the TIU DOCUMENT DEFINITION FILE which 
      identifies the TITLE of the document to be filed.
 INPUT PARAMETER: VDT                    
   PARAMETER TYPE: LITERAL
   REQUIRED: NO
   DESCRIPTION:
      This optional parameter is the Date/time of visit.  If the parameter 
      VSIT is present, this will be ignored.  Otherwise, the RPC will attempt
      to generate a match with a visit based on DFN, VDT, and VLOC (visit
      location).  In the event that the RPC cannot generate such a match, a 
      new EVENT-type Visit will be created with the current date/time.
 INPUT PARAMETER: VLOC                   
   PARAMETER TYPE: LITERAL
   REQUIRED: NO
   DESCRIPTION:
     This optional parameter is the Location of Visit (e.g., Cardiology
     Clinic).  It is a pointer to Hospital location (File #44).
 INPUT PARAMETER: VSIT                   
   PARAMETER TYPE: LITERAL
   REQUIRED: NO
   DESCRIPTION:
     This is a pointer to the Visit File (#9000010) entry for the visit 
     to which the document is to be linked.
 INPUT PARAMETER: TIUX                   
   PARAMETER TYPE: LIST
   REQUIRED: YES
   DESCRIPTION:
     This is the input array in which the identifiers of the document, as 
     well as its text, are to be stored in the format described for the TIU
     UPDATE Record RPC.
 INPUT PARAMETER: VSTR                   
   PARAMETER TYPE: LITERAL
   REQUIRED: NO
   DESCRIPTION:
     This parameter identifies the visit location, date/time, and Service
     Category (Hospitalization, Ambulatory, Telecommunications, or Event
    (
Historical)) in the form of a semi-colon delimited string (e.g.,
    "469;2970616.1415;A").
 INPUT PARAMETER: SUPPRESS               
   PARAMETER TYPE: LITERAL
   MAXIMUM DATA LENGTH: 1                
   REQUIRED: NO
   SEQUENCE NUMBER: 8
   DESCRIPTION:
     BOOLEAN flag indicating whether or not to suppress execution of the COMMIT
     Action for the document in question. This gives the calling Application
     control over the circumstances in which the COMMIT CODE should be
     executed.
 INPUT PARAMETER: NOASF                  
   PARAMETER TYPE: LITERAL
   MAXIMUM DATA LENGTH: 1                
   REQUIRED: NO
   SEQUENCE NUMBER: 9
   DESCRIPTION:
     This parameter can optionally be set to 1 to indicate the ASAVE
     cross-reference in the TIU Document file (#8925) should not be set when
     calling this RPC.  The intent of this cross-reference is for telnet type
     sessions where a user could be dropped.  The cross-reference is used to
     provide the user with an easy way to resume editing the TIU Document they
     were working on when they were dropped.  In the Clinical Procedures
     realm, for example, where the stub is created in the 'background' this
     cross-reference should not be set since the user is not interactively
     involved in the creation of the Record.
 RETURN PARAMETER DESCRIPTION:
     If the call is successful, this will be the Record number (IEN) of the
     resulting entry in the TIU DOCUMENT FILE (#8925).  In the event of a
     filing error, the first "^"-piece will be zero, and the second "^"-piece
     of this scalar return variable will be a textual message describing the
     nature of the error (e.g., 0^Invalid TITLE Selected.").