Home   Package List   Routine Alphabetical List   Global Alphabetical List   FileMan Files List   FileMan Sub-Files List   Package Component Lists   Package-Namespace Mapping  
Routine: DINIT124

DINIT124.m

Go to the documentation of this file. 
  1. DINIT124 ;SFISC/MKO-SORT TEMPLATE FILE ;1:13 PM  13 Nov 1998
  1.  ;;22.0;VA FileMan;;Mar 30, 1999
  1.  ;Per VHA Directive 10-93-142, this routine should not be modified.
  1.  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
  1.  G ^DINIT125
  1. Q Q
  1.  ;;^DD(.4014,9,3)
  1.  ;;=First ^ piece null, second piece=static part of cross-reference, third piece=global reference, 4th piece=number of variable subscripts to get to (and including) record number.
  1.  ;;^DD(.4014,9,21,0)
  1.  ;;=^^8^8^2930115^
  1.  ;;^DD(.4014,9,21,1,0)
  1.  ;;= Piece 1 is always null
  1.  ;;^DD(.4014,9,21,2,0)
  1.  ;;= Piece 2 is the static part of the cross-reference: ex. DIZ(662001,"B",
  1.  ;;^DD(.4014,9,21,3,0)
  1.  ;;= Piece 3 is the global reference: ex. DIZ(662001,
  1.  ;;^DD(.4014,9,21,4,0)
  1.  ;;= Piece 4 tells FileMan how many variable subscripts must be sorted
  1.  ;;^DD(.4014,9,21,5,0)
  1.  ;;=through to get to the record number, plus 1 for the record number
  1.  ;;^DD(.4014,9,21,6,0)
  1.  ;;=itself.  ex. for a regular cross-reference, ^DIZ(662001,"B",X,DA),
  1.  ;;^DD(.4014,9,21,7,0)
  1.  ;;=the number is 2.  One for the value of the X subscript, and one for the
  1.  ;;^DD(.4014,9,21,8,0)
  1.  ;;=record number itself (DA).
  1.  ;;^DD(.4014,9,23,0)
  1.  ;;=^^6^6^2930115^
  1.  ;;^DD(.4014,9,23,1,0)
  1.  ;;=The IX nodes are normally derived by FileMan during the entry of sort
  1.  ;;^DD(.4014,9,23,2,0)
  1.  ;;=fields (in routine XR^DIP).  However, they can also be passed to the
  1.  ;;^DD(.4014,9,23,3,0)
  1.  ;;=print (^DIP) in the BY(0) variable to cause FileMan to either use a MUMPS
  1.  ;;^DD(.4014,9,23,4,0)
  1.  ;;=type cross-reference, or a previously sorted list of record numbers.
  1.  ;;^DD(.4014,9,23,5,0)
  1.  ;;=Fileman sometimes builds the IX node prior to calling the print, as in
  1.  ;;^DD(.4014,9,23,6,0)
  1.  ;;=the INQUIRE option, where the user then goes on to print the records.
  1.  ;;^DD(.4014,9,"DT")
  1.  ;;=2930115
  1.  ;;^DD(.4014,9.5,0)
  1.  ;;=POINT TO CROSS REFERENCE^F^^PTRIX;E1,245^K:$L(X)>245!($L(X)<1) X
  1.  ;;^DD(.4014,9.5,3)
  1.  ;;=Enter global reference for "B" index of .01 field on pointed-to file.  Answer must be 1-245 characters in length.
  1.  ;;^DD(.4014,9.5,21,0)
  1.  ;;=^^7^7^2931221^
  1.  ;;^DD(.4014,9.5,21,1,0)
  1.  ;;=This node will exist only if the sort field is a pointer, if the sort
  1.  ;;^DD(.4014,9.5,21,2,0)
  1.  ;;=field has a regular cross-reference, if the .01 field on the pointed-to
  1.  ;;^DD(.4014,9.5,21,3,0)
  1.  ;;=file has a "B" index, and if the .01 field on the pointed-to file is
  1.  ;;^DD(.4014,9.5,21,4,0)
  1.  ;;=either a numeric, date, set-of-codes or free-text field, and does not have
  1.  ;;^DD(.4014,9.5,21,5,0)
  1.  ;;=an output transform.  If this node exists, it will be set to the static
  1.  ;;^DD(.4014,9.5,21,6,0)
  1.  ;;=part of the global reference of the "B" index on the pointed-to file. (ex.
  1.  ;;^DD(.4014,9.5,21,7,0)
  1.  ;;=^DIZ(662001,"B",).
  1.  ;;^DD(.4014,9.5,"DT")
  1.  ;;=2931221
  1.  ;;^DD(.4014,10,0)
  1.  ;;=GET CODE^K^^GET;E1,245^K:$L(X)>245 X D:$D(X) ^DIM
  1.  ;;^DD(.4014,10,3)
  1.  ;;=This is Standard MUMPS code used to extract the sort field from a record.
  1.  ;;^DD(.4014,10,9)
  1.  ;;=@
  1.  ;;^DD(.4014,10,21,0)
  1.  ;;=^^3^3^2930115^
  1.  ;;^DD(.4014,10,21,1,0)
  1.  ;;=The GET CODE is MUMPS code that is executed after a record (or sub-record)
  1.  ;;^DD(.4014,10,21,2,0)
  1.  ;;=has been selected.  The code extracts the SORT field from that record
  1.  ;;^DD(.4014,10,21,3,0)
  1.  ;;=into a local variable.
  1.  ;;^DD(.4014,10,23,0)
  1.  ;;=^^1^1^2930115^
  1.  ;;^DD(.4014,10,23,1,0)
  1.  ;;=GET CODE can be generated by a call to FileMan routine GET^DIOU.
  1.  ;;^DD(.4014,10,"DT")
  1.  ;;=2930115
  1.  ;;^DD(.4014,11,0)
  1.  ;;=QUERY CONDITION^K^^QCON;E1,245^K:$L(X)>245 X D:$D(X) ^DIM
  1.  ;;^DD(.4014,11,3)
  1.  ;;=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).
  1.  ;;^DD(.4014,11,9)
  1.  ;;=@
  1.  ;;^DD(.4014,11,21,0)
  1.  ;;=^^5^5^2930115^
  1.  ;;^DD(.4014,11,21,1,0)
  1.  ;;=The QUERY CONDITION is MUMPS code that takes a field in a local variable,
  1.  ;;^DD(.4014,11,21,2,0)
  1.  ;;=and executes some query condition.  The results of executing the code
  1.  ;;^DD(.4014,11,21,3,0)
  1.  ;;=will return a truth value of TRUE if the field met the condition, or
  1.  ;;^DD(.4014,11,21,4,0)
  1.  ;;=FALSE if not.  It is used, for example, to see whether a SORT FIELD falls
  1.  ;;^DD(.4014,11,21,5,0)
  1.  ;;=within the FROM/TO range requested by the user.
  1.  ;;^DD(.4014,11,23,0)
  1.  ;;=^^2^2^2930115^
  1.  ;;^DD(.4014,11,23,1,0)
  1.  ;;=The QUERY CONDITION code is generated by various calls to FileMan
  1.  ;;^DD(.4014,11,23,2,0)
  1.  ;;=routines DIOC*.
  1.  ;;^DD(.4014,11,"DT")
  1.  ;;=2930115
  1.  ;;^DD(.4014,12,0)
  1.  ;;=DESCRIPTION OF SORT^F^^TXT;E1,200^K:$L(X)>200!($L(X)<1) X
  1.  ;;^DD(.4014,12,3)
  1.  ;;=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).
  1.  ;;^DD(.4014,12,21,0)
  1.  ;;=^^4^4^2930115^
  1.  ;;^DD(.4014,12,21,1,0)
  1.  ;;=This field contains a brief textual description of the SORT FIELD and
  1.  ;;^DD(.4014,12,21,2,0)
  1.  ;;=the SORT CRITERIA used on it (i.e., the from/to values).  This
  1.  ;;^DD(.4014,12,21,3,0)
  1.  ;;=description can be printed in the heading of a report, at the users
  1.  ;;^DD(.4014,12,21,4,0)
  1.  ;;=request.
  1.  ;;^DD(.4014,12,23,0)
  1.  ;;=^^2^2^2930115^
  1.  ;;^DD(.4014,12,23,1,0)
  1.  ;;=This text is build as the developer answers the FROM/TO questions
  1.  ;;^DD(.4014,12,23,2,0)
  1.  ;;=during the SORT sequence.
  1.  ;;^DD(.4014,12,"DT")
  1.  ;;=2930115
  1.  ;;^DD(.4014,13,0)
  1.  ;;=SEARCH EFFICIENCY RATING^NJ9,4^^SER;1^K:+X'=X!(X>9999.9999)!(X<0)!(X?.E1"."5N.N) X
  1.  ;;^DD(.4014,13,3)
  1.  ;;=Type a Number between 0 and 9999.9999, 4 Decimal Digits.  Search efficiency number returned by Query Optimizer Routine.
  1.  ;;^DD(.4014,13,21,0)
  1.  ;;=^^7^7^2930125^
  1.  ;;^DD(.4014,13,21,1,0)
  1.  ;;=Fields are assigned a search efficiency rating based on the number of
  1.  ;;^DD(.4014,13,21,2,0)
  1.  ;;=hits found for the query (or sort) condition.  The fewer the hits, the
  1.  ;;^DD(.4014,13,21,3,0)
  1.  ;;=higher the rating.  A high rating indicates the criteria will more quickly
  1.  ;;^DD(.4014,13,21,4,0)
  1.  ;;=cut down the number of records to be processed.  The rating will be
  1.  ;;^DD(.4014,13,21,5,0)
  1.  ;;=higher if the field has a cross-reference.  The field with the highest
  1.  ;;^DD(.4014,13,21,6,0)
  1.  ;;=rating is used to do the initial loop through the file during the sort
  1.  ;;^DD(.4014,13,21,7,0)
  1.  ;;=phase.
  1.  ;;^DD(.4014,13,23,0)
  1.  ;;=^^1^1^2930125^
  1.  ;;^DD(.4014,13,23,1,0)
  1.  ;;=Calculated in the Query Optimizer routine ^DIOQ.
  1.  ;;^DD(.4014,13,"DT")
  1.  ;;=2930125
  1.  ;;^DD(.4014,14,0)
  1.  ;;=PROBABILITY RATING^NJ9,4^^SER;2^K:+X'=X!(X>9999.9999)!(X<0)!(X?.E1"."5N.N) X
  1.  ;;^DD(.4014,14,3)
  1.  ;;=Type a Number between 0 and 9999.9999, 4 Decimal Digits.  Probability of field meeting the sort criteria--returned by Query Optimizer routine.
  1.  ;;^DD(.4014,14,21,0)
  1.  ;;=^^6^6^2930125^^