Stata
Shell के ज़रिए curl इस्तेमाल करता है: Windows 10 और 11 पर curl.exe, macOS और Linux पर curl (code c(os) से एक चुनता है, इसलिए वही do-file हर जगह चलती है)। Batch mode में Stata हमेशा 0 के साथ exit करता है, इसलिए error do-file के अंदर पकड़ा जाता है और Stata के r() code के साथ भेजा जाता है। tb_log को do-file के log पर set करें (stata -b do job.do, job.log लिखता है), तो उसकी आखिरी 20 lines failure के साथ जाती हैं।
Code
यह वह code है जो Code टैब बनाता है (start, errors और rows पर निशान लगाकर)। App में इसमें पहले से आपके job का अपना पता होता है।
* --- TaskBeacon: top of the do-file ---
local tb "https://taskbeacon.io/ping/your-job-id"
* curl.exe is built into Windows 10 and 11; macOS and Linux have curl
local tb_curl = cond(c(os) == "Windows", "curl.exe", "curl")
local tb_log "" // optional: this do-file's log (batch mode: stata -b do job.do, or StataMP-64.exe /e do job.do on Windows, writes job.log in the current folder); its last 20 lines go with a failure
shell `tb_curl' -fsS -m 10 "`tb'/start"
capture noisily {
* --- your code here (the example data: replace with your own) ---
sysuse auto, clear
}
quietly {
local tb_rc = _rc
if `tb_rc' {
* the last 20 lines of the log (if tb_log is set) go with the failure
local tb_data ""
if `"`tb_log'"' != "" {
tempfile tb_tail
tempname tb_in tb_out
capture {
file open `tb_in' using `"`tb_log'"', read text
local tb_n 0
file read `tb_in' tb_line
while r(eof) == 0 {
local tb_n = `tb_n' + 1
local tb_k = mod(`tb_n', 20)
local tb_l`tb_k' = substr(`"`macval(tb_line)'"', 1, 300)
file read `tb_in' tb_line
}
file close `tb_in'
file open `tb_out' using `"`tb_tail'"', write text replace
forvalues tb_i = `=max(1, `tb_n' - 19)'/`tb_n' {
local tb_k = mod(`tb_i', 20)
file write `tb_out' `"`macval(tb_l`tb_k')'"' _n
}
file close `tb_out'
local tb_data `"--data-binary "@`tb_tail'" -H "Content-Type: text/plain""'
}
capture file close `tb_in'
capture file close `tb_out'
}
shell `tb_curl' -fsS -m 10 `tb_data' "`tb'/fail?rc=`tb_rc'"
exit `tb_rc'
}
}
* --- TaskBeacon: end of the do-file ---
local tb_rows = _N
shell `tb_curl' -fsS -m 10 "`tb'?rows=`tb_rows'"यह कैसे काम करता है
Script शुरू होने पर code /start ping करता है, ठीक से खत्म होने पर row count के साथ सादा address, और fail होने पर /fail, Stata के return code के साथ और, अगर tb_log set है, तो log की आखिरी 20 lines के साथ।
किसी हिस्से को छोड़ने के लिए Code टैब पर विकल्पों का निशान हटाएँ; कोई output न भेजकर सिर्फ़ error या exit code भेजने के लिए Send output lines (output लाइनें भेजें) का निशान हटाएँ। देखें क्या रिपोर्ट किया जा सकता है।
Do-file को schedule पर चलाएँ
Stata for Windows /e switch से do-file को बिना window के चलाता है (/b के साथ वह आपके OK click करने का इंतज़ार करता है, जो schedule नहीं कर सकता)। अपने Stata edition का पूरा path इस्तेमाल करें:
"C:\Program Files\Stata18\StataMP-64.exe" /e do "C:\jobs\sales.do"
इसे हर सुबह शुरू करने के लिए Command Prompt से एक task बनाएँ (एक line):
schtasks /Create /TN "Sales report" /SC DAILY /ST 06:00 /TR "\"C:\Program Files\Stata18\StataMP-64.exe\" /e do \"C:\jobs\sales.do\""
macOS या Linux पर इसे cron से batch mode में चलाएँ (crontab -e; program का नाम आपके edition पर निर्भर करता है, जैसे stata-mp):
0 6 * * * cd /home/me/jobs && /usr/local/stata/stata-mp -b do sales.do
ऊपर का code Windows पर curl.exe और बाक़ी जगह curl इस्तेमाल करता है (यह c(os) जाँचता है), इसलिए वही do-file हर machine पर काम करती है।
Stata sales.log को अपने working folder में लिखता है। Task Scheduler में Start in को do-file के folder पर सेट करें (task को Edit करें → Actions → Start in), वरना log Stata के program folder में जा सकता है, जिसमें आम तौर पर आप लिख नहीं सकते (तब Stata r(608) के साथ रुक जाता है)।
Exit code झूठ क्यों बोलता है
जब batch mode में do-file किसी error पर रुकती है, तो error log में होती है, लेकिन Stata ख़ुद Windows को इसे failure के रूप में नहीं बताता: Task Scheduler फिर भी The operation completed successfully (0x0) दिखाता है।
इसीलिए ऊपर का code आपके काम को capture noisily { … } में लपेटता है: do-file अपनी error ख़ुद पकड़ती है, Stata के return code के साथ /fail?rc= भेजती है (उदाहरण के लिए rc=601, file not found), और फिर exit से रुक जाती है।
जो कुछ भी fail हो सकता है, उसे braces के अंदर रखें। Closing brace के बाद का कोई command fail हो, तो वह पकड़ा नहीं जाता।
Row count भेजें
आख़िरी line _N भेजती है, यानी do-file ख़त्म होने पर memory में मौजूद observations की संख्या। अगर जो dataset आपके लिए मायने रखता है वह अंत में memory वाला dataset नहीं है, तो उसे वहीं गिनें जहाँ वह है:
use "C:\data\sales_clean.dta", clear
local tb_rows = _N
जब rows हाल के runs से 40% से ज़्यादा कम हो जाती हैं या 0 होती हैं, तो TaskBeacon alert भेजता है। दोनों rules आप job page पर बदल सकते हैं।
आम समस्याएँ
- कोई ping नहीं आता।
shellWindows परcurl.exe(Windows 10 और 11 में पहले से मौजूद) या macOS और Linux परcurlचलाता है। उसी machine पर Command Prompt या terminal में curl line चलाएँ; HTTPS को block करने वाला proxy या firewall वहाँ पता चल जाता है। - एक काली window झपकती है (Windows)। यह
shellहै जो curl के लिए console खोलता है; इससे कोई नुक़सान नहीं। - Start आता है पर finish कभी नहीं। Do-file
capture noisilyके बाहर रुक गई, या Stata को बंद कर दिया गया। Grace time के बाद job “Late” (देर से) दिखता है। - Network drives. जो task आपके logged out रहते चलता है, उसे
S:जैसे mapped drive letters नहीं दिखते; UNC paths (\\server\share\…) इस्तेमाल करें।
उपयोग के उदाहरण: Stata do-file batch mode में fail हो तो alert पाएँ। और सवाल: FAQ.