| 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
 | 
|---|