[0001]
[0002]
[0003]
[0004]
[0005]
[0006]
[0007]
[0008]
[0009]
[0010]
[0011]
[0012]
[0013]
[0014]
[0015]
[0016]
[0017]
[0018]
[0019]
[0020]
[0021]
[0022]
[0023]
[0024]
[0025]
[0026]
[0027]
[0028]
[0029]
[0030]
[0031]
[0032]
[0033]
[0034]
[0035]
[0036]
[0037]
[0038]
[0039]
[0040]
[0041]
[0042]
[0043]
[0044]
[0045]
[0046]
[0047]
[0048]
[0049]
[0050]
[0051]
[0052]
[0053]
[0054]
[0055]
[0056]
[0057]
[0058]
[0059]
[0060]
[0061]
[0062]
[0063]
[0064]
[0065]
[0066]
[0067]
[0068]
[0069]
[0070]
[0071]
[0072]
[0073]
[0074]
[0075]
[0076]
[0077]
[0078]
[0079]
[0080]
[0081]
[0082]
[0083]
[0084]
[0085]
[0086]
[0087]
[0088]
[0089]
[0090]
[0091]
[0092]
[0093]
[0094]
[0095]
[0096]
[0097]
[0098]
[0099]
[0100]
[0101]
[0102]
[0103]
[0104]
[0105]
[0106]
[0107]
[0108]
[0109]
[0110]
[0111]
[0112]
[0113]
[0114]
[0115]
[0116]
[0117]
[0118]
[0119]
[0120]
[0121]
[0122]
[0123]
[0124]
[0125]
[0126]
[0127]
[0128]
[0129]
[0130]
[0131]
[0132]
[0133]
[0134]
[0135]
[0136]
[0137]
[0138]
[0139]
[0140]
[0141]
[0142]
[0143]
[0144]
[0145]
[0146]
[0147]
[0148]
[0149]
[0150]
[0151]
[0152]
[0153]
[0154]
[0155]
[0156]
[0157]
[0158]
[0159]
[0160]
[0161]
[0162]
[0163]
[0164]
[0165]
[0166]
[0167]
[0168]
[0169]
[0170]
[0171]
[0172]
[0173]
[0174]
[0175]
[0176]
[0177]
[0178]
[0179]
[0180]
[0181]
[0182]
[0183]
[0184]
[0185]
[0186]
[0187]
[0188]
[0189]
[0190]
[0191]
[0192]
[0193]
[0194]
[0195]
[0196]
[0197]
[0198]
[0199]
[0200]
[0201]
[0202]
[0203]
[0204]
[0205]
[0206]
[0207]
[0208]
[0209]
[0210]
[0211]
[0212]
[0213]
[0214]
[0215]
[0216]
[0217]
[0218]
[0219]
[0220]
[0221]
[0222]
[0223]
[0224]
[0225]
[0226]
[0227]
[0228]
[0229]
[0230]
[0231]
[0232]
[0233]
[0234]
[0235]
[0236]
[0237]
[0238]
[0239]
[0240]
[0241]
[0242]
[0243]
[0244]
[0245]
[0246]
[0247]
[0248]
[0249]
[0250]
[0251]
[0252]
[0253]
[0254]
[0255]
[0256]
[0257]
[0258]
[0259]
[0260]
[0261]
[0262]
[0263]
[0264]
[0265]
[0266]
[0267]
[0268]
[0269]
[0270]
[0271]
[0272]
[0273]
[0274]
[0275]
[0276]
[0277]
[0278]
[0279]
[0280]
[0281]
[0282]
[0283]
[0284]
[0285]
[0286]
[0287]
[0288]
[0289]
[0290]
[0291]
[0292]
[0293]
[0294]
[0295]
[0296]
[0297]
[0298]
[0299]
[0300]
[0301]
[0302]
[0303]
[0304]
[0305]
[0306]
[0307]
[0308]
[0309]
[0310]
[0311]
[0312]
[0313]
[0314]
[0315]
[0316]
[0317]
[0318]
[0319]
[0320]
[0321]
[0322]
[0323]
[0324]
[0325]
[0326]
[0327]
[0328]
[0329]
[0330]
[0331]
[0332]
[0333]
[0334]
[0335]
[0336]
[0337]
[0338]
[0339]
[0340]
[0341]
[0342]
[0343]
[0344]
[0345]
[0346]
[0347]
[0348]
[0349]
[0350]
[0351]
[0352]
[0353]
[0354]
[0355]
[0356]
[0357]
[0358]
[0359]
[0360]
[0361]
[0362]
[0363]
[0364]
[0365]
[0366]
[0367]
[0368]
[0369]
[0370]
[0371]
[0372]
[0373]
[0374]
[0375]
[0376]
[0377]
[0378]
[0379]
[0380]
[0381]
[0382]
[0383]
[0384]
[0385]
[0386]
[0387]
[0388]
[0389]
[0390]
[0391]
[0392]
[0393]
[0394]
[0395]
[0396]
[0397]
[0398]
[0399]
[0400]
[0401]
[0402]
[0403]
[0404]
[0405]
[0406]
[0407]
[0408]
[0409]
[0410]
[0411]
[0412]
[0413]
[0414]
[0415]
[0416]
[0417]
[0418]
[0419]
[0420]
[0421]
[0422]
[0423]
[0424]
[0425]
[0426]
[0427]
[0428]
[0429]
[0430]
[0431]
[0432]
[0433]
[0434]
[0435]
[0436]
[0437]
[0438]
[0439]
[0440]
[0441]
[0442]
[0443]
[0444]
[0445]
[0446]
[0447]
[0448]
[0449]
[0450]
[0451]
[0452]
[0453]
[0454]
[0455]
[0456]
[0457]
[0458]
[0459]
[0460]
[0461]
[0462]
[0463]
[0464]
[0465]
[0466]
[0467]
[0468]
[0469]
[0470]
[0471]
[0472]
[0473]
[0474]
[0475]
[0476]
[0477]
[0478]
[0479]
[0480]
[0481]
[0482]
[0483]
[0484]
[0485]
[0486]
[0487]
[0488]
[0489]
[0490]
[0491]
[0492]
[0493]
[0494]
[0495]
[0496]
[0497]
[0498]
[0499]
[0500]
[0501]
[0502]
[0503]
[0504]
[0505]
[0506]
[0507]
[0508]
[0509]
[0510]
[0511]
[0512]
[0513]
[0514]
[0515]
[0516]
[0517]
[0518]
[0519]
[0520]
[0521]
[0522]
[0523]
[0524]
[0525]
[0526]
[0527]
[0528]
[0529]
[0530]
[0531]
[0532]
[0533]
[0534]
[0535]
[0536]
[0537]
[0538]
[0539]
[0540]
[0541]
[0542]
[0543]
[0544]
[0545]
[0546]
[0547]
[0548]
[0549]
[0550]
[0551]
[0552]
[0553]
[0554]
[0555]
[0556]
[0557]
[0558]
[0559]
[0560]
[0561]
[0562]
[0563]
[0564]
[0565]
[0566]
[0567]
[0568]
[0569]
[0570]
[0571]
[0572]
[0573]
[0574]
[0575]
[0576]
[0577]
[0578]
[0579]
[0580]
[0581]
[0582]
[0583]
[0584]
[0585]
[0586]
[0587]
[0588]
[0589]
[0590]
[0591]
[0592]
[0593]
[0594]
[0595]
[0596]
[0597]
[0598]
[0599]
[0600]
[0601]
[0602]
[0603]
[0604]
[0605]
[0606]
[0607]
[0608]
[0609]
[0610]
[0611]
[0612]
[0613]
[0614]
[0615]
[0616]
[0617]
[0618]
[0619]
[0620]
[0621]
[0622]
[0623]
[0624]
[0625]
[0626]
[0627]
[0628]
[0629]
[0630]
[0631]
[0632]
[0633]
[0634]
[0635]
[0636]
[0637]
[0638]
[0639]
[0640]
[0641]
[0642]
[0643]
[0644]
[0645]
[0646]
[0647]
[0648]
[0649]
[0650]
[0651]
[0652]
[0653]
[0654]
[0655]
[0656]
[0657]
[0658]
[0659]
[0660]
[0661]
[0662]
[0663]
[0664]
[0665]
[0666]
[0667]
[0668]
[0669]
[0670]
[0671]
[0672]
[0673]
[0674]
[0675]
[0676]
[0677]
[0678]
[0679]
[0680]
[0681]
[0682]
[0683]
[0684]
[0685]
[0686]
[0687]
[0688]
[0689]
[0690]
[0691]
[0692]
[0693]
[0694]
[0695]
[0696]
[0697]
[0698]
[0699]
[0700]
[0701]
[0702]
[0703]
[0704]
[0705]
[0706]
[0707]
[0708]
[0709]
[0710]
[0711]
[0712]
[0713]
[0714]
[0715]
[0716]
[0717]
[0718]
[0719]
[0720]
[0721]
[0722]
[0723]
[0724]
[0725]
[0726]
[0727]
[0728]
[0729]
[0730]
[0731]
[0732]
[0733]
[0734]
[0735]
[0736]
[0737]
[0738]
[0739]
[0740]
[0741]
[0742]
[0743]
[0744]
[0745]
[0746]
[0747]
[0748]
[0749]
[0750]
[0751]
[0752]
[0753]
[0754]
[0755]
[0756]
[0757]
[0758]
[0759]
[0760]
[0761]
[0762]
[0763]
[0764]
[0765]
[0766]
[0767]
[0768]
[0769]
[0770]
[0771]
[0772]
[0773]
[0774]
[0775]
[0776]
[0777]
[0778]
[0779]
[0780]
[0781]
[0782]
[0783]
[0784]
[0785]
[0786]
[0787]
[0788]
[0789]
[0790]
[0791]
[0792]
[0793]
[0794]
[0795]
[0796]
[0797]
[0798]
[0799]
[0800]
[0801]
[0802]
[0803]
[0804]
[0805]
[0806]
[0807]
[0808]
[0809]
[0810]
[0811]
[0812]
[0813]
[0814]
[0815]
[0816]
[0817]
[0818]
[0819]
[0820]
[0821]
[0822]
[0823]
[0824]
[0825]
[0826]
[0827]
[0828]
[0829]
[0830]
[0831]
[0832]
[0833]
[0834]
[0835]
[0836]
[0837]
[0838]
[0839]
[0840]
[0841]
[0842]
[0843]
[0844]
[0845]
[0846]
[0847]
[0848]
[0849]
[0850]
[0851]
[0852]
[0853]
[0854]
[0855]
[0856]
[0857]
[0858]
[0859]
[0860]
[0861]
[0862]
[0863]
[0864]
[0865]
[0866]
[0867]
[0868]
[0869]
[0870]
[0871]
[0872]
[0873]
[0874]
[0875]
[0876]
[0877]
[0878]
[0879]
[0880]
[0881]
[0882]
[0883]
[0884]
[0885]
[0886]
[0887]
[0888]
[0889]
[0890]
[0891]
[0892]
[0893]
[0894]
[0895]
[0896]
[0897]
[0898]
[0899]
[0900]
[0901]
[0902]
[0903]
[0904]
[0905]
[0906]
[0907]
[0908]
[0909]
[0910]
[0911]
[0912]
[0913]
[0914]
[0915]
[0916]
[0917]
[0918]
[0919]
[0920]
[0921]
[0922]
[0923]
[0924]
[0925]
[0926]
[0927]
[0928]
[0929]
[0930]
[0931]
[0932]
[0933]
[0934]
[0935]
[0936]
[0937]
[0938]
[0939]
[0940]
[0941]
[0942]
[0943]
[0944]
[0945]
[0946]
[0947]
[0948]
[0949]
[0950]
[0951]
[0952]
[0953]
[0954]
[0955]
[0956]
[0957]
[0958]
[0959]
[0960]
[0961]
[0962]
[0963]
[0964]
[0965]
[0966]
[0967]
[0968]
[0969]
[0970]
[0971]
[0972]
[0973]
[0974]
[0975]
[0976]
[0977]
[0978]
[0979]
[0980]
[0981]
[0982]
[0983]
[0984]
[0985]
[0986]
[0987]
[0988]
[0989]
[0990]
[0991]
[0992]
[0993]
[0994]
[0995]
[0996]
[0997]
[0998]
[0999]
[1000]
[1001]
[1002]
[1003]
[1004]
[1005]
[1006]
[1007]
[1008]
[1009]
[1010]
[1011]
[1012]
[1013]
[1014]
[1015]
[1016]
[1017]
[1018]
[1019]
[1020]
[1021]
[1022]
[1023]
[1024]
[1025]
[1026]
[1027]
[1028]
[1029]
[1030]
[1031]
[1032]
[1033]
[1034]
[1035]
[1036]
[1037]
[1038]
[1039]
[1040]
[1041]
[1042]
[1043]
[1044]
[1045]
[1046]
[1047]
[1048]
[1049]
[1050]
[1051]
[1052]
[1053]
[1054]
[1055]
[1056]
[1057]
[1058]
[1059]
[1060]
[1061]
[1062]
[1063]
[1064]
[1065]
[1066]
[1067]
[1068]
[1069]
[1070]
[1071]
[1072]
[1073]
[1074]
[1075]
[1076]
[1077]
[1078]
[1079]
[1080]
[1081]
[1082]
[1083]
[1084]
[1085]
[1086]
[1087]
[1088]
[1089]
[1090]
[1091]
[1092]
[1093]
<!DOCTYPE html>
<!-- WASDOC AXP-2.0.0 (CGILIB AXP-1.9.9) -->
<!-- wasDOC Copyright (C) 2019,2020 Mark G.Daniel - Apache-2.0 licenced -->
<!-- 3-NOV-2021 02:50 -->
<noscript>NOTE: SOME FUNCTIONALITY EMPLOYS JAVASCRIPT</noscript>
<div id="erreport1" style="display:none;"></div>
<script>
function errorReport(string) {
for (var cnt = 1; cnt <= 2; cnt++) {
var err = document.getElementById('erreport'+cnt);
err.style.display = 'block';
err.innerHTML += string;
}
}
</script>
<style type="text/css">
html { font-family: arial, verdana, sans-serif; font-size:12pt; margin:1em; }
h1 { font-size:124%; font-style:bold;
margin-top:1em; margin-bottom:0.5em; }
h2 { font-size:120%; font-style:bold;
margin-top:1.1em; margin-bottom:0.4em; }
h3 { font-size:116%; font-style:bold;
margin-top:1.0em; margin-bottom:0.3em; }
h4 { font-size:112%; font-style:bold;
margin-top:1.1em; margin-bottom:0.3em; }
h5 { font-size:112%; font-style:bold;
margin-top:1.1em; margin-bottom:0.3em; }
h6 { font-size:112%; font-style:bold; padding:0; margin:0; }
h1 .text { text-decoration:underline; }
h1 .numb { padding-right:0.8em; }
h1 .numb:empty { display:none; padding-right:0; }
h2 .numb { padding-right:0.8em; }
h2 .numb:empty { display:none; padding-right:0; }
h3 .numb { padding-right:0.8em; }
h3 .numb:empty { display:none; padding-right:0; }
h4 .numb { padding-right:0.8em; }
h4 .numb:empty { display:none; padding-right:0; }
h5 .numb { display:none; padding-right:0; }
h6 .numb { display:none; padding-right:0; }
kbd { font-family:monospace; }
noscript { font-size:1.2em; }
p { line-height:1.1em; margin-top:1em; margin-bottom:1em; }
.chunk { font-size:130%; text-decoration:underline; }
.head {}
.high {}
.bold { font-weight:bold; }
.center { text-align:center; }
.italic { font-style:italic; }
.left { text-align:left; }
.nowrap { white-space:nowrap; }
.prewrap { white-space:pre; }
.right { text-align:right; }
.strike { text-decoration:line-through; }
.under { text-decoration:underline; }
.backlight { background-color:#f2f2f2; }
.display0 { display:none; }
img { max-width:100%; }
.imglink { }
.link { }
.blank { }
.list { margin-bottom:1em; }
.list li { margin-top:0.5em; }
.list0 li { margin-top:0; }
.item {}
.tabl { border-collapse:collapse; text-align:left; margin:0.4em 2em 0.5em 2em; }
.tabu { border-collapse:collapse; text-align:right; margin:0.4em 2em 0.5em 2em; }
.tabr { vertical-align:top; }
.tabh { padding:0.2em 0 0 2em; margin:0; }
.tabd { padding:0.1em 0 0 2em; margin:0; }
.tabh:first-of-type, td:first-of-type { padding-left:0; }
.tabu .tabh,
.tabu .tabd { border:1px solid gray; padding:0.2em 0.3em 0.2em 0.3em; }
.tab0 { border:none; visibility:hidden; max-width:1em;
white-space:nowrap; overflow:hidden; }
.tabauto { margin-left:auto; margin-right:auto; }
.tabr:empty { height:0.2em; }
.tabu .tabh:empty, .tabu .tabd:empty { border:none; visibility:hidden; }
.error { font-size:110%; color:black; background-color:yellow;
font-family:sans-serif; font-weight:bold; font-style:normal;
width:95%; border:solid 1px gray; padding:0.5em 1em 0.5em 1em; }
.error::before { content:'\026a0\00a0'; }
.image { }
.page { width:98%; border:1px dashed gray; margin:1.5em 0 1.8em 0; }
.epage { width:98%; border:1px dashed black; margin:1.5em 0 1.8em 0; }
.monosp { font-family:monospace; }
.ppage { display:none; }
.simple { list-style-type:none; }
.valtop { vertical-align:top; }
.valmid { vertical-align:middle; }
.valbot { vertical-align:bottom; }
.code { border-style:solid; border-width:0 0 0 1px; padding-left:1em;
font-family:monospace; white-space:pre; }
.block { }
.blockof { margin:0.4em 2em 0.5em 2em; }
.example { border-style:dashed; border-width:0 0 0 1px; padding-left:1em;
margin-top:0.5em; margin-bottom:0.5em; white-space:pre; }
.indent { margin-left:2em; margin-right:2em; }
.noindent { margin-left:0; margin-right:0; }
.inblock { display:inline-block; }
.mono { white-space:pre; font-family:monospace; }
.note { margin:0.4em 2em 0.5em 2em; page-break-inside:avoid; }
.note h5 { margin-top:0 }
.note_hr { width:80%; border:1px solid gray; }
.prop { padding-left:1em; margin-top:0.5em; margin-bottom:0.5em; }
.quote { border-style:dashed; border-width:0 0 0 1px; padding-left:1em;
margin-top:0.5em; margin-bottom:0.5em; }
.this { display:none; }
a:link,a:visited { color:black; text-decoration:none; }
a:hover,a:active { text-decoration:underline; }
a:focus { outline:0; }
:target:before { content:''; display:block; height:0.1em; margin:-0.1em; }
a.link:link, a.link:visited,a.link:active
{ color:midnightBlue; text-decoration:underline; text-decoration-style:solid; }
.TOC1cols1 { width:80%; max-width:80%; }
.TOC1cols2 { column-count:2; width:80%; max-width:80%; }
.TOC1cols3 { column-count:3; max-width:90%; max-width:90%; }
.TOC1cols4 { column-count:4; max-width:100%; max-width:100%; }
.TOC1table { margin-left:2em; white-space:nowrap; break-inside:auto; }
.TOC1table tr { vertical-align:top; text-align:left; break-inside:avoid; break-after:auto; }
.TOC1table td+td { padding:0 0 0 0.5em; }
.TOC1table .numb { width:3em; max-width:3em; }
.TOC1table .sepr { width:5em; max-width:6em; overflow:hidden; }
.TOC1table .majr { font-weight:bold; }
.TOC1table .text { white-space:normal; }
/* These are due to Firefox (at least <= 76) recalcitrant multi-column handling.
Web search "Split table into css columns, issue in Firefox" (stackoverflow).
"Good grief, Charlie Brown!" */
.TOC1cols2 table,
.TOC1cols2 tbody,
.TOC1cols2 tr,
.TOC1cols3 table,
.TOC1cols3 tbody,
.TOC1cols3 tr,
.TOC1cols4 table,
.TOC1cols4 tbody,
.TOC1cols4 tr { display:block; padding:0; }
.TOC2cols1 { width:60%; max-width:60%; }
.TOC2cols2 { column-count:2; width:70%; max-width:70%; }
.TOC2cols3 { column-count:3; width:80%; max-width:80%; }
.TOC2cols4 { column-count:4; width:90%; max-width:90%; }
.TOC2table { margin-left:2em; white-space:nowrap; break-inside:auto; }
.TOC2table tr { vertical-align:top; text-align:left; break-inside:avoid; break-after:auto; }
.TOC2table .numb { font-weight:bold; padding-right:0.5em; }
.TOC2table .text { width:100%; white-space:normal; }
/* see "recalcitrant" above */
.TOC2cols2 table,
.TOC2cols2 tbody,
.TOC2cols2 tr,
.TOC2cols3 table,
.TOC2cols3 tbody,
.TOC2cols3 tr,
.TOC2cols4 table,
.TOC2cols4 tbody,
.TOC2cols4 tr { display:block; padding:0; }
.NAVtable { margin:0.1em 0 0 2em; }
.NAVtable td { font-size:110%; font-weight:bold; padding:0; margin:0; }
.NAVtable a { padding:0 0.5em 0 0.5em; text-decoration:none; }
.IDXcols1 { width:80%; max-width:80%; }
.IDXcols2 { column-count:2; width:90%; max-width:90%; }
.IDXcols3 { column-count:3; width:95%; max-width:95%; }
.IDXcols4 { column-count:4; width:100%; max-width:100%; }
.IDXtable { margin:1em 0 1em 2em; white-space:nowrap; break-inside:auto; }
.IDXtable tr { vertical-align:top; text-align:left; break-inside:avoid; break-after:auto; }
.IDXtable .alpha { font-weight:bold; min-width:2em; }
.IDXtable .text { width:100%; white-space:normal; }
.IDXtable .para:before { content:'\00b6\00a0'; }
/* see "recalcitrant" above */
.IDXcols2 table,
.IDXcols2 tbody,
.IDXcols2 tr,
.IDXcols3 table,
.IDXcols3 tbody,
.IDXcols3 tr,
.IDXcols4 table,
.IDXcols4 tbody,
.IDXcols4 tr { display:block; padding:0; }
.insight { background-color:cyan; font-family:monospace;
padding:0 0.2em 0 0.2em; margin:0 0.2em 0 0.2em;
font-size:100%; font-style:normal; font-weight:normal;
text-decoration:none; }
.wasdoc { font-family: "Lucida Console", Monaco, monospace;
letter-spacing:-0.07em; }
@media screen { .blank::after { content:"\2924"; }
.print { display:none; }
}
@media print {
table { page-break-inside:avoid; }
.noprint { display:none; }
.page { border:none; page-break-after: always; }
.epage { display:none; }
.ppage { page-break-after:always; }
.NAVtable { display:none; }
.NAVprint { display:block!important; }
}
@page { margin:2cm 1cm 2cm 1cm; }
</style>
<!-- source:0000_INSTALL.WASDOC -->
<style type="text/css">._smiley::after { font-size:150%; vertical-align:middle; content:'\263a' }</style>
<style type="text/css">._frowny::after { font-size:150%; vertical-align:middle; content:'\2639' }</style>
<a id="0." href="#"></a>
<title>WASD Install and Update – Server Account and Environment</title>
<a id="4." href="#"></a>
<a id="4.serveraccountandenvironment" href="#"></a>
<a id="serveraccountandenvironment" href="#"></a>
<h1 class="head chunk">WASD Install and Update</h1>
<h1 class="head"><span class="numb">4.</span><span class="text">Server Account and Environment</span></h1>
<div class="TOC2cols2">
<table class="TOC2table">
<tr><td><a href="install004.html#4.1.vmsserveraccount"><span class="numb">4.1</span><span class="text">VMS Server Account</span></a>
<tr><td><a href="install004.html#4.2.vmsscriptingaccount"><span class="numb">4.2</span><span class="text">VMS Scripting Account</span></a>
<tr><td><a href="install004.html#4.3.accountsupportfiles"><span class="numb">4.3</span><span class="text">Account Support Files</span></a>
<tr><td><a href="install004.html#4.4.globalpagessections"><span class="numb">4.4</span><span class="text">Global Pages/Sections</span></a>
<tr><td><a href="install004.html#4.5.logicalnames"><span class="numb">4.5</span><span class="text">Logical Names</span></a>
<tr><td><a href="install004.html#4.5.1.wasdnametable"><span class="numb">4.5.1</span><span class="text">WASD Name Table</span></a>
<tr><td><a href="install004.html#4.6.serverstartup"><span class="numb">4.6</span><span class="text">Server Startup</span></a>
</table>
</div>
<table class="NAVtable NAVprint"><tr>
<td><a href="javascript:window.history.back();">↩︎</a>
<td><a href="install003.html#3.">↖︎</a>
<td><a href="install000.html#0.">↑︎</a>
<td><a href="install005.html#5.">↘︎</a>
<td><a href="javascript:window.history.forward();">↪︎</a>
</table>
<p> The HTTP server account should be a standard account, preferably in a
group of its own (definitely at least a non-system, non-user group), with
sufficient quotas to handle the expected traffic.
<div class="note">
<a id="4.0.0.0.1" href="#"></a>
<a id="4.processquotas" href="#"></a>
<a id="processquotas" href="#"></a>
<h5 class="head center"><span class="text">Process Quotas!</span></h5>
<hr class="note_hr">
Server process quotas must be sufficient to support the expected traffic load.
BYTLM in particular, and then BIOLM, DIOL, FILLM and PGFLQUO, are all
considerations.
<hr class="note_hr">
</div>
<p> Symptoms of insufficient process quotas include:
<ul class="list list0">
<li class="item"> Textual pages OK, but pages with a significant number of images having
some or all "broken".
<li class="item"> Scripts failing mysteriously, particularly when multiple in use
concurrently.
<li class="item"> Server and associated scripts all apparently waiting MWAIT or RWAST
states.
</ul>
<p> A general rule is more is better, after all, it will only use as much as
it needs! To assist with setting a reasonable BYTLM quota the WATCH report (see
<a class="link blank" target="_blank" href="../features/#watchfacility">WATCH Facility</a> of <a class="link blank" target="_blank" href="../features/#0.">WASD Features and Facilities</a>)
provides some feedback on server BYTLM usage.
<div class="note">
<a id="4.0.0.0.2" href="#"></a>
<a id="4.tcpipagentresources" href="#"></a>
<a id="tcpipagentresources" href="#"></a>
<h5 class="head center"><span class="text">TCP/IP Agent Resources!</span></h5>
<hr class="note_hr">
On an associated topic; some TCP/IP agents require particular internal
resources to be adjusted against given loads (e.g. buffer space allocations).
Symptoms of resource starvation may be TCP/IP services, including WASD,
"pausing" for significant periods or associated processes entering
miscellaneous wait states, etc., during processing. Please ensure such TCP/IP
agents are appropriately dimensioned for expected loads.
<p> Later versions of TCP/IP Services for OpenVMS seem to have large default
values for socket send and receive buffers. MultiNet and TCPware are reported
to improve transfer of large responses by increasing low default values for
send buffer size. The WASD global configuration directives [SocketSizeRcvBuf]
and [SocketSizeSndBuf] allow default values to be adjusted. WATCH can be used
to report network connection buffer values.
<hr class="note_hr">
</div>
<a id="4.1" href="#"></a>
<a id="4.1.vmsserveraccount" href="#"></a>
<a id="vmsserveraccount" href="#"></a>
<h2 class="head"><span class="numb">4.1</span><span class="text">VMS Server Account</span></h2>
<p> The following provides <span class="high under">a guide</span> to the account.
<div class="blockof code">Username: HTTP$SERVER Owner: WASD Server
Account: HTTPD UIC: [077,001] ([HTTP$SERVER])
CLI: DCL Tables: DCLTABLES
Default: WASD_ROOT:[HTTP$SERVER]
LGICMD: LOGIN
Flags: Restricted DisNewMail
Primary days: Mon Tue Wed Thu Fri
Secondary days: Sat Sun
Primary 000000000011111111112222 Secondary 000000000011111111112222
Day Hours 012345678901234567890123 Day Hours 012345678901234567890123
Network: ##### Full access ###### ##### Full access ######
Batch: ##### Full access ###### ##### Full access ######
Local: ----- No access ------ ----- No access ------
Dialup: ----- No access ------ ----- No access ------
Remote: ----- No access ------ ----- No access ------
Expiration: (none) Pwdminimum: 6 Login Fails: 0
Pwdlifetime: 90 00:00 Pwdchange: (pre-expired)
Last Login: (none) (interactive), 11-MAY-1995 08:44 (non-interactive)
Maxjobs: 0 Fillm: 300 Bytlm: 5000000
Maxacctjobs: 0 Shrfillm: 0 Pbytlm: 0
Maxdetach: 0 BIOlm: 2048 JTquota: 1024
Prclm: 100 DIOlm: 1024 WSdef: 1000
Prio: 4 ASTlm: 2000 WSquo: 5000
Queprio: 0 TQElm: 100 WSextent: 20000
CPU: (none) Enqlm: 256 Pgflquo: 500000
Authorized Privileges:
NETMBX TMPMBX
Default Privileges:
NETMBX TMPMBX
</div>
<a id="4.2" href="#"></a>
<a id="4.2.vmsscriptingaccount" href="#"></a>
<a id="vmsscriptingaccount" href="#"></a>
<h2 class="head"><span class="numb">4.2</span><span class="text">VMS Scripting Account</span></h2>
<p> The following provides <span class="high under">a guide</span> to the account.
<div class="blockof code">Username: HTTP$NOBODY Owner: WASD Scripting
Account: HTTPD UIC: [076,001] ([HTTP$NOBODY])
CLI: DCL Tables: DCLTABLES
Default: WASD_ROOT:[HTTP$NOBODY]
LGICMD: LOGIN
Flags: Restricted DisNewMail
Primary days: Mon Tue Wed Thu Fri
Secondary days: Sat Sun
Primary 000000000011111111112222 Secondary 000000000011111111112222
Day Hours 012345678901234567890123 Day Hours 012345678901234567890123
Network: ##### Full access ###### ##### Full access ######
Batch: ##### Full access ###### ##### Full access ######
Local: ----- No access ------ ----- No access ------
Dialup: ----- No access ------ ----- No access ------
Remote: ----- No access ------ ----- No access ------
Expiration: (none) Pwdminimum: 6 Login Fails: 0
Pwdlifetime: 90 00:00 Pwdchange: (pre-expired)
Last Login: (none) (interactive), 11-MAY-1995 08:44 (non-interactive)
Maxjobs: 0 Fillm: 300 Bytlm: 500000
Maxacctjobs: 0 Shrfillm: 0 Pbytlm: 0
Maxdetach: 0 BIOlm: 2048 JTquota: 1024
Prclm: 100 DIOlm: 1024 WSdef: 1000
Prio: 4 ASTlm: 2000 WSquo: 5000
Queprio: 0 TQElm: 100 WSextent: 20000
CPU: (none) Enqlm: 256 Pgflquo: 500000
Authorized Privileges:
NETMBX TMPMBX
Default Privileges:
NETMBX TMPMBX
</div>
<a id="4.3" href="#"></a>
<a id="4.3.accountsupportfiles" href="#"></a>
<a id="accountsupportfiles" href="#"></a>
<h2 class="head"><span class="numb">4.3</span><span class="text">Account Support Files</span></h2>
<div class="note"><a id="4.3.0.0.0.1" href="#"></a>
<a id="4.3.note" href="#"></a>
<a id="note" href="#"></a>
<h5 class="head center"><span class="text">Note</span></h5>
<hr class="note_hr">
Support procedures often change between versions. It is always advisable to
check the versions documentation before installing or updating.
Examples may be found in <a class="link blank" target="_blank" href="/wasd_root/example/">WASD_ROOT:[EXAMPLE]</a>
<hr class="note_hr">
</div>
<a id="4.3.0.0.1" href="#"></a>
<a id="4.3.httpdexecutables" href="#"></a>
<a id="httpdexecutables" href="#"></a>
<h5 class="head"><span class="text">HTTPd Executables</span></h5>
<p> Two server executables can be built by the package.
<ul class="list">
<li class="item"> <span class="high bold">HTTPD.EXE –</span> basic server
<li class="item"> <span class="high bold">HTTPD_SSL.EXE –</span> TLS/SSL-enabled server
</ul>
<a id="4.3.0.0.2" href="#"></a>
<a id="4.3.privilegedimage" href="#"></a>
<a id="privilegedimage" href="#"></a>
<h5 class="head"><span class="text">Privileged Image</span></h5>
<p> As the HTTP$SERVER account should be completely unprivileged, and the
HTTPd image requires ALTPRI, CMKRNL, DETACH, NETMBX, TMPMBX, OPER, PRMGBL,
PRMMBX, PSWAPM, SECURITY, SYSGBL, SYSLCK, SYSNAM, SYSPRV and WORLD
privileges (see the
<a class="link blank" target="_blank" href="/wasd_root/src/httpd/readmore.txt">WASD_ROOT:[SRC.HTTPD]READMORE.TXT</a>)
document for a description of how and why the server uses these privileges).
<p> It is installed using a command similar to the following:
<div class="blockof code">$ INSTALL = "$SYS$SYSTEM:INSTALL/COMMAND_MODE"
$ INSTALL ADD WASD_EXE:HTTPD.EXE -
/PRIVILEGE=(ALTPRI,CMKRNL,DETACH,OPER,PRMGBL,PRMMBX,PSWAPM,-
SECURITY,SYSGBL,SYSLCK,SYSNAM,SYSPRV,WORLD)
</div>
<a id="4.3.0.0.2.999" href="#"></a>
<a id="4.3.dclprocedurestartupcom" href="#"></a>
<a id="dclprocedurestartupcom" href="#"></a>
<h6 class="head display0"><span class="text">DCL Procedure STARTUP.COM</span></h6>
<a id="4.3.0.0.3" href="#"></a>
<a id="4.3.startupcom" href="#"></a>
<a id="startupcom" href="#"></a>
<h5 class="head"><span class="text">STARTUP.COM</span></h5>
<p> Putting all this together the HTTP server startup procedure becomes
something similar to the supplied example. It should be called from
SYSTARTUP_VMS.COM or the site's equivalent.
<p> This procedure will support simple and quite complex sites. It works
closely with STARTUP_SERVER.COM (see below). It is designed to accept
parameters from the command-line or as pre-assigned symbols. Operating this way
requires no modifications to the procedure itself. Startup characteristics are
essentially determined by DCL symbol values. Some symbols are booleans,
switching functionality off and on, others require string values. When relevant
startup values are not assigned a reasonable default will be applied. See the
following examples.
<p> Startup characteristics can be determined by supplying symbol assignment
values as command-line parameters when calling the procedure.
<div class="blockof code">$ @DKA0:[WASD_ROOT.STARTUP]STARTUP WASD_DECNET=1 WASD_SSL=1 -
WASD_SSL_CERTIFICATE="WASD_ROOT:[LOCAL]ALPHA.PEM"
</div>
<p> Startup characteristics can also be determined by assigning the symbol
values before calling the procedure itself.
<div class="blockof code">$ WASD_DECNET = 1
$ WASD_SSL = 1
$ WASD_SSL_CERTIFICATE = "WASD_ROOT:[LOCAL]ALPHA.PEM"
$ @DKA0:[WASD_ROOT.STARTUP]STARTUP
</div>
<div class="blockof code">$ @DKA0:[WASD_ROOT.STARTUP]STARTUP WASD_DECNET=1 WASD_BATCH_QUEUE=THIS$BATCH
</div>
<p> Check the procedure itself for detail on symbol names and functionality.
See <a class="link blank" target="_blank" href="/wasd_root/example/startup.com">WASD_ROOT:[EXAMPLE]STARTUP.COM</a>
<a id="4.3.0.0.3.999" href="#"></a>
<a id="4.3.dclprocedurestartuplocalcom" href="#"></a>
<a id="dclprocedurestartuplocalcom" href="#"></a>
<h6 class="head display0"><span class="text">DCL Procedure STARTUP_LOCAL.COM</span></h6>
<a id="4.3.0.0.4" href="#"></a>
<a id="4.3.startuplocalcom" href="#"></a>
<a id="startuplocalcom" href="#"></a>
<h5 class="head"><span class="text">STARTUP_LOCAL.COM</span></h5>
<p> This file is automatically executed by the STARTUP.COM procedure
immediately before the server is actually started. It is provided to supply
all the local site's additional startup requirements. For example, a
STARTUP.COM defined logical name could be modified here before the server
proper is actually started. See
<a class="link blank" target="_blank" href="/wasd_root/example/startup_local.com">WASD_ROOT:[EXAMPLE]STARTUP_LOCAL.COM</a>
<a id="4.3.0.0.4.999" href="#"></a>
<a id="4.3.dclprocedurestartupservercom" href="#"></a>
<a id="dclprocedurestartupservercom" href="#"></a>
<h6 class="head display0"><span class="text">DCL Procedure STARTUP_SERVER.COM</span></h6>
<a id="4.3.0.0.5" href="#"></a>
<a id="4.3.startupservercom" href="#"></a>
<a id="startupservercom" href="#"></a>
<h5 class="head"><span class="text">STARTUP_SERVER.COM</span></h5>
<p> This procedure serves two purposes.
<ol class="list">
<li class="item">The procedure becomes SYS$COMMAND for a detached process created directly
during the execution of STARTUP.COM.
<li class="item"> The procedure then controls the activation of the HTTPd executable image
during server restarts and exits.
</ol>
<a class="link blank" target="_blank" href="/wasd_root/example/startup_server.com">WASD_ROOT:[EXAMPLE]STARTUP_SERVER.COM</a>
<p> It is recommended to pass server startup command-line parameters using the
WASD_SERVER_STARTUP logical name that this procedure checks for and uses if
present. If this is defined the contents are applied to the server image when
executed. It can be explicitly defined before WASD startup.
<div class="blockof code">$ DEFINE /SYSTEM /EXECUTIVE WASD_STARTUP_SERVER "/SYSUAF=ID"
$ @DKA0:[WASD_ROOT.STARTUP]STARTUP
</div>
<p> The value can also be passed to the main startup procedure in a symbol.
The startup procedure then defines a system logical name with that value (note
that any quotes used must be escaped).
<div class="blockof code">$ WASD_DECNET = 1
$ WASD_SSL = 1
$ WASD_SSL_CERTIFICATE = "WASD_ROOT:[LOCAL]ALPHA.PEM"
$ WASD_STARTUP = "/SYSUAF=ID"
$ @DKA0:[WASD_ROOT.STARTUP]STARTUP
</div>
<p> It can also be manually redefined at any time and the server restarted to
apply different startup parameters to the running server.
<div class="blockof code">$ DEFINE /SYSTEM /EXECUTIVE WASD_STARTUP_SERVER "/SYSUAF=(SSL,ID)"
$ HTTPD /DO=RESTART=NOW
</div>
<a id="4.4" href="#"></a>
<a id="4.4.globalpagessections" href="#"></a>
<a id="globalpagessections" href="#"></a>
<h2 class="head"><span class="numb">4.4</span><span class="text">Global Pages/Sections</span></h2>
<p> Various accounting, cache and other shared data used by the server is
provided by shared global memory. These requires one permananet global
section (SYSGEN parameter GBLSECTIONS) and a number of permanent global pages
(SYSGEN parameter GBLPAGES) per item. The number of items varies depending on
configuration.
<a id="4.4.0.0.1" href="#"></a>
<a id="4.4.globalsections" href="#"></a>
<a id="globalsections" href="#"></a>
<h5 class="head"><span class="text">Global Sections</span></h5>
<table class="tabl">
<tr class="tabr under">
<th class="tabh">Item
<th class="tabh">Description
<th class="tabh">Usage
<tr class="tabr">
<tr class="tabr backlight">
<td class="tabd">Accounting
<td class="tabd">Accumulates various data provided to the Server
Administration Statistics report and the HTTPMON utility
<td class="tabd">required
<tr class="tabr">
<td class="tabd">Activity
<td class="tabd">Provides data to the Server Administration Activity Report
graph
<td class="tabd">required
<tr class="tabr backlight">
<td class="tabd">Authentication
<td class="tabd">When multiple WASD Instances are configured
provides a shared authentication cache
<td class="tabd">optional
<tr class="tabr">
<td class="tabd">Proxy Verification
<td class="tabd">When multiple WASD Instances are configured
provides an shared proxy verification cache
<td class="tabd">optional
<tr class="tabr backlight">
<td class="tabd">SSL Session Cache
<td class="tabd">When SSL is used and multiple WASD Instances are
configured provides a shared SSL session cache
<td class="tabd">optional
</table>
<p> If there are insufficient global sections or pages the server will fail to
start for all requirements except the activity statistics, this will just be
disabled. Server process log startup messages advise on current usage.
<p> As permanent, system-accessible global sections are deployed it may be
necessary to explicitly delete them after ad hoc server experimentation, etc.
(<a class="link" href="install004.html#4.6.serverstartup">4.6 Server Startup</a>). The startup qualifier /GBLSEC=NOPERM disables the
creation of permanent global sections eliminating this requirement.
<a id="4.5" href="#"></a>
<a id="4.5.logicalnames" href="#"></a>
<a id="logicalnames" href="#"></a>
<h2 class="head"><span class="numb">4.5</span><span class="text">Logical Names</span></h2>
<p> WASD uses an independent logical name table (see <a class="link" href="install004.html#4.5.1.wasdnametable">4.5.1 WASD Name Table</a>
below). Versions prior to 10 used the SYSTEM table and a substantially
different naming schema.
<p> The following logical names are used in the operation of the package. These
are usually created by STARTUP.COM during server startup.
<p>
<a id="4.5.0.0.1" href="#"></a>
<a id="4.5.packagelogicalnames" href="#"></a>
<a id="packagelogicalnames" href="#"></a>
<h5 class="head"><span class="text">Package Logical Names</span></h5>
<table class="tabl">
<tr class="tabr under">
<th class="tabh">Logical Name
<th class="tabh">Table
<th class="tabh">Description
<tr class="tabr">
<tr class="tabr backlight">
<td class="tabd">CGI-BIN
<td class="tabd">WASD
<td class="tabd">(Hyphen) System logical defining a search list with
the architecture-specific executable directory first, local script directory
second, then the common script directory, as a concealed device.
<tr class="tabr">
<td class="tabd">CGI_BIN
<td class="tabd">WASD
<td class="tabd">(Underscore) Directory containing architecture-neutral
script files.
<tr class="tabr backlight">
<td class="tabd">CGI_EXE
<td class="tabd">WASD
<td class="tabd">Directory containing architecture-specific script
executables.
<tr class="tabr">
<td class="tabd">HT_EXE
<td class="tabd">WASD
<td class="tabd">Pre-v10.0 backward compatibility for WASD_EXE.
<tr class="tabr backlight">
<td class="tabd">HT_LOGS
<td class="tabd">WASD
<td class="tabd">Pre-v10.0 backward compatibility for WASD_LOG.
<tr class="tabr">
<td class="tabd">HT_ROOT
<td class="tabd">SYSTEM
<td class="tabd">Pre-v10.0 backward compatibility for WASD_ROOT.
<tr class="tabr backlight">
<td class="tabd">HT_SCRATCH
<td class="tabd">WASD
<td class="tabd">Pre-v10.0 backward compatibility for WASD_SCRATCH.
<tr class="tabr">
<td class="tabd">WASD_AXP
<td class="tabd">WASD
<td class="tabd">Directory containing Alpha executable images
(WASD_ROOT:[AXP]).
<tr class="tabr backlight">
<td class="tabd">WASD_AUTH
<td class="tabd">WASD
<td class="tabd">Directory containing authentication/authorization
databases (files, (WASD_ROOT:[LOCAL])).
<tr class="tabr">
<td class="tabd">WASD_CGI_AXP
<td class="tabd">WASD
<td class="tabd">Directory containing Alpha script executables
(WASD_ROOT:[AXP-BIN]).
<tr class="tabr backlight">
<td class="tabd">WASD_CGI_IA64
<td class="tabd">WASD
<td class="tabd">Directory containing Itanium script executables
(WASD_ROOT:[IA64-BIN]).
<tr class="tabr">
<td class="tabd">WASD_CGI_X86_64
<td class="tabd">WASD
<td class="tabd">Directory containing x86-64 script executables
(WASD_ROOT:[X86_64-BIN]).
<tr class="tabr backlight">
<td class="tabd">WASD_CONFIG
<td class="tabd">WASD
<td class="tabd">Location of the configuration files. Can be
defined as a search list.
<tr class="tabr">
<td class="tabd">WASD_CONFIG_AUTH
<td class="tabd">WASD
<td class="tabd">Location of the authentication/authorization
configuration file.
<tr class="tabr backlight">
<td class="tabd">WASD_CONFIG_GLOBAL
<td class="tabd">WASD
<td class="tabd">Location of the configuration file.
<tr class="tabr">
<td class="tabd">WASD_CONFIG_MAP
<td class="tabd">WASD
<td class="tabd">Location of the mapping rule file.
<tr class="tabr backlight">
<td class="tabd">WASD_CONFIG_MSG
<td class="tabd">WASD
<td class="tabd">Location of the message file.
<tr class="tabr">
<td class="tabd">WASD_CONFIG_SERVICE
<td class="tabd">WASD
<td class="tabd">Location of the optional service (virtual
host) configuration file.
<tr class="tabr backlight">
<td class="tabd">WASD_DECNET_CGI_OBJECT
<td class="tabd">SYSTEM
<td class="tabd">Locates the supporting DCL procedure. DECnet objects are system-global.
<tr class="tabr">
<td class="tabd">WASD_DECNET_OSU_OBJECT
<td class="tabd">SYSTEM
<td class="tabd">Locates the supporting DCL procedure. DECnet objects are system-global.
<tr class="tabr backlight">
<td class="tabd">WASD_EXE
<td class="tabd">WASD
<td class="tabd">Directory containing the executable images.
<tr class="tabr">
<td class="tabd">WASD_FILE_DEV[<span class="high italic">n</span>]
<td class="tabd">SYSTEM
<td class="tabd">Locates the DCL procedure that will integrate the specified environment's
logical name table into the processes' LNM$FILE_DEV (see above).
<tr class="tabr backlight">
<td class="tabd">WASD_GMT
<td class="tabd">WASD
<td class="tabd">Offset from GMT (e.g. "+10:30",
"-01:15") For systems supporting DTSS (e.g. DECnet-Plus) this logical
may be left undefined, with server time being calculated using the
SYS$TIMEZONE_DIFFERENTIAL logical.
<tr class="tabr">
<td class="tabd">WASD_IA64
<td class="tabd">WASD
<td class="tabd">Directory containing Itanium executable
images.
<tr class="tabr backlight">
<td class="tabd">WASD_LOG
<td class="tabd">WASD
<td class="tabd">If logging is enabled and no log file name
specified on the command line, this logical must be defined to locate the
file. When a logging period is in use this logical need only contain the
directory used to store the logs.
<tr class="tabr">
<td class="tabd">WASD_LOGS
<td class="tabd">WASD
<td class="tabd">Optional definition, for convenient log file
specification.
<tr class="tabr backlight">
<td class="tabd">WASD_ROOT
<td class="tabd">SYSTEM
<td class="tabd">Location of WASD Web Services directory tree, as a
concealed device.
<tr class="tabr">
<td class="tabd">WASD_SCRATCH
<td class="tabd">WASD
<td class="tabd">Location of an optional directory that
scripts can use for temporary storage. Must be read+write+delete accessible to
the server account. The WASD_CONFIG_GLOBAL [DclCleanupScratchMinutesMax]
directive controls whether automatic cleanup scans of this area delete any
files that are older than [DclCleanupScratchMinutesOld].
<tr class="tabr backlight">
<td class="tabd">WASD_SITELOG
<td class="tabd">WASD
<td class="tabd">Location of the optional plain-text site log
file.
<tr class="tabr">
<td class="tabd">WASD_SSL_CAFILE
<td class="tabd">WASD
<td class="tabd">When using the SSL executable this logical
locates the optional Certificate Authority list file.
<tr class="tabr backlight">
<td class="tabd">WASD_SSL_CERT
<td class="tabd">WASD
<td class="tabd">When using the SSL executable this logical
locates the default certificate.
<tr class="tabr">
<td class="tabd">WASD_SERVER_LOGS
<td class="tabd">WASD
<td class="tabd">Location of the server process logs.
<tr class="tabr backlight">
<td class="tabd">WASD_STARTUP_SERVER
<td class="tabd">WASD
<td class="tabd">Used to pass parameters to the server
image startup command line.
<tr class="tabr">
<td class="tabd">WASD_X86_64
<td class="tabd">WASD
<td class="tabd">Directory containing x86-64 executable images.
</table>
<div class="note">
<a id="4.5.0.0.2" href="#"></a>
<a id="4.5.prev10logicalnames" href="#"></a>
<a id="prev10logicalnames" href="#"></a>
<h5 class="head center"><span class="text">Pre-v10 Logical Names</span></h5>
<hr class="note_hr">
The pre-v10.0.0 logical names (e.g. HTTPD$MAP) are deprecated and will be
obsoleted in a future version. The server process log issues warnings such as
<span class="high monosp">HTTPD-W-DEPRECATED, change HTTPD$MAP to WASD_CONFIG_MAP (soon!)</span> for any it
finds during startup.
<hr class="note_hr">
</div>
<a id="4.5.1" href="#"></a>
<a id="4.5.1.wasdnametable" href="#"></a>
<a id="wasdnametable" href="#"></a>
<h3 class="head"><span class="numb">4.5.1</span><span class="text">WASD Name Table</span></h3>
<p> In an effort to localise WASD-related logical names and avoid polluting the
SYSTEM logical name table WASD version 10 creates it's own world-readable,
system-writable name table, and adds it to LNM$SYSTEM_DIRECTORY.
<div class="blockof code">$ SHOW LOGICAL WASD_TABLE/TABLE=LNM$SYSTEM_DIRECTORY
"WASD_TABLE" [table] = "" (LNM$SYSTEM_DIRECTORY)
</div>
<p> WASD logical names are then defined in that table leaving the SYSTEM table
with just a few essential names.
<div class="blockof code">$ SHOW LOGICAL CGI*,HT*,WASD*,WWW*
(LNM$PROCESS_TABLE)
(LNM$JOB_81E3D580)
(WASD_TABLE)
"CGI-BIN" = "DKA0:[WASD_ROOT.CGI-BIN.]"
= "DKA0:[WASD_ROOT.AXP-BIN.]"
"CGI_BIN" = "WASD_ROOT:[CGI-BIN]"
"CGI_EXE" = "WASD_ROOT:[AXP-BIN]"
"HTBIN" = "CGI-BIN:[000000]"
"HT_CACHE_ROOT" = "DKA0:[HT_CACHE.]"
"HT_EXE" = "WASD_ROOT:[AXP]"
"HT_LOGS" = "WASD_ROOT:[LOG]"
"HT_SCRATCH" = "WASD_ROOT:[SCRATCH]"
"WASD_AUTH" = "WASD_ROOT:[LOCAL]"
"WASD_AXP" = "WASD_ROOT:[AXP]"
"WASD_CACHE_ROOT" = "DKA0:[HT_CACHE.]"
"WASD_CGILIBSHR32" = "CGI_EXE:CGILIBSHR32.EXE"
"WASD_CGI_AXP" = "WASD_ROOT:[AXP-BIN]"
"WASD_CGI_BIN" = "WASD_ROOT:[CGI-BIN]"
"WASD_CGI_EXE" = "WASD_ROOT:[AXP-BIN]"
"WASD_CGI_IA64" = "WASD_ROOT:[IA64-BIN]"
"WASD_CGI_X86_64" = "WASD_ROOT:[X86_64-BIN]"
"WASD_CONFIG" = "WASD_ROOT:[LOCAL]"
"WASD_CONFIG_AUTH" = "WASD_CONFIG:HTTPD$AUTH.CONF"
"WASD_CONFIG_GLOBAL" = "WASD_CONFIG:HTTPD$CONFIG.CONF"
"WASD_CONFIG_MAP" = "WASD_CONFIG:HTTPD$MAP.CONF"
"WASD_CONFIG_MSG" = "WASD_CONFIG:HTTPD$MSG.CONF"
"WASD_CONFIG_SERVICE" = "WASD_CONFIG:HTTPD$SERVICE.CONF"
"WASD_EXE" = "WASD_ROOT:[AXP]"
"WASD_HTTPD_EXE" = "WASD_EXE:HTTPD_SSL.EXE"
"WASD_IA64" = "WASD_ROOT:[IA64]"
"WASD_JAVA" = "WASD_ROOT:[JAVA]"
"WASD_LOCAL" = "WASD_ROOT:[LOCAL]"
"WASD_LOGS" = "WASD_ROOT:[LOG]"
"WASD_SCRATCH" = "WASD_ROOT:[SCRATCH]"
"WASD_SCRIPT" = "WASD_ROOT:[SCRIPT]"
"WASD_SCRIPT_LOCAL" = "WASD_ROOT:[SCRIPT_LOCAL]"
"WASD_SERVER_LOGS" = "WASD_ROOT:[LOG_SERVER]"
"WASD_SSL_CAFILE" = "WASD_CONFIG:CA-BUNDLE_CRT.TXT"
"WASD_SSL_CERT" = "WASD_CONFIG:HTTPD.PEM"
"WASD_STARTUP" = "WASD_ROOT:[STARTUP]"
"WASD_STARTUP_SERVER" = "/SYSUAF=(ID,SSL)/PERSONA=RELAXED/PROFILE"
"WASD_X86_64" = "WASD_ROOT:[X86_64]"
"WWW_ROOT" = "DKA0:[WASD_ROOT.SRC.OSU]"
"WWW_SCRIPT_MAX_REUSE" = "999"
(LNM$GROUP_000001)
(LNM$SYSTEM_TABLE)
"HT_ROOT" = "DKA0:[WASD_ROOT.]"
"WASD_DECNET_CGI_OBJECT" = "DKA0:[WASD_ROOT.CGI-BIN]CGIWASD.COM"
"WASD_DECNET_OSU_OBJECT" = "DKA0:[WASD_ROOT.CGI-BIN]WWWEXEC.COM"
"WASD_FILE_DEV" = "DKA0:[WASD_ROOT]WASD_FILE_DEV.COM"
"WASD_ROOT" = "DKA0:[WASD_ROOT.]"
(LNM$SYSCLUSTER_TABLE)
(DECW$LOGICAL_NAMES)
</div>
<p> As can be seen the number of LNM$SYSTEM_TABLE names is small, five in this
example (though it can vary). Logical name WASD_FILE_DEV locates a procedure
to insert the WASD_TABLE into a process' LNM$FILE_DEV to make the table names
available. Until that is done they are not visible without an explicit
/TABLE=WASD_TABLE. The server automatically uses the procedure for itself and
scripting processes. Site admins can simply
<div class="blockof code">$ @WASD_FILE_DEV
</div>
at the command-line or in their LOGIN.COM to have it done for their
interactive session(s). This procedure location is variable within the
file-system and needs to be located and accessed without initially knowing that
location.
<p> The WASD_ROOT logical provides a convenient, global logical location for
the primary (default) WASD environment. HT_ROOT is used to provide pre-v10
backward-compatibility with existing sites. (If yours does not need the name
you can deassign it during server startup.)
<p> The WASD_DECNET_CGI_OBJECT and WASD_DECNET_OSU_OBJECT names provide global
locations for the two DECnet scripting environments. These logicals are
defined when a site uses the [STARTUP]STARTUP_DECNET.COM procedure. It is
necessary to provide a global location for these with multiple WASD
environments because DECnet objects are global entities. The one object must
provide an infrastructure for potentially multiple WASD environments.
<p> Other SYSTEM logical names, WASD_TABLE+<span class="high italic">n</span> name tables, and
WASD_FILE_DEV<span class="high italic">n</span> logical names are used for non-primary WASD
environments (see
<a class="link blank" target="_blank" href="../features/#instancesandenvironments">Instances and Environments</a> of <a class="link blank" target="_blank" href="../features/#0.">WASD Features and Facilities</a>).
<a id="4.6" href="#"></a>
<a id="4.6.serverstartup" href="#"></a>
<a id="serverstartup" href="#"></a>
<h2 class="head"><span class="numb">4.6</span><span class="text">Server Startup</span></h2>
<p> When starting up the server several characteristics of the server may be
specified using qualifiers on the command line. If not specified appropriate
defaults are employed. For recommended methods of passing parameters to the
executable at server startup see <a class="link" href="install004.html#4.3.startupservercom">‘STARTUP_SERVER.COM’ in 4.3 Account Support Files</a>.
For clarity some esoteric and legacy qualifiers and parameters are not listed in
this table.
<a id="4.6.0.0.1" href="#"></a>
<a id="4.6.serverimagecommandlineparameters" href="#"></a>
<a id="serverimagecommandlineparameters" href="#"></a>
<h5 class="head"><span class="text">Server Image Command-Line Parameters</span></h5>
<table class="tabl">
<tr class="tabr under">
<th class="tabh">Parameter/Qualifier
<th class="tabh">Description
<tr class="tabr">
<tr class="tabr backlight">
<td class="tabd">/ALL[=integer]
<td class="tabd">Has two roles. When starting a server up assigns that
server to a specific, non-default WASD environment (see /ENVIRONMENT) When
using the server control /DO= using /ALL specifies to do the action to all
servers in that particular environment.
<tr class="tabr">
<td class="tabd">/AUTHORIZATION=..
<td class="tabd">Control authentication and authorisation
behaviour.
<br> See
<a class="link blank" target="_blank" href="../features/#authenticationpolicy">Authentication Policy</a> of <a class="link blank" target="_blank" href="../features/#0.">WASD Features and Facilities</a>.
<tr class="tabr backlight">
<td class="tabd">/CGI_PREFIX=
<td class="tabd">The prefix to the CGI symbol names created
for a script (defaults to "WWW_").
<br> See <a class="link blank" target="_blank" href="../scripting/#0.">WASD Web Services - Scripting</a>
<tr class="tabr">
<td class="tabd">/CLUSTER
<td class="tabd">Apply control /DO= to all instances in a cluster (default
is to current node instance(s) only).
<tr class="tabr backlight">
<td class="tabd">/DETACH=
<td class="tabd">This qualifier allows a DCL procedure to be specified as
input to a directly detached process (in conjunction with /USER).
<tr class="tabr">
<td class="tabd">/DO=
<td class="tabd">Command to be performed by the executing server.
<tr class="tabr backlight">
<td class="tabd">/ENVIRONMENT=
<td class="tabd">Integer indicating in which environment this server
is executing
<tr class="tabr">
<td class="tabd">/GBLSEC=DELETE
<td class="tabd">Allows a monitor-associated
permanent global section to be explicitly deleted. When a server starts it
creates system-accessible, permanent global sections in which to store
accounting and request data. As this is permanent it would be possible for a
site, perhaps experimenting with servers over a range of ports, to consume
significant amounts of global pages and sections. This qualifier allows such
sections to be deleted.
<tr class="tabr backlight">
<td class="tabd">/GBLSEC=NOPERM
<td class="tabd">Disables the creation of permanent global
sections. They are automatically deleted when the server image exits.
<tr class="tabr">
<td class="tabd">/[NO]LOG[=name]
<td class="tabd">Either disables logging (overrides configuration
directive), or enables logging and optionally specifies the log file name
(also see section <a class="link" href="install004.html#4.5.logicalnames">4.5 Logical Names</a>, logging is disabled by default). If
the file specification is "SYS$OUTPUT" the server issues log
entries to <stdout>, allowing user-defined log formats to be easily checked and
refined.
<tr class="tabr backlight">
<td class="tabd">/NETWORK
<td class="tabd">Run the server and any scripting processes as
NETWORK mode rather than the default detached OTHER mode.
<tr class="tabr">
<td class="tabd">/NOTE=string
<td class="tabd">Annotate the server process log with the specified
string. Intended to assist auditing server events such as restarts, maaping
reloads and the like.
<tr class="tabr backlight">
<td class="tabd">/OUTPUT=filename
<td class="tabd">Server image <stdout> is redirected to the specified
file name. Useful when employing the /SYSPLUS report generator.
<tr class="tabr">
<td class="tabd">/PERSONA[=..]
<td class="tabd">Enables and controls detached process scripting.
<br> See
<a class="link blank" target="_blank" href="../scripting/#introduction">Introduction</a> of <a class="link blank" target="_blank" href="../scripting/#0.">WASD Scripting Environment</a>.
<tr class="tabr backlight">
<td class="tabd">/PRIORITY=
<td class="tabd">Server process priority (default is 4).
<tr class="tabr">
<td class="tabd">/[NO]PROFILE
<td class="tabd">Allows SYSUAF-authenticated username
security profiles to be used for file access.
<tr class="tabr backlight">
<td class="tabd">/PROMISCUOUS[=password]
<td class="tabd">Server will accept any
authentication username/password pair (used for testing, demonstrations, etc.)
<tr class="tabr">
<td class="tabd">/PROXY=string
<td class="tabd">Allows proxy maintainance activities to be
executed from the command line (e.g. from batch jobs, etc.).
<tr class="tabr backlight">
<td class="tabd">/SCRIPT=AS=username
<td class="tabd">Specifies the username of the
default scripting account.
<tr class="tabr">
<td class="tabd">/SERVICE=
<td class="tabd">Comma-separated, list of server services
(overrides the [Service] configuration parameter).
<tr class="tabr backlight">
<td class="tabd">/SOFTWARE=
<td class="tabd">An arbitrary string that can be used to override the
server software identification (i.e. "HTTPd-WASD/10.4.0 OpenVMS/AXP
SSL").
<tr class="tabr">
<td class="tabd">/[NO]SSL[=..]
<td class="tabd">Controls Secure Sockets Layer protocol behaviour.
<br> See
<a class="link blank" target="_blank" href="../features/#transportlayersecurity">Transport Layer Security</a> of <a class="link blank" target="_blank" href="../features/#0.">WASD Features and Facilities</a>.
<tr class="tabr backlight">
<td class="tabd">/SYSPLUS
<td class="tabd">Displays CLI equivalent System Report PLUS data. Available
for circumstances where the server is unresponsive but an interactive session
is available. Requires a 132 character width terminal session.
<br> See
<a class="link blank" target="_blank" href="../features/#systemreportplus">System Report PLUS</a> of <a class="link blank" target="_blank" href="../features/#0.">WASD Features and Facilities</a>.
<tr class="tabr">
<td class="tabd">/[NO]SYSUAF[=..]
<td class="tabd">Controls VMS (SYSUAF) authentication/authorisation
behaviour.
<br> See
<a class="link blank" target="_blank" href="../features/#sysuafauthenticatedusers">SYSUAF-Authenticated Users</a> of <a class="link blank" target="_blank" href="../features/#0.">WASD Features and Facilities</a>.
<tr class="tabr backlight">
<td class="tabd">/USER=username
<td class="tabd">For VMS 6.2 and later this qualifier
allows the /DETACH qualifier to directly create a detached process executing as
the specified username.
<tr class="tabr">
<td class="tabd">/VALBLK[=16|64]
<td class="tabd">For server to (try) to use either pre-VMS V8.2 16
byte lock value block or the VMS V8.2 and later 64 byte lock value block.
<tr class="tabr backlight">
<td class="tabd">/VERSION
<td class="tabd">Displays the executable's version string and the copyright
notice.
<tr class="tabr">
<td class="tabd">/[NO]WATCH[=..]
<td class="tabd">Controls the use of the WATCH reporting facility.
<br> See
<a class="link blank" target="_blank" href="../features/#watchfacility">WATCH Facility</a> of <a class="link blank" target="_blank" href="../features/#0.">WASD Features and Facilities</a>.
</table>
<!-- source:0500_OTHER.WASDOC -->
<table class="NAVtable NAVprint"><tr>
<td><a href="javascript:window.history.back();">↩︎</a>
<td><a href="install003.html#3.">↖︎</a>
<td><a href="install000.html#0.">↑︎</a>
<td><a href="install005.html#5.">↘︎</a>
<td><a href="javascript:window.history.forward();">↪︎</a>
</table>