Annotation of freem_fileman/DINIT124.m, revision 1.1

1.1     ! snw         1: DINIT124       ;SFISC/TKW - INITIALIZE V21 SORT TEMPLATE DD NODES ;6/24/94  11:16
        !             2:        ;;21.0;VA FileMan;;Dec 28, 1994
        !             3:        ;Per VHA Directive 10-93-142, this routine should not be modified.
        !             4:        F I=1:2 S X=$T(Q+I) Q:X=""  S Y=$E($T(Q+I+1),4,999),X=$E(X,4,999) S:$A(Y)=126 I=I+1,Y=$E(Y,2,999)_$E($T(Q+I+1),5,99) S:$A(Y)=61 Y=$E(Y,2,999) S @X=Y
        !             5: Q      Q
        !             6:        ;;^DD(.4014,10,21,2,0)
        !             7:        ;;=has been selected.  The code extracts the SORT field from that record
        !             8:        ;;^DD(.4014,10,21,3,0)
        !             9:        ;;=into a local variable.
        !            10:        ;;^DD(.4014,10,23,0)
        !            11:        ;;=^^1^1^2930115^
        !            12:        ;;^DD(.4014,10,23,1,0)
        !            13:        ;;=GET CODE can be generated by a call to FileMan routine GET^DIOU.
        !            14:        ;;^DD(.4014,10,"DT")
        !            15:        ;;=2930115
        !            16:        ;;^DD(.4014,11,0)
        !            17:        ;;=QUERY CONDITION^K^^QCON;E1,245^K:$L(X)>245 X D:$D(X) ^DIM
        !            18:        ;;^DD(.4014,11,3)
        !            19:        ;;=This is Standard MUMPS code used to test the field to see whether it meets the query condition (ex., whether it's within the from/to range specified by the user).
        !            20:        ;;^DD(.4014,11,9)
        !            21:        ;;=@
        !            22:        ;;^DD(.4014,11,21,0)
        !            23:        ;;=^^5^5^2930115^
        !            24:        ;;^DD(.4014,11,21,1,0)
        !            25:        ;;=The QUERY CONDITION is MUMPS code that takes a field in a local variable,
        !            26:        ;;^DD(.4014,11,21,2,0)
        !            27:        ;;=and executes some query condition.  The results of executing the code
        !            28:        ;;^DD(.4014,11,21,3,0)
        !            29:        ;;=will return a truth value of TRUE if the field met the condition, or
        !            30:        ;;^DD(.4014,11,21,4,0)
        !            31:        ;;=FALSE if not.  It is used, for example, to see whether a SORT FIELD falls
        !            32:        ;;^DD(.4014,11,21,5,0)
        !            33:        ;;=within the FROM/TO range requested by the user.
        !            34:        ;;^DD(.4014,11,23,0)
        !            35:        ;;=^^2^2^2930115^
        !            36:        ;;^DD(.4014,11,23,1,0)
        !            37:        ;;=The QUERY CONDITION code is generated by various calls to FileMan
        !            38:        ;;^DD(.4014,11,23,2,0)
        !            39:        ;;=routines DIOC*.
        !            40:        ;;^DD(.4014,11,"DT")
        !            41:        ;;=2930115
        !            42:        ;;^DD(.4014,12,0)
        !            43:        ;;=DESCRIPTION OF SORT^F^^TXT;E1,200^K:$L(X)>200!($L(X)<1) X
        !            44:        ;;^DD(.4014,12,3)
        !            45:        ;;=Answer must be 1-200 characters in length.  Text explaining the query condition (field name and what conditions must be met in order for the record to be selected).
        !            46:        ;;^DD(.4014,12,21,0)
        !            47:        ;;=^^4^4^2930115^
        !            48:        ;;^DD(.4014,12,21,1,0)
        !            49:        ;;=This field contains a brief textual description of the SORT FIELD and
        !            50:        ;;^DD(.4014,12,21,2,0)
        !            51:        ;;=the SORT CRITERIA used on it (i.e., the from/to values).  This
        !            52:        ;;^DD(.4014,12,21,3,0)
        !            53:        ;;=description can be printed in the heading of a report, at the users
        !            54:        ;;^DD(.4014,12,21,4,0)
        !            55:        ;;=request.
        !            56:        ;;^DD(.4014,12,23,0)
        !            57:        ;;=^^2^2^2930115^
        !            58:        ;;^DD(.4014,12,23,1,0)
        !            59:        ;;=This text is build as the developer answers the FROM/TO questions
        !            60:        ;;^DD(.4014,12,23,2,0)
        !            61:        ;;=during the SORT sequence.
        !            62:        ;;^DD(.4014,12,"DT")
        !            63:        ;;=2930115
        !            64:        ;;^DD(.4014,13,0)
        !            65:        ;;=SEARCH EFFICIENCY RATING^NJ9,4^^SER;1^K:+X'=X!(X>9999.9999)!(X<0)!(X?.E1"."5N.N) X
        !            66:        ;;^DD(.4014,13,3)
        !            67:        ;;=Type a Number between 0 and 9999.9999, 4 Decimal Digits.  Search efficiency number returned by Query Optimizer Routine.
        !            68:        ;;^DD(.4014,13,21,0)
        !            69:        ;;=^^7^7^2930125^
        !            70:        ;;^DD(.4014,13,21,1,0)
        !            71:        ;;=Fields are assigned a search efficiency rating based on the number of
        !            72:        ;;^DD(.4014,13,21,2,0)
        !            73:        ;;=hits found for the query (or sort) condition.  The fewer the hits, the
        !            74:        ;;^DD(.4014,13,21,3,0)
        !            75:        ;;=higher the rating.  A high rating indicates the criteria will more quickly
        !            76:        ;;^DD(.4014,13,21,4,0)
        !            77:        ;;=cut down the number of records to be processed.  The rating will be
        !            78:        ;;^DD(.4014,13,21,5,0)
        !            79:        ;;=higher if the field has a cross-reference.  The field with the highest
        !            80:        ;;^DD(.4014,13,21,6,0)
        !            81:        ;;=rating is used to do the initial loop through the file during the sort
        !            82:        ;;^DD(.4014,13,21,7,0)
        !            83:        ;;=phase.
        !            84:        ;;^DD(.4014,13,23,0)
        !            85:        ;;=^^1^1^2930125^
        !            86:        ;;^DD(.4014,13,23,1,0)
        !            87:        ;;=Calculated in the Query Optimizer routine ^DIOQ.
        !            88:        ;;^DD(.4014,13,"DT")
        !            89:        ;;=2930125
        !            90:        ;;^DD(.4014,14,0)
        !            91:        ;;=PROBABILITY RATING^NJ9,4^^SER;2^K:+X'=X!(X>9999.9999)!(X<0)!(X?.E1"."5N.N) X
        !            92:        ;;^DD(.4014,14,3)
        !            93:        ;;=Type a Number between 0 and 9999.9999, 4 Decimal Digits.  Probability of field meeting the sort criteria--returned by Query Optimizer routine.
        !            94:        ;;^DD(.4014,14,21,0)
        !            95:        ;;=^^6^6^2930125^^
        !            96:        ;;^DD(.4014,14,21,1,0)
        !            97:        ;;=Fields are assigned a probability rating based on the number of hits
        !            98:        ;;^DD(.4014,14,21,2,0)
        !            99:        ;;=found for the query (or sort) condition.  The probability rating is used
        !           100:        ;;^DD(.4014,14,21,3,0)
        !           101:        ;;=to determine the order in which query conditions should be executed
        !           102:        ;;^DD(.4014,14,21,4,0)
        !           103:        ;;=during the sort phase.  Fields with a higher probability rating are
        !           104:        ;;^DD(.4014,14,21,5,0)
        !           105:        ;;=executed first to most quickly cut down the number of records that have
        !           106:        ;;^DD(.4014,14,21,6,0)
        !           107:        ;;=to be processed.
        !           108:        ;;^DD(.4014,14,23,0)
        !           109:        ;;=^^1^1^2930125^
        !           110:        ;;^DD(.4014,14,23,1,0)
        !           111:        ;;=Calculated by a call to the FileMan Query Optimizer routine ^DIOQ.
        !           112:        ;;^DD(.4014,14,"DT")
        !           113:        ;;=2930125
        !           114:        ;;^DD(.4014,15,0)
        !           115:        ;;=DATA TYPE FOR SORTING^P.81'^DI(.81,^0;10^Q
        !           116:        ;;^DD(.4014,15,21,0)
        !           117:        ;;=^^5^5^2930514^

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>