| [613] | 1 | ENTIUTL1        ;WOIFO/SAB - Engineering Utilities ;2/4/2008 | 
|---|
|  | 2 | ;;7.0;ENGINEERING;**87**;Aug 17, 1993;Build 16 | 
|---|
|  | 3 | ; this routine contains APIs that create or modify IT assignment data | 
|---|
|  | 4 | ; | 
|---|
|  | 5 | ASGN(ENDA,EN200)        ; Assign Equipment Responsibility | 
|---|
|  | 6 | ; input | 
|---|
|  | 7 | ;   ENDA = equipment ien (file 6914) | 
|---|
|  | 8 | ;   EN200 = owner ien (file 200) | 
|---|
|  | 9 | ; returns value = | 
|---|
|  | 10 | ;    0 (already exists) or | 
|---|
|  | 11 | ;    E (error) or | 
|---|
|  | 12 | ;    internal entry number of the created record (positive integer) | 
|---|
|  | 13 | N ENERR,ENFDA,ENIEN,ENRET | 
|---|
|  | 14 | S ENRET=0 | 
|---|
|  | 15 | ; only create if owner does not have an active assignment for the item | 
|---|
|  | 16 | I '$D(^ENG(6916.3,"AOA",EN200,ENDA)) D | 
|---|
|  | 17 | . S ENFDA(6916.3,"+1,",.01)=ENDA | 
|---|
|  | 18 | . S ENFDA(6916.3,"+1,",1)=EN200 | 
|---|
|  | 19 | . S ENFDA(6916.3,"+1,",2)=$$NOW^XLFDT() | 
|---|
|  | 20 | . S ENFDA(6916.3,"+1,",3)=DUZ | 
|---|
|  | 21 | . D UPDATE^DIE("","ENFDA","ENIEN","ENERR") | 
|---|
|  | 22 | . S ENRET=$S($D(ENERR):"E",1:ENIEN(1)) | 
|---|
|  | 23 | ; | 
|---|
|  | 24 | Q ENRET | 
|---|
|  | 25 | ; | 
|---|
|  | 26 | SIGN(ENDA)      ; Sign Equipment Responsibility | 
|---|
|  | 27 | ; input | 
|---|
|  | 28 | ;   ENDA = assignment ien (file 6916.3) | 
|---|
|  | 29 | ; returns value = 1 (signed) or 0 (not active) or E (error) | 
|---|
|  | 30 | N ENERR,ENFDA,ENHRT,ENRET,ENSTR,ENSTRH,ENY,X,X1,X2 | 
|---|
|  | 31 | S ENRET=0 | 
|---|
|  | 32 | ; only sign if assignment is active | 
|---|
|  | 33 | I $P($G(^ENG(6916.3,ENDA,0)),U,8)="" D | 
|---|
|  | 34 | . S ENHRT=$O(^ENG(6916.2," "),-1) ; current hand receipt text ien | 
|---|
|  | 35 | . I 'ENHRT S ENRET="E" Q  ; required | 
|---|
|  | 36 | . ; | 
|---|
|  | 37 | . ; if already signed or certified then retain that data in history | 
|---|
|  | 38 | . D SAVSIG | 
|---|
|  | 39 | . I $D(ENERR) S ENRET="E" Q  ; error during DBS call | 
|---|
|  | 40 | . ; | 
|---|
|  | 41 | . ; build signature block string | 
|---|
|  | 42 | . S ENY=$G(^ENG(6916.3,ENDA,0)) | 
|---|
|  | 43 | . S ENSTR=$$ESBLOCK^XUSESIG1() | 
|---|
|  | 44 | . S ENSTR=ENSTR_U_$P(ENY,U) ; equipment ien | 
|---|
|  | 45 | . S ENSTR=ENSTR_U_$P(ENY,U,2) ; owner ien | 
|---|
|  | 46 | . S ENSTR=ENSTR_U_ENHRT ; hand receipt text ien | 
|---|
|  | 47 | . S ENSTR=ENSTR_U_$$GET1^DIQ(6916.2,ENHRT,3) ; hand receipt checksum | 
|---|
|  | 48 | . S X=ENSTR,X1=ENDA,X2=1 D EN^XUSHSHP S ENSTRH=X ; hashed string | 
|---|
|  | 49 | . ; | 
|---|
|  | 50 | . ; set up FDA array for DBS call | 
|---|
|  | 51 | . S ENFDA(6916.3,ENDA_",",4)=$P(ENSTR,U,4) ; signed date/time | 
|---|
|  | 52 | . S ENFDA(6916.3,ENDA_",",5)=ENHRT ; hand receipt text | 
|---|
|  | 53 | . S ENFDA(6916.3,ENDA_",",5.9)="@" ; may be leftover from prior cert | 
|---|
|  | 54 | . S ENFDA(6916.3,ENDA_",",6)="@" ; may be leftover from prior cert | 
|---|
|  | 55 | . S ENFDA(6916.3,ENDA_",",9)=ENSTRH ; encrypted string | 
|---|
|  | 56 | . ; | 
|---|
|  | 57 | . D FILE^DIE("","ENFDA","ENERR") | 
|---|
|  | 58 | . S ENRET=$S($D(ENERR):"E",1:1) | 
|---|
|  | 59 | ; | 
|---|
|  | 60 | Q ENRET | 
|---|
|  | 61 | ; | 
|---|
|  | 62 | CERT(ENDA,ENDT) ; Certify Signature for Equipment Responsibility | 
|---|
|  | 63 | ; input | 
|---|
|  | 64 | ;   ENDA = assignment ien (file 6916.3) | 
|---|
|  | 65 | ;   ENDT = date of signature (FileMan internal date) | 
|---|
|  | 66 | ; returns value = 1 (created) or 0 (not active) or E (error) | 
|---|
|  | 67 | N ENERR,ENFDA,ENHRT,ENRET | 
|---|
|  | 68 | S ENRET=0 | 
|---|
|  | 69 | ; only certify if assignment is active | 
|---|
|  | 70 | I $P($G(^ENG(6916.3,ENDA,0)),U,8)="" D | 
|---|
|  | 71 | . I $G(ENDT)'?7N S ENRET="E" Q  ; required | 
|---|
|  | 72 | . ; | 
|---|
|  | 73 | . S ENHRT=$O(^ENG(6916.2," "),-1) ; current hand receipt text ien | 
|---|
|  | 74 | . I 'ENHRT S ENRET="E" Q  ; required | 
|---|
|  | 75 | . ; | 
|---|
|  | 76 | . ; if already signed or certified then retain that data in history | 
|---|
|  | 77 | . D SAVSIG | 
|---|
|  | 78 | . I $D(ENERR) S ENRET="E" Q  ; error during DBS call | 
|---|
|  | 79 | . ; | 
|---|
|  | 80 | . ; set data for a certification | 
|---|
|  | 81 | . S ENFDA(6916.3,ENDA_",",4)=ENDT | 
|---|
|  | 82 | . S ENFDA(6916.3,ENDA_",",5)=ENHRT | 
|---|
|  | 83 | . S ENFDA(6916.3,ENDA_",",5.9)=$$NOW^XLFDT() | 
|---|
|  | 84 | . S ENFDA(6916.3,ENDA_",",6)=DUZ | 
|---|
|  | 85 | . S ENFDA(6916.3,ENDA_",",9)="@" ; may be leftover from prior e-sig | 
|---|
|  | 86 | . ; | 
|---|
|  | 87 | . D FILE^DIE("","ENFDA","ENERR") | 
|---|
|  | 88 | . S ENRET=$S($D(ENERR):"E",1:1) | 
|---|
|  | 89 | ; | 
|---|
|  | 90 | Q ENRET | 
|---|
|  | 91 | ; | 
|---|
|  | 92 | TERM(ENDA)      ; Terminate Equipment Responsibility Assignment | 
|---|
|  | 93 | ; input | 
|---|
|  | 94 | ;   ENDA = assignment ien (file 6916.3) | 
|---|
|  | 95 | ; returns value = 1 (created) or 0 (not active) or E (error) | 
|---|
|  | 96 | N ENERR,ENFDA,ENRET | 
|---|
|  | 97 | S ENRET=0 | 
|---|
|  | 98 | ; only terminate if assignment is active | 
|---|
|  | 99 | I $P($G(^ENG(6916.3,ENDA,0)),U,8)="" D | 
|---|
|  | 100 | . S ENFDA(6916.3,ENDA_",",7)=$$NOW^XLFDT() | 
|---|
|  | 101 | . S ENFDA(6916.3,ENDA_",",8)=DUZ | 
|---|
|  | 102 | . D FILE^DIE("","ENFDA","ENERR") | 
|---|
|  | 103 | . S ENRET=$S($D(ENERR):"E",1:1) | 
|---|
|  | 104 | ; | 
|---|
|  | 105 | Q ENRET | 
|---|
|  | 106 | ; | 
|---|
|  | 107 | SAVSIG  ; Save current signature data (if any) to previous signature multiple | 
|---|
|  | 108 | ; input ENDA = ien of assignment (file 6916.3) | 
|---|
|  | 109 | ; result = may create entry in subfile 6916.31 | 
|---|
|  | 110 | ; output ENERR - only defined if there was an error during DBS call | 
|---|
|  | 111 | N ENFDA,ENY,ENY1 | 
|---|
|  | 112 | ; if already signed or certified then retain that data in history | 
|---|
|  | 113 | S ENY=$G(^ENG(6916.3,ENDA,0)) | 
|---|
|  | 114 | Q:'$P(ENY,U,5)  ; not signed or certified | 
|---|
|  | 115 | S ENY1=$G(^ENG(6916.3,ENDA,1)) | 
|---|
|  | 116 | ; | 
|---|
|  | 117 | S ENFDA(6916.31,"+1,"_ENDA_",",.01)=$P(ENY,U,5) | 
|---|
|  | 118 | I $P(ENY,U,6) S ENFDA(6916.31,"+1,"_ENDA_",",1)=$P(ENY,U,6) | 
|---|
|  | 119 | I $P(ENY,U,10) S ENFDA(6916.31,"+1,"_ENDA_",",2)=$P(ENY,U,10) | 
|---|
|  | 120 | I $P(ENY,U,7) S ENFDA(6916.31,"+1,"_ENDA_",",3)=$P(ENY,U,7) | 
|---|
|  | 121 | I $P(ENY1,U)]"" S ENFDA(6916.31,"+1,"_ENDA_",",4)=$P(ENY1,U) | 
|---|
|  | 122 | ; | 
|---|
|  | 123 | D UPDATE^DIE("","ENFDA","","ENERR") | 
|---|
|  | 124 | ; | 
|---|
|  | 125 | Q | 
|---|
|  | 126 | ; | 
|---|
|  | 127 | ;ENTIUTL1 | 
|---|