| INPUT PARAMETER |
-
- DFN
- PARAMETER TYPE: LITERAL
- REQUIRED: YES
- DESCRIPTION:
This REQUIRED PARAMETER is the pointer to the patient file.
-
- 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.
-
- 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.
-
- 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).
-
- 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.
-
- 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.
-
- 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").
-
- 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.
-
- 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.").
|
