STANDARD DATA DICTIONARY #446.4 -- BARCODE PROGRAM FILE                                                           6/27/25    PAGE 1
STORED IN ^PRCT(446.4,  (4 ENTRIES)   SITE: WWW.BMIRWIN.COM   UCI: VISTA,VISTA                                     (VERSION 5.1)   

DATA          NAME                  GLOBAL        DATA
ELEMENT       TITLE                 LOCATION      TYPE
-----------------------------------------------------------------------------------------------------------------------------------
This file contains barcode programs and data uploaded from the barcode reader to be used as part of the Barcode Inventory process.  


              DD ACCESS: @
              WR ACCESS: @
             DEL ACCESS: @
           LAYGO ACCESS: @
IDENTIFIED BY: IDENTIFIER (#.02)

CROSS
REFERENCED BY: NAME(B), IDENTIFIER(C)



446.4,.01     NAME                   0;1 FREE TEXT (Required)

              INPUT TRANSFORM:  K:$L(X)>30!($L(X)<3)!'(X'?1P.E) X
              HELP-PROMPT:      ANSWER MUST BE 3-30 CHARACTERS IN LENGTH 
              DESCRIPTION:      This field should be a short description of the data that will be collected and stored using the
                                barcode program (field #1) that is contained in this file.  

              CROSS-REFERENCE:  446.4^B 
                                1)= S ^PRCT(446.4,"B",$E(X,1,30),DA)=""
                                2)= K ^PRCT(446.4,"B",$E(X,1,30),DA)


