| 1 | HLDIEDB2 ;CIOFO-O/LJA - Debug $$STORESCR Code ;1/9/04 @ 09:01 | 
|---|
| 2 | ;;1.6;HEALTH LEVEL SEVEN;**109**;Oct 13,1995 | 
|---|
| 3 | ; | 
|---|
| 4 | STORESCR(RTN,LOC,STORE) ; Called by Xecutable M code to set or "unset" (don't | 
|---|
| 5 | ; collect) data... | 
|---|
| 6 | ; | 
|---|
| 7 | ; Steps to add SCREEN logic below | 
|---|
| 8 | ; ------------------------------- | 
|---|
| 9 | ; (1) Add M code that evaluates environment and optionally sets STORE. | 
|---|
| 10 | ; (2) Update NEWs at top of STORESCR | 
|---|
| 11 | ; | 
|---|
| 12 | ; Error Handling | 
|---|
| 13 | ; -------------- | 
|---|
| 14 | ; What if your M code errors out?  You don't want the call to | 
|---|
| 15 | ; FILE^HLDIE failing.  But, you do want to be notified about the | 
|---|
| 16 | ; error.  For this reason, error trapping has been added to this | 
|---|
| 17 | ; $$STORESCR API. | 
|---|
| 18 | ; | 
|---|
| 19 | ; In order to set up error handling, you must define in your M code | 
|---|
| 20 | ; the users who should receive an "error notification email message." | 
|---|
| 21 | ; Do this by defining the SENDUZ(DUZ)="" array, with one entry for | 
|---|
| 22 | ; each recipient of the message. | 
|---|
| 23 | ; | 
|---|
| 24 | ; | 
|---|
| 25 | ; >>> Step #2 - Update NEWS After M Code Creations <<< | 
|---|
| 26 | N SENDUZ | 
|---|
| 27 | ; | 
|---|
| 28 | I ^%ZOSF("OS")["DSM" N $ETRAP S $ET="" | 
|---|
| 29 | S X="ERR^HLDIEDB1",@^%ZOSF("TRAP") | 
|---|
| 30 | ; | 
|---|
| 31 | ; RTN = RTN~SUBRTN | 
|---|
| 32 | ; LOC = 1 if at top of FILE^HLDIE call | 
|---|
| 33 | ;     = 2 if at bottom of FILE^HLDIE call | 
|---|
| 34 | ; STORE = "",1,2 (see below) | 
|---|
| 35 | ; | 
|---|
| 36 | ; STORE can be set to the following value... | 
|---|
| 37 | ; | 
|---|
| 38 | ; "" - Don't store anything | 
|---|
| 39 | ;  1 - Store "select" data | 
|---|
| 40 | ;  2 - Store all data | 
|---|
| 41 | ; | 
|---|
| 42 | ; Warning!  The only acceptable action by this API is to change the | 
|---|
| 43 | ;           value of STORE. | 
|---|
| 44 | ; | 
|---|
| 45 | ; >>> Step #1 - M Code Starts Here <<< | 
|---|
| 46 | ; | 
|---|
| 47 | ; Create list of recipients of error notification message now! | 
|---|
| 48 | ; | 
|---|
| 49 | ; | 
|---|
| 50 | ; | 
|---|
| 51 | ; | 
|---|
| 52 | ; | 
|---|
| 53 | ; | 
|---|
| 54 | ; | 
|---|
| 55 | ; | 
|---|
| 56 | ; >>> M Code Ends Here <<< | 
|---|
| 57 | ; | 
|---|
| 58 | Q STORE | 
|---|
| 59 | ; | 
|---|
| 60 | EOR ;HLDIEDB2 - Debug $$STORESCR Code ;1/9/04 @ 09:01 | 
|---|