446.4,.02     IDENTIFIER             0;2 FREE TEXT

              INPUT TRANSFORM:  K:X[""""!($A(X)=45) X I $D(X) K:$L(X)>6!($L(X)<3) X D:$D(X) IDENT^PRCTUTL
              LAST EDITED:      APR 20, 1990 
              HELP-PROMPT:      ANSWER MUST BE 3-8 CHARACTERS IN LENGTH 
              DESCRIPTION:      This field is a unique IDENTIFIER of the data that will be stored in this file.  When data is
                                downloaded from a barcode program, the first record received should be the IDENTIFIER of the data
                                being downloaded.  
                                 
                                Once the IDENTIFIER is known, then the data will stored in the BARCODE DATA multiple (446.42,1) for
                                the appropriate entry.  After the data has successfully been uploaded, then the proper LINE TAG
                                (field #.03) and ROUTINE (field #.04) can be tasked to process the data.  
                                 
                                NOTE: The Identifier must be a package namespace followed by two characters.  For example: If the
                                program handles inventory of formulary drugs for outpatient, the identifier might be 'PSOFM'.  The
                                'PSO' is the outpatient namespace and 'FM' is two characters that further describe the type of
                                program.  

              NOTES:            XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER

              CROSS-REFERENCE:  446.4^C 
                                1)= S ^PRCT(446.4,"C",$E(X,1,30),DA)=""
                                2)= K ^PRCT(446.4,"C",$E(X,1,30),DA)
                                This cross reference sorts the barcode program by the identifier for lookups.  The node
                                prct(446.4,"c",IDENT,da) is set where IDENT is the identifier.  



446.4,.03     POST UPLOAD ROUTINE    0;3 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>17!($L(X)<1)!($L(X)>8&(X'["-")) X D:$D(X) RTN^PRCTUTL
              LAST EDITED:      NOV 17, 1989 
              HELP-PROMPT:      ANSWER MUST BE 1-17 CHARACTERS IN LENGTH 
              DESCRIPTION:      This field contains the ANSI-MUMPS routine that will be called directly after a successful upload
                                of data has taken place.  
                                 
                                This field can also contain a line tag.  The dash (-) is used, instead of the up-arrow (^) to
                                separate the line tag from the routine.  For example, if the routine that should be called is
                                EN^ENG you would enter EN-ENG in this field.  

              NOTES:            XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER


446.4,.04     DATA PROCESSOR ROUTINE 0;4 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>17!($L(X)<1)!($L(X)>8&(X'["-")) X D:$D(X) RTN^PRCTUTL
              LAST EDITED:      NOV 17, 1989 
              HELP-PROMPT:      ANSWER MUST BE 1-17 CHARACTERS IN LENGTH 
              DESCRIPTION:      This field is the ANSI-MUMPS routine that will be tasked to taskmanager after data is uploaded from
                                the barcode reader.  This routine will be responsible for the processing of data in the BARCODE
                                DATA multiple (data upload from the barcode reader).  
                                 
                                This field can also contain a line tag.  The dash (-) is used, instead of the up-arrow (^) to
                                separate the line tag from routine.  For example, if the routine that should be called is EN^ENG
                                you would enter EN-ENG in this field.  

              NOTES:            XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER


446.4,.05     TIME TO QUEUE ROUTINE  0;5 FREE TEXT

              INPUT TRANSFORM:  S X="T@"_X,%DT="TXR" D ^%DT S X=$P(Y,".",2),X=X_$E("000",1,4-$L(X)) K:Y<0 X
              LAST EDITED:      NOV 02, 1989 
              HELP-PROMPT:      ANSWER MUST BE 1-10 CHARACTERS IN LENGTH 
              DESCRIPTION:      This field contains the time of day that processing of data for this entry should take place.  For
                                example, if 1AM is entered into this field, then any data that needs to be processed for this entry
                                will not take place until 1AM.  This means that users could be allowed to upload data from a
                                barcode reader during anytime of the day, but allows the local site to use this field to specify
                                what time of the day the data should be processed.  
                                 
                                If this field is blank, then the processing of data will be immediate.  
                                 
                                NOTE: This field contains military time only.  If, for example, 3pm is 
                                      entered, this will be converted to 1500.  

              NOTES:            XXXX--CAN'T BE ALTERED EXCEPT BY PROGRAMMER


446.4,.06     IS DEVICE REQUIRED ?   0;6 SET

                                '0' FOR NO; 
                                '1' FOR YES; 
              LAST EDITED:      NOV 02, 1989 
              DESCRIPTION:      This field controls whether or not the user, after uploaded data to this file entry, is prompted
                                for a device to task the processing.  
                                 
                                For example, some programs that process barcode data from this file will require a printer.  If
                                this field is set to 1 (YES), then the user will be prompted for a device.  If this field is set to
                                0 (NO), then the user will not be prompted for a device and the job will run as a background job
                                with no device associated with it.  


446.4,.07     PURGE DAYS             0;7 NUMBER

              INPUT TRANSFORM:  K:+X'=X!(X>30)!(X<3)!(X?.E1"."1N.N) X
              LAST EDITED:      NOV 13, 1989 
              HELP-PROMPT:      Type a Number between 3 and 30, 0 Decimal Digits 
              DESCRIPTION:      This field is the maximum number of days that the DATE/TIME OF DATA UPLOAD data should exist on the
                                computer system.  
                                 
                                For example: If this field is 20, any data that may have been uploaded over 20 days ago for this
                                entry will be automatically deleted.  Since barcode data is usually 'processed' within a day or
                                two, it is not necessary to keep this information for a long period of time.  It is recommended to
                                keep this data for at least 7 days incase trouble-shooting is necessary.  
                                 
                                If no data is entered for this field, the default is 7 days.  


446.4,.08     LAST DATA PURGE FLAG   0;8 DATE

              INPUT TRANSFORM:  S %DT="EX" D ^%DT S X=Y K:Y<1 X
              LAST EDITED:      NOV 13, 1989 
              DESCRIPTION:      This field is a flag set by the computer.  It is updated by the computer as a means to keep track
                                of when the next purge is scheduled to run or was last run.  The purging of data is handled
                                automatically and does not need to be run or queued to run by a user.  

                                UNEDITABLE

446.4,.09     SPECIALTY COMMANDS     0;9 POINTER TO SPECIALTY COMMANDS FILE (#446.6)

              LAST EDITED:      MAR 01, 1993 
              DESCRIPTION:
                                This field identifies the specialty commands for the barcode program.  


446.4,.1      CREATED BY             0;10 POINTER TO NEW PERSON FILE (#200)

              LAST EDITED:      JAN 06, 1993 
              DESCRIPTION:
                                This field stores the user creating the barcode program.  


446.4,.11     SITE                   0;11 FREE TEXT

              INPUT TRANSFORM:  K:$L(X)>10!($L(X)<3) X
              LAST EDITED:      APR 19, 1990 
              HELP-PROMPT:      Answer must be 3-10 characters in length. 
              DESCRIPTION:
                                This field stores the site creating the barcode program.  


446.4,.12     GENERIC DOWNLOADING?   0;12 SET

                                '1' FOR YES; 
              LAST EDITED:      AUG 14, 1990 
              DESCRIPTION:         This field determines whether or not a bar code program may be downloaded generally (via option
                                PRCT DOWNLOAD BARCODE PROGRAM).  
                                   If a bar code program expects that certain parameters will be passed to it from the host system,
                                this field should be blank. Otherwise it may be set to '1'.  


446.4,1       BARCODE PROGRAM        1;0   WORD-PROCESSING #446.41   (NOWRAP)

              DESCRIPTION:      This word-processing field is used for the storage of the barcode program for the barcode reader. 
                                The program can be downloaded from this field into the barcode reader directly.  
                                 
                                Comments should be included in the barcode program starting with two colons.  During downloading of
                                program from this file to the reader, all comments that use two colons will be striped off and not
                                sent to the barcode reader.  Comments do not need to be resident on the barcode reader itself and
                                it is not recommended since it requires additional memory to store comments.  
                                 
                                It is recommended that comments be included at the end of every line of barcode program for
                                debugging purposes.  Also, utilities exist to aid you with comment alignment.  For example, if a
                                200 line barcode program has comments at different columns, it makes read-ability of the barcode
                                program very difficult.  A utility exists to align all comments at a specific (e.g., 30, 35, 40,
                                etc.) column of the barcode program.  


                DESCRIPTION:
                                  This word-processing field is used for the storage of the barcode program for the barcode reader.  




446.4,2       DATE/TIME OF DATA UPLOAD 2;0 DATE Multiple #446.42

              DESCRIPTION:      This multiple field stores the date and time of when the data was uploaded from a barcode reader
                                and stored in this file.  

              IDENTIFIED BY:    
                    "WRITE":    S %I=Y,Y=$S('$D(^(0)):"",$D(^VA(200,+$P(^(0),U,2),0))#2:$P(^(0),U,1),1:""),C=$P(^DD(200,.01,0),U,2)
                                 D Y^DIQ:Y]"" W "   ",Y,@("$E("_DIC_"%I,0),0)") S Y=%I K %I

446.42,.01      DATE/TIME OF DATA UPLOAD 0;1 DATE (Multiply asked)

                INPUT TRANSFORM:  S %DT="ETXR" D ^%DT S X=Y K:Y<1 X
                LAST EDITED:      NOV 09, 1989 
                DESCRIPTION:      This field is the DATE/TIME of when data was uploaded from a barcode reader and stored in this
                                  file.  

                                  UNEDITABLE
                CROSS-REFERENCE:  446.42^B 
                                  1)= S ^PRCT(446.4,DA(1),2,"B",$E(X,1,30),DA)=""
                                  2)= K ^PRCT(446.4,DA(1),2,"B",$E(X,1,30),DA)


446.42,.02      UPLOAD USER            0;2 POINTER TO NEW PERSON FILE (#200)

                LAST EDITED:      NOV 09, 1989 
                DESCRIPTION:      This field contains the name of the user who uploaded the data from the barcode reader to this
                                  file.  

                                  UNEDITABLE

446.42,.03      STATUS                 0;3 FREE TEXT

                INPUT TRANSFORM:  K:$L(X)>40!($L(X)<1) X
                LAST EDITED:      NOV 13, 1989 
                HELP-PROMPT:      ANSWER MUST BE 1-40 CHARACTERS IN LENGTH 
                DESCRIPTION:      Status is a comment field updated by the computer that contains the status of the data stored in
                                  this multiple.  The status of the data will include what 'step' or 'error' the data has
                                  encountered during procedure of initial upload to actual processing.  
                                   
                                  This field could contain such comments as: 
                                   
                                       ATTEMPTING DATA UPLOAD - (Data is currently being uploaded) 
                                       DATA UPLOAD SUCCESSFUL - (Data has just been uploaded with no errors) 
                                    or DATA UPLOAD FAILURE    - (Data upload has failed due to missing records) 
                                       DEVICE NOT SELECTED    - (Data was uploaded sucessfully, but the user 
                                                                 has not specified the device to which the 
                                                                 data should process) 
                                       TASKED FOR [date/time] - (Data was uploaded successfully and will be 
                                                                 processed on the date/time specified) 
                                       RTN FLD IS MISSING     - (Data attempted to process but could not 
                                                                 because the process routine is not 
                                                                 defined (field 446.4,.04 and 446.4,.03) 
                                       RTN IS MISSING         - (Data attempted to process but could not 
                                                                 because the routine specified does not 
                                                                 exist on computer system (field 446.4,.04 and 
                                                                 446.4,.03).  
                                       STARTED ON [date/time] - (Data has started to process on the data/time 
                                                                 specified) 
                                       FINISHED ON [date/time]- (Data has finished processing on the date/time 
                                                                 specified) 

                                  UNEDITABLE

446.42,1        BARCODE DATA           1;0   WORD-PROCESSING #446.421   (NOWRAP)

                DESCRIPTION:      This word-processing field contains the data uploaded from the barcode reader.  Data is stored
                                  directly into this field with no modifications.  The only data that is not stored in this file
                                  during uploading of data is the first record (Identifier).  


                  DESCRIPTION:
                                    This word-processing field contains the data uploaded from the barcode reader.  







      FILES POINTED TO                      FIELDS

NEW PERSON (#200)                 CREATED BY (#.1)
                                  DATE/TIME OF DATA UPLOAD:UPLOAD USER (#.02)

SPECIALTY COMMANDS (#446.6)       SPECIALTY COMMANDS (#.09)



INPUT TEMPLATE(S):
PRCT DATA ENTER/EDIT/VIEW     NOV 09, 1989        USER #0    
PRCT PARAMETER (CREATOR)      APR 19, 1990@20:37  USER #0    
PRCT PARAMETER (USER)         APR 19, 1990@20:39  USER #0    
PRCT PROGRAM ENTER/EDIT       NOV 13, 1989        USER #0    

PRINT TEMPLATE(S):
PRCT DATA UPLOAD STATUS       NOV 13, 1989        USER #0                                                      BARCODE PROGRAM LIST

SORT TEMPLATE(S):
PRCT DATA UPLOAD STATUS       MAR 08, 1991@08:53  USER #0    
SORT BY: NAME//
  WITHIN NAME, SORT BY: DATE/TIME OF DATA UPLOAD//
  DATE/TIME OF DATA UPLOAD SUB-FIELD: DATE/TIME OF DATA UPLOAD//    (User is asked range)


FORM(S)/BLOCK(S):