amps-python-client 5.3.4.1__zip → 5.3.4.3__zip

amps-python-client-5.3.4.1/docs/user-guide/html/_images/sow_update_sequence.svg

@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="460" height="1340"><g transform="translate(-380 -100)"><path d="M0 0h1360v1760H0z" fill="#fff"/><path d="M528 120c17.67 0 32 17.9 32 40s-14.33 40-32 40h-96c-17.67 0-32-17.9-32-40s14.33-40 32-40z" stroke="#000" stroke-width="2" fill="#fff"/><use xlink:href="#a" transform="matrix(1,0,0,1,405,125) translate(8.099999999999994 27.799999999999997)"/><use xlink:href="#b" transform="matrix(1,0,0,1,405,125) translate(86.05 27.799999999999997)"/><use xlink:href="#c" transform="matrix(1,0,0,1,405,125) translate(39.525 49.4)"/><use xlink:href="#d" transform="matrix(1,0,0,1,405,125) translate(59.525 49.4)"/><path d="M480 260l80 60-80 60-80-60z" stroke="#000" stroke-width="2" fill="#fff"/><use xlink:href="#e" transform="matrix(1,0,0,1,405,265) translate(33.074999999999996 47.8)"/><use xlink:href="#f" transform="matrix(1,0,0,1,405,265) translate(97.975 47.8)"/><use xlink:href="#g" transform="matrix(1,0,0,1,405,265) translate(40.55 69.4)"/><path d="M480 200v60" stroke="#000" stroke-width="2" fill="none"/><path d="M480 260l-4.64-14.27h9.28z"/><path d="M480.85 260.63L480 260l-.85.63-5.16-15.9h12zm-4.1-13.9l3.25 10.03 3.26-10.03z"/><path d="M788 280c17.67 0 32 17.9 32 40s-14.33 40-32 40h-96c-17.67 0-32-17.9-32-40s14.33-40 32-40z" stroke="#000" stroke-width="2" fill="#fff"/><use xlink:href="#h" transform="matrix(1,0,0,1,665,285) translate(3.1499999999999915 38.6)"/><use xlink:href="#i" transform="matrix(1,0,0,1,665,285) translate(98 38.6)"/><path d="M560 320h99" stroke="#000" stroke-width="2" fill="none"/><path d="M560 321h-1.33l1.33-1-1.33-1H560zM659 320l-14.27 4.64v-9.28z"/><path d="M660.04 319.3l-.04.7.03.72-16.3 5.3v-12.03zm-14.3 3.96l10.02-3.26-10.03-3.26z"/><path fill="#fff" d="M598.02 309.2h22.95v21.6h-22.95z"/><use xlink:href="#j" transform="matrix(1,0,0,1,598.0246886497197,309.2) translate(0 14.4)"/><path d="M400 440h160v120H400z" stroke="#000" stroke-width="2" fill="#fff"/><use xlink:href="#k" transform="matrix(1,0,0,1,405,445) translate(29.549999999999997 47.8)"/><use xlink:href="#l" transform="matrix(1,0,0,1,405,445) translate(38.525 69.4)"/><path d="M480 380v59" stroke="#000" stroke-width="2" fill="none"/><path d="M480 380h-1v-.75zm1 0h-1l1-.75zM480 439l-4.64-14.27h9.28z"/><path d="M480.73 440h-1.46L474 423.73h12zm-4-14.27l3.27 10.03 3.26-10.03z"/><path fill="#fff" d="M465.32 398.7h29.35v21.6h-29.35z"/><use xlink:href="#m" transform="matrix(1,0,0,1,465.325,398.7) translate(0 14.4)"/><path d="M400 620h160v120H400z" stroke="#000" stroke-width="2" fill="#fff"/><use xlink:href="#n" transform="matrix(1,0,0,1,405,625) translate(9.625 47.8)"/><use xlink:href="#o" transform="matrix(1,0,0,1,405,625) translate(97.42500000000001 47.8)"/><use xlink:href="#p" transform="matrix(1,0,0,1,405,625) translate(59.5 69.4)"/><path d="M480 560v59" stroke="#000" stroke-width="2" fill="none"/><path d="M480 619l-4.64-14.27h9.28z"/><path d="M480.73 620h-1.46L474 603.73h12zm-4-14.27l3.27 10.03 3.26-10.03z"/><path d="M400 800h160v120H400z" stroke="#000" stroke-width="2" fill="#fff"/><use xlink:href="#q" transform="matrix(1,0,0,1,405,805) translate(10.575000000000003 58.6)"/><use xlink:href="#l" transform="matrix(1,0,0,1,405,805) translate(66.475 58.6)"/><path d="M480 740v60" stroke="#000" stroke-width="2" fill="none"/><path d="M480 800l-4.64-14.27h9.28z"/><path d="M481.05 800h-2.1L474 784.73h12zm-4.3-13.27l3.25 10.03 3.26-10.03z"/><path d="M480 980l80 60-80 60-80-60z" stroke="#000" stroke-width="2" fill="#fff"/><use xlink:href="#r" transform="matrix(1,0,0,1,405,985) translate(17.099999999999994 58.6)"/><use xlink:href="#g" transform="matrix(1,0,0,1,405,985) translate(64 58.6)"/><path d="M480 920v58.75" stroke="#000" stroke-width="2" fill="none"/><path d="M480 978.75l-4.64-14.27h9.28z"/><path d="M480.52 980.4l-.52-.4-.52.4-5.5-16.92h12.03zm-3.78-14.92L480 975.5l3.26-10.02z"/><path d="M560 1040h100" stroke="#000" stroke-width="2" fill="none"/><path d="M560 1041h-1.33l1.33-1-1.33-1H560zM660 1040l-14.27 4.64v-9.28z"/><path d="M660 1038.95v2.1l-15.27 4.96v-12zm-13.27 4.3l10.03-3.25-10.03-3.26z"/><path fill="#fff" d="M595.33 1029.2h29.35v21.6h-29.35z"/><use xlink:href="#m" transform="matrix(1,0,0,1,595.325,1029.2) translate(0 14.4)"/><path d="M660 980h160v120H660z" stroke="#000" stroke-width="2" fill="#fff"/><use xlink:href="#s" transform="matrix(1,0,0,1,665,985) translate(32.05 47.8)"/><use xlink:href="#t" transform="matrix(1,0,0,1,665,985) translate(87.95 47.8)"/><use xlink:href="#u" transform="matrix(1,0,0,1,665,985) translate(4.574999999999989 69.4)"/><use xlink:href="#l" transform="matrix(1,0,0,1,665,985) translate(72.475 69.4)"/><path d="M400 1160h160v120H400z" stroke="#000" stroke-width="2" fill="#fff"/><use xlink:href="#v" transform="matrix(1,0,0,1,405,1165) translate(5.099999999999994 47.8)"/><use xlink:href="#w" transform="matrix(1,0,0,1,405,1165) translate(68 47.8)"/><use xlink:href="#x" transform="matrix(1,0,0,1,405,1165) translate(86.95 47.8)"/><use xlink:href="#y" transform="matrix(1,0,0,1,405,1165) translate(22.049999999999997 69.4)"/><use xlink:href="#z" transform="matrix(1,0,0,1,405,1165) translate(85 69.4)"/><path d="M480 1100v59" stroke="#000" stroke-width="2" fill="none"/><path d="M480 1100h-1v-.75zm1 0h-1l1-.75zM480 1159l-4.64-14.27h9.28z"/><path d="M480.73 1160h-1.46l-5.28-16.27h12zm-4-14.27l3.27 10.03 3.26-10.03z"/><path fill="#fff" d="M468.52 1118.7h22.95v21.6h-22.95z"/><g><use xlink:href="#j" transform="matrix(1,0,0,1,468.525,1118.7) translate(0 14.4)"/></g><path d="M740 1100v120H560" stroke="#000" stroke-width="2" fill="none"/><path d="M574.27 1224.64L560 1220l14.27-4.64z"/><path d="M575.27 1226l-15.27-4.95v-2.1l15.27-4.96zm-12.03-6l10.03 3.26v-6.52z"/><path d="M480 1280v60" stroke="#000" stroke-width="2" fill="none"/><path d="M480 1340l-4.64-14.27h9.28z"/><path d="M481.05 1340h-2.1l-4.96-15.27h12zm-4.3-13.27l3.25 10.03 3.26-10.03z"/><path d="M528 1340c17.67 0 32 17.9 32 40s-14.33 40-32 40h-96c-17.67 0-32-17.9-32-40s14.33-40 32-40z" stroke="#000" stroke-width="2" fill="#fff"/><g><use xlink:href="#A" transform="matrix(1,0,0,1,405,1345) translate(1.1749999999999972 27.799999999999997)"/><use xlink:href="#B" transform="matrix(1,0,0,1,405,1345) translate(61.975 27.799999999999997)"/><use xlink:href="#C" transform="matrix(1,0,0,1,405,1345) translate(81.97500000000001 27.799999999999997)"/><use xlink:href="#D" transform="matrix(1,0,0,1,405,1345) translate(11.574999999999996 49.4)"/><use xlink:href="#E" transform="matrix(1,0,0,1,405,1345) translate(46.574999999999996 49.4)"/></g><defs><path d="M240 0l2-218c-23 76-54 145-80 218h-23L58-218 59 0H30v-248h44l77 211c21-75 51-140 76-211h43V0h-30" id="F"/><path d="M100-194c63 0 86 42 84 106H49c0 40 14 67 53 68 26 1 43-12 49-29l28 8c-11 28-37 45-77 45C44 4 14-33 15-96c1-61 26-98 85-98zm52 81c6-60-76-77-97-28-3 7-6 17-6 28h103" id="G"/><path d="M135-143c-3-34-86-38-87 0 15 53 115 12 119 90S17 21 10-45l28-5c4 36 97 45 98 0-10-56-113-15-118-90-4-57 82-63 122-42 12 7 21 19 24 35" id="H"/><path d="M141-36C126-15 110 5 73 4 37 3 15-17 15-53c-1-64 63-63 125-63 3-35-9-54-41-54-24 1-41 7-42 31l-33-3c5-37 33-52 76-52 45 0 72 20 72 64v82c-1 20 7 32 28 27v20c-31 9-61-2-59-35zM48-53c0 20 12 33 32 33 41-3 63-29 60-74-43 2-92-5-92 41" id="I"/><path d="M177-190C167-65 218 103 67 71c-23-6-38-20-44-43l32-5c15 47 100 32 89-28v-30C133-14 115 1 83 1 29 1 15-40 15-95c0-56 16-97 71-98 29-1 48 16 59 35 1-10 0-23 2-32h30zM94-22c36 0 50-32 50-73 0-42-14-75-50-75-39 0-46 34-46 75s6 73 46 73" id="J"/><g id="a"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#F"/><use transform="matrix(0.05,0,0,0.05,14.950000000000001,0)" xlink:href="#G"/><use transform="matrix(0.05,0,0,0.05,24.950000000000003,0)" xlink:href="#H"/><use transform="matrix(0.05,0,0,0.05,33.95,0)" xlink:href="#H"/><use transform="matrix(0.05,0,0,0.05,42.95,0)" xlink:href="#I"/><use transform="matrix(0.05,0,0,0.05,52.95,0)" xlink:href="#J"/><use transform="matrix(0.05,0,0,0.05,62.95,0)" xlink:href="#G"/></g><path d="M205 0l-28-72H64L36 0H1l101-248h38L239 0h-34zm-38-99l-47-123c-12 45-31 82-46 123h93" id="K"/><path d="M114-163C36-179 61-72 57 0H25l-1-190h30c1 12-1 29 2 39 6-27 23-49 58-41v29" id="L"/><path d="M24-231v-30h32v30H24zM24 0v-190h32V0H24" id="M"/><path d="M108 0H70L1-190h34L89-25l56-165h34" id="N"/><g id="b"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#K"/><use transform="matrix(0.05,0,0,0.05,12,0)" xlink:href="#L"/><use transform="matrix(0.05,0,0,0.05,17.95,0)" xlink:href="#L"/><use transform="matrix(0.05,0,0,0.05,23.9,0)" xlink:href="#M"/><use transform="matrix(0.05,0,0,0.05,27.849999999999994,0)" xlink:href="#N"/><use transform="matrix(0.05,0,0,0.05,36.849999999999994,0)" xlink:href="#G"/><use transform="matrix(0.05,0,0,0.05,46.849999999999994,0)" xlink:href="#H"/></g><path d="M59-47c-2 24 18 29 38 22v24C64 9 27 4 27-40v-127H5v-23h24l9-43h21v43h35v23H59v120" id="O"/><g id="c"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#I"/><use transform="matrix(0.05,0,0,0.05,10,0)" xlink:href="#O"/></g><path d="M30-248c87 1 191-15 191 75 0 78-77 80-158 76V0H30v-248zm33 125c57 0 124 11 124-50 0-59-68-47-124-48v98" id="P"/><path d="M185-189c-5-48-123-54-124 2 14 75 158 14 163 119 3 78-121 87-175 55-17-10-28-26-33-46l33-7c5 56 141 63 141-1 0-78-155-14-162-118-5-82 145-84 179-34 5 7 8 16 11 25" id="Q"/><g id="d"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#K"/><use transform="matrix(0.05,0,0,0.05,12,0)" xlink:href="#F"/><use transform="matrix(0.05,0,0,0.05,26.950000000000003,0)" xlink:href="#P"/><use transform="matrix(0.05,0,0,0.05,38.95,0)" xlink:href="#Q"/></g><path d="M30 0v-248h187v28H63v79h144v27H63v87h162V0H30" id="R"/><path d="M117-194c89-4 53 116 60 194h-32v-121c0-31-8-49-39-48C34-167 62-67 57 0H25l-1-190h30c1 10-1 24 2 32 11-22 29-35 61-36" id="S"/><path d="M24 0v-261h32V0H24" id="T"/><path d="M85-194c31 0 48 13 60 33l-1-100h32l1 261h-30c-2-10 0-23-3-31C134-8 116 4 85 4 32 4 16-35 15-94c0-66 23-100 70-100zm9 24c-40 0-46 34-46 75 0 40 6 74 45 74 42 0 51-32 51-76 0-42-9-74-50-73" id="U"/><g id="e"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#R"/><use transform="matrix(0.05,0,0,0.05,12,0)" xlink:href="#S"/><use transform="matrix(0.05,0,0,0.05,22,0)" xlink:href="#O"/><use transform="matrix(0.05,0,0,0.05,27,0)" xlink:href="#M"/><use transform="matrix(0.05,0,0,0.05,30.950000000000003,0)" xlink:href="#O"/><use transform="matrix(0.05,0,0,0.05,35.95,0)" xlink:href="#T"/><use transform="matrix(0.05,0,0,0.05,39.900000000000006,0)" xlink:href="#G"/><use transform="matrix(0.05,0,0,0.05,49.900000000000006,0)" xlink:href="#U"/></g><path d="M127-220V0H93v-220H8v-28h204v28h-85" id="V"/><path d="M100-194c62-1 85 37 85 99 1 63-27 99-86 99S16-35 15-95c0-66 28-99 85-99zM99-20c44 1 53-31 53-75 0-43-8-75-51-75s-53 32-53 75 10 74 51 75" id="W"/><g id="f"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#V"/><use transform="matrix(0.05,0,0,0.05,8.950000000000001,0)" xlink:href="#W"/></g><path d="M84 4C-5 8 30-112 23-190h32v120c0 31 7 50 39 49 72-2 45-101 50-169h31l1 190h-30c-1-10 1-25-2-33-11 22-28 36-60 37" id="X"/><path d="M115-194c53 0 69 39 70 98 0 66-23 100-70 100C84 3 66-7 56-30L54 0H23l1-261h32v101c10-23 28-34 59-34zm-8 174c40 0 45-34 45-75 0-40-5-75-45-74-42 0-51 32-51 76 0 43 10 73 51 73" id="Y"/><path d="M106-169C34-169 62-67 57 0H25v-261h32l-1 103c12-21 28-36 61-36 89 0 53 116 60 194h-32v-121c2-32-8-49-39-48" id="Z"/><path d="M103-251c84 0 111 97 45 133-19 10-37 24-39 52H78c0-63 77-55 77-114 0-30-21-42-52-43-32 0-53 17-56 46l-32-2c7-45 34-72 88-72zM77 0v-35h34V0H77" id="aa"/><g id="g"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#P"/><use transform="matrix(0.05,0,0,0.05,12,0)" xlink:href="#X"/><use transform="matrix(0.05,0,0,0.05,22,0)" xlink:href="#Y"/><use transform="matrix(0.05,0,0,0.05,32,0)" xlink:href="#T"/><use transform="matrix(0.05,0,0,0.05,35.95,0)" xlink:href="#M"/><use transform="matrix(0.05,0,0,0.05,39.900000000000006,0)" xlink:href="#H"/><use transform="matrix(0.05,0,0,0.05,48.900000000000006,0)" xlink:href="#Z"/><use transform="matrix(0.05,0,0,0.05,58.900000000000006,0)" xlink:href="#aa"/></g><path d="M210-169c-67 3-38 105-44 169h-31v-121c0-29-5-50-35-48C34-165 62-65 56 0H25l-1-190h30c1 10-1 24 2 32 10-44 99-50 107 0 11-21 27-35 58-36 85-2 47 119 55 194h-31v-121c0-29-5-49-35-48" id="ab"/><g id="h"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#R"/><use transform="matrix(0.05,0,0,0.05,12,0)" xlink:href="#S"/><use transform="matrix(0.05,0,0,0.05,22,0)" xlink:href="#O"/><use transform="matrix(0.05,0,0,0.05,27,0)" xlink:href="#M"/><use transform="matrix(0.05,0,0,0.05,30.950000000000003,0)" xlink:href="#O"/><use transform="matrix(0.05,0,0,0.05,35.95,0)" xlink:href="#T"/><use transform="matrix(0.05,0,0,0.05,39.900000000000006,0)" xlink:href="#G"/><use transform="matrix(0.05,0,0,0.05,49.900000000000006,0)" xlink:href="#ab"/><use transform="matrix(0.05,0,0,0.05,64.85000000000001,0)" xlink:href="#G"/><use transform="matrix(0.05,0,0,0.05,74.85000000000001,0)" xlink:href="#S"/><use transform="matrix(0.05,0,0,0.05,84.85000000000001,0)" xlink:href="#O"/></g><path d="M101-234c-31-9-42 10-38 44h38v23H63V0H32v-167H5v-23h27c-7-52 17-82 69-68v24" id="ac"/><g id="i"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#ac"/><use transform="matrix(0.05,0,0,0.05,5,0)" xlink:href="#I"/><use transform="matrix(0.05,0,0,0.05,15,0)" xlink:href="#M"/><use transform="matrix(0.05,0,0,0.05,18.95,0)" xlink:href="#T"/><use transform="matrix(0.05,0,0,0.05,22.9,0)" xlink:href="#X"/><use transform="matrix(0.05,0,0,0.05,32.9,0)" xlink:href="#L"/><use transform="matrix(0.05,0,0,0.05,38.85,0)" xlink:href="#G"/></g><path d="M190 0L58-211 59 0H30v-248h39L202-35l-2-213h31V0h-41" id="ad"/><g id="j"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#ad"/><use transform="matrix(0.05,0,0,0.05,12.950000000000001,0)" xlink:href="#W"/></g><path d="M115-194c55 1 70 41 70 98S169 2 115 4C84 4 66-9 55-30l1 105H24l-1-265h31l2 30c10-21 28-34 59-34zm-8 174c40 0 45-34 45-75s-6-73-45-74c-42 0-51 32-51 76 0 43 10 73 51 73" id="ae"/><path d="M96-169c-40 0-48 33-48 73s9 75 48 75c24 0 41-14 43-38l32 2c-6 37-31 61-74 61-59 0-76-41-82-99-10-93 101-131 147-64 4 7 5 14 7 22l-32 3c-4-21-16-35-41-35" id="af"/><g id="k"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#P"/><use transform="matrix(0.05,0,0,0.05,12,0)" xlink:href="#L"/><use transform="matrix(0.05,0,0,0.05,17.95,0)" xlink:href="#G"/><use transform="matrix(0.05,0,0,0.05,27.950000000000003,0)" xlink:href="#ae"/><use transform="matrix(0.05,0,0,0.05,37.95,0)" xlink:href="#L"/><use transform="matrix(0.05,0,0,0.05,43.900000000000006,0)" xlink:href="#W"/><use transform="matrix(0.05,0,0,0.05,53.900000000000006,0)" xlink:href="#af"/><use transform="matrix(0.05,0,0,0.05,62.900000000000006,0)" xlink:href="#G"/><use transform="matrix(0.05,0,0,0.05,72.9,0)" xlink:href="#H"/><use transform="matrix(0.05,0,0,0.05,81.9,0)" xlink:href="#H"/></g><g id="l"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#F"/><use transform="matrix(0.05,0,0,0.05,14.950000000000001,0)" xlink:href="#G"/><use transform="matrix(0.05,0,0,0.05,24.950000000000003,0)" xlink:href="#H"/><use transform="matrix(0.05,0,0,0.05,33.95,0)" xlink:href="#H"/><use transform="matrix(0.05,0,0,0.05,42.95,0)" xlink:href="#I"/><use transform="matrix(0.05,0,0,0.05,52.95,0)" xlink:href="#J"/><use transform="matrix(0.05,0,0,0.05,62.95,0)" xlink:href="#G"/></g><path d="M137-103V0h-34v-103L8-248h37l75 118 75-118h37" id="ag"/><g id="m"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#ag"/><use transform="matrix(0.05,0,0,0.05,10.35,0)" xlink:href="#G"/><use transform="matrix(0.05,0,0,0.05,20.35,0)" xlink:href="#H"/></g><path d="M30-248c118-7 216 8 213 122C240-48 200 0 122 0H30v-248zM63-27c89 8 146-16 146-99s-60-101-146-95v194" id="ah"/><g id="n"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#ah"/><use transform="matrix(0.05,0,0,0.05,12.950000000000001,0)" xlink:href="#G"/><use transform="matrix(0.05,0,0,0.05,22.950000000000003,0)" xlink:href="#O"/><use transform="matrix(0.05,0,0,0.05,27.950000000000003,0)" xlink:href="#G"/><use transform="matrix(0.05,0,0,0.05,37.95,0)" xlink:href="#L"/><use transform="matrix(0.05,0,0,0.05,43.900000000000006,0)" xlink:href="#ab"/><use transform="matrix(0.05,0,0,0.05,58.85,0)" xlink:href="#M"/><use transform="matrix(0.05,0,0,0.05,62.80000000000001,0)" xlink:href="#S"/><use transform="matrix(0.05,0,0,0.05,72.80000000000001,0)" xlink:href="#G"/></g><path d="M140-251c81 0 123 46 123 126C263-46 219 4 140 4 59 4 17-45 17-125s42-126 123-126zm0 227c63 0 89-41 89-101s-29-99-89-99c-61 0-89 39-89 99S79-25 140-24" id="ai"/><path d="M266 0h-40l-56-210L115 0H75L2-248h35L96-30l15-64 43-154h32l59 218 59-218h35" id="aj"/><g id="o"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#Q"/><use transform="matrix(0.05,0,0,0.05,12,0)" xlink:href="#ai"/><use transform="matrix(0.05,0,0,0.05,26,0)" xlink:href="#aj"/></g><path d="M194 0L95-120 63-95V0H30v-248h33v124l119-124h40L117-140 236 0h-42" id="ak"/><path d="M179-190L93 31C79 59 56 82 12 73V49c39 6 53-20 64-50L1-190h34L92-34l54-156h33" id="al"/><g id="p"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#ak"/><use transform="matrix(0.05,0,0,0.05,12,0)" xlink:href="#G"/><use transform="matrix(0.05,0,0,0.05,22,0)" xlink:href="#al"/></g><g id="q"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#R"/><use transform="matrix(0.05,0,0,0.05,12,0)" xlink:href="#S"/><use transform="matrix(0.05,0,0,0.05,22,0)" xlink:href="#L"/><use transform="matrix(0.05,0,0,0.05,27.950000000000003,0)" xlink:href="#M"/><use transform="matrix(0.05,0,0,0.05,31.899999999999995,0)" xlink:href="#af"/><use transform="matrix(0.05,0,0,0.05,40.9,0)" xlink:href="#Z"/></g><g id="r"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#ah"/><use transform="matrix(0.05,0,0,0.05,12.950000000000001,0)" xlink:href="#G"/><use transform="matrix(0.05,0,0,0.05,22.950000000000003,0)" xlink:href="#T"/><use transform="matrix(0.05,0,0,0.05,26.900000000000002,0)" xlink:href="#O"/><use transform="matrix(0.05,0,0,0.05,31.900000000000002,0)" xlink:href="#I"/></g><g id="s"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#F"/><use transform="matrix(0.05,0,0,0.05,14.950000000000001,0)" xlink:href="#G"/><use transform="matrix(0.05,0,0,0.05,24.950000000000003,0)" xlink:href="#L"/><use transform="matrix(0.05,0,0,0.05,30.900000000000002,0)" xlink:href="#J"/><use transform="matrix(0.05,0,0,0.05,40.900000000000006,0)" xlink:href="#G"/></g><path d="M33 0v-248h34V0H33" id="am"/><g id="t"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#am"/><use transform="matrix(0.05,0,0,0.05,5,0)" xlink:href="#S"/><use transform="matrix(0.05,0,0,0.05,15,0)" xlink:href="#O"/><use transform="matrix(0.05,0,0,0.05,20,0)" xlink:href="#W"/></g><path d="M141 0L90-78 38 0H4l68-98-65-92h35l48 74 47-74h35l-64 92 68 98h-35" id="an"/><g id="u"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#R"/><use transform="matrix(0.05,0,0,0.05,12,0)" xlink:href="#an"/><use transform="matrix(0.05,0,0,0.05,21,0)" xlink:href="#M"/><use transform="matrix(0.05,0,0,0.05,24.95,0)" xlink:href="#H"/><use transform="matrix(0.05,0,0,0.05,33.95,0)" xlink:href="#O"/><use transform="matrix(0.05,0,0,0.05,38.95,0)" xlink:href="#M"/><use transform="matrix(0.05,0,0,0.05,42.900000000000006,0)" xlink:href="#S"/><use transform="matrix(0.05,0,0,0.05,52.900000000000006,0)" xlink:href="#J"/></g><path d="M233-177c-1 41-23 64-60 70L243 0h-38l-65-103H63V0H30v-248c88 3 205-21 203 71zM63-129c60-2 137 13 137-47 0-61-80-42-137-45v92" id="ao"/><g id="v"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#ao"/><use transform="matrix(0.05,0,0,0.05,12.950000000000001,0)" xlink:href="#G"/><use transform="matrix(0.05,0,0,0.05,22.950000000000003,0)" xlink:href="#af"/><use transform="matrix(0.05,0,0,0.05,31.950000000000003,0)" xlink:href="#W"/><use transform="matrix(0.05,0,0,0.05,41.95,0)" xlink:href="#L"/><use transform="matrix(0.05,0,0,0.05,47.900000000000006,0)" xlink:href="#U"/></g><g id="w"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#M"/><use transform="matrix(0.05,0,0,0.05,3.95,0)" xlink:href="#S"/></g><path d="M195 0l-74-108L45 0H8l94-129-87-119h37l69 98 67-98h37l-84 118L233 0h-38" id="ap"/><path d="M30 0v-248h33v221h125V0H30" id="aq"/><path d="M68-38c1 34 0 65-14 84H32c9-13 17-26 17-46H33v-38h35" id="ar"/><g id="x"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#V"/><use transform="matrix(0.05,0,0,0.05,10.950000000000001,0)" xlink:href="#ap"/><use transform="matrix(0.05,0,0,0.05,22.950000000000003,0)" xlink:href="#aq"/><use transform="matrix(0.05,0,0,0.05,32.95,0)" xlink:href="#W"/><use transform="matrix(0.05,0,0,0.05,42.95,0)" xlink:href="#J"/><use transform="matrix(0.05,0,0,0.05,52.95,0)" xlink:href="#ar"/></g><path d="M232-93c-1 65-40 97-104 97C67 4 28-28 28-90v-158h33c8 89-33 224 67 224 102 0 64-133 71-224h33v155" id="as"/><g id="y"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#as"/><use transform="matrix(0.05,0,0,0.05,12.950000000000001,0)" xlink:href="#ae"/><use transform="matrix(0.05,0,0,0.05,22.950000000000003,0)" xlink:href="#U"/><use transform="matrix(0.05,0,0,0.05,32.95,0)" xlink:href="#I"/><use transform="matrix(0.05,0,0,0.05,42.95,0)" xlink:href="#O"/><use transform="matrix(0.05,0,0,0.05,47.95,0)" xlink:href="#G"/></g><g id="z"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#Q"/><use transform="matrix(0.05,0,0,0.05,12,0)" xlink:href="#ai"/><use transform="matrix(0.05,0,0,0.05,26,0)" xlink:href="#aj"/></g><g id="A"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#ah"/><use transform="matrix(0.05,0,0,0.05,12.950000000000001,0)" xlink:href="#G"/><use transform="matrix(0.05,0,0,0.05,22.950000000000003,0)" xlink:href="#T"/><use transform="matrix(0.05,0,0,0.05,26.900000000000002,0)" xlink:href="#M"/><use transform="matrix(0.05,0,0,0.05,30.85,0)" xlink:href="#N"/><use transform="matrix(0.05,0,0,0.05,39.85,0)" xlink:href="#G"/><use transform="matrix(0.05,0,0,0.05,49.85,0)" xlink:href="#L"/></g><g id="B"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#O"/><use transform="matrix(0.05,0,0,0.05,5,0)" xlink:href="#W"/></g><g id="C"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#T"/><use transform="matrix(0.05,0,0,0.05,3.95,0)" xlink:href="#M"/><use transform="matrix(0.05,0,0,0.05,7.9,0)" xlink:href="#H"/><use transform="matrix(0.05,0,0,0.05,16.9,0)" xlink:href="#O"/><use transform="matrix(0.05,0,0,0.05,21.9,0)" xlink:href="#G"/><use transform="matrix(0.05,0,0,0.05,31.899999999999995,0)" xlink:href="#S"/><use transform="matrix(0.05,0,0,0.05,41.9,0)" xlink:href="#G"/><use transform="matrix(0.05,0,0,0.05,51.900000000000006,0)" xlink:href="#L"/><use transform="matrix(0.05,0,0,0.05,57.85,0)" xlink:href="#H"/></g><g id="D"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#I"/><use transform="matrix(0.05,0,0,0.05,10,0)" xlink:href="#S"/><use transform="matrix(0.05,0,0,0.05,20,0)" xlink:href="#U"/></g><g id="E"><use transform="matrix(0.05,0,0,0.05,0,0)" xlink:href="#H"/><use transform="matrix(0.05,0,0,0.05,9,0)" xlink:href="#X"/><use transform="matrix(0.05,0,0,0.05,19,0)" xlink:href="#Y"/><use transform="matrix(0.05,0,0,0.05,29,0)" xlink:href="#H"/><use transform="matrix(0.05,0,0,0.05,38,0)" xlink:href="#af"/><use transform="matrix(0.05,0,0,0.05,47,0)" xlink:href="#L"/><use transform="matrix(0.05,0,0,0.05,52.95,0)" xlink:href="#M"/><use transform="matrix(0.05,0,0,0.05,56.900000000000006,0)" xlink:href="#Y"/><use transform="matrix(0.05,0,0,0.05,66.9,0)" xlink:href="#G"/><use transform="matrix(0.05,0,0,0.05,76.9,0)" xlink:href="#L"/><use transform="matrix(0.05,0,0,0.05,82.85000000000001,0)" xlink:href="#H"/></g></defs></g></svg>

amps-python-client-5.3.4.1/docs/user-guide/html/_images/tip.svg

@@ -1,31 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- Generator: Adobe Illustrator 9.0, SVG Export Plug-In  -->
-<!DOCTYPE svg [
-	<!ENTITY st0 "fill:none;stroke:#000000;stroke-width:1.0944;">
-	<!ENTITY st1 "fill:#FFFFFF;stroke:none;">
-	<!ENTITY st2 "fill-rule:nonzero;clip-rule:nonzero;stroke:#FFFFFF;stroke-width:5.6139;stroke-miterlimit:4;">
-	<!ENTITY st3 "fill:none;stroke:none;">
-	<!ENTITY st4 "fill-rule:nonzero;clip-rule:nonzero;stroke:#000000;stroke-miterlimit:4;">
-	<!ENTITY st5 "stroke:none;">
-]>
-<svg  width="48pt" height="48pt" viewBox="0 0 48 48" xml:space="preserve" xmlns="http://www.w3.org/2000/svg">
-	<g id="Layer_x0020_3" style="&st2;">
-		<g>
-			<path d="M9.5,18.6c0,8,6.5,14.4,14.4,14.4c8,0,14.4-6.5,14.4-14.4c0-8-6.5-14.4-14.4-14.4c-8,0-14.4,6.5-14.4,14.4z M12.8,18.6c0-6.2,5-11.2,11.2-11.2c6.2,0,11.2,5,11.2,11.2c0,6.2-5,11.2-11.2,11.2c-6.2,0-11.2-5-11.2-11.2z"/>
-			<path d="M28.1,37.9l-7.6,0.8c-0.9,0.1-1.5,0.9-1.4,1.8c0.1,0.9,0.9,1.5,1.8,1.4l7.6-0.8c0.9-0.1,1.5-0.9,1.4-1.8c-0.1-0.9-0.9-1.5-1.8-1.4z"/>
-			<path d="M28.1,34.8l-7.6,0.8c-0.9,0.1-1.5,0.9-1.4,1.8c0.1,0.9,0.9,1.5,1.8,1.4l7.6-0.8c0.9-0.1,1.5-0.9,1.4-1.8c-0.1-0.9-0.9-1.5-1.8-1.4z"/>
-			<path d="M28.1,31.6l-7.6,0.8c-0.9,0.1-1.5,0.9-1.4,1.8s0.9,1.5,1.8,1.4l7.6-0.8c0.9-0.1,1.5-0.9,1.4-1.8s-0.9-1.5-1.8-1.4z"/>
-			<path d="M23.1,41.3v0.9c0,0.9,0.7,1.6,1.6,1.6c0.9,0,1.6-0.7,1.6-1.6v-0.9h-3.3z"/>
-			<path style="&st1;" d="M35.9,18.7c0,6.6-5.4,12-12,12c-6.6,0-12-5.4-12-12s5.4-12,12-12c6.6,0,12,5.4,12,12z"/>
-			<path style="&st5;" d="M9.6,18.6c0,8,6.5,14.4,14.4,14.4c8,0,14.4-6.5,14.4-14.4c0-8-6.5-14.4-14.4-14.4c-8,0-14.4,6.5-14.4,14.4z M12.9,18.6c0-6.2,5-11.2,11.2-11.2c6.2,0,11.2,5,11.2,11.2c0,6.2-5,11.2-11.2,11.2c-6.2,0-11.2-5-11.2-11.2z"/>
-			<path style="&st5;" d="M28.2,37.9l-7.6,0.8c-0.9,0.1-1.5,0.9-1.4,1.8c0.1,0.9,0.9,1.5,1.8,1.4l7.6-0.8c0.9-0.1,1.5-0.9,1.4-1.8c-0.1-0.9-0.9-1.5-1.8-1.4z"/>
-			<path style="&st5;" d="M28.2,34.7l-7.6,0.8c-0.9,0.1-1.5,0.9-1.4,1.8c0.1,0.9,0.9,1.5,1.8,1.4l7.6-0.8c0.9-0.1,1.5-0.9,1.4-1.8c-0.1-0.9-0.9-1.5-1.8-1.4z"/>
-			<path style="&st5;" d="M28.2,31.6l-7.6,0.8c-0.9,0.1-1.5,0.9-1.4,1.8c0.1,0.9,0.9,1.5,1.8,1.4l7.6-0.8c0.9-0.1,1.5-0.9,1.4-1.8c-0.1-0.9-0.9-1.5-1.8-1.4z"/>
-			<path style="&st5;" d="M23.1,41.3v0.9c0,0.9,0.7,1.6,1.6,1.6s1.6-0.7,1.6-1.6v-0.9h-3.3z"/>
-			<path style="&st0;" d="M22.3,28.3l-3.5-10.7c0,0,6.6,3.9,10.5,0"/>
-		</g>
-	</g>
-	<g id="crop_x0020_marks" style="&st4;">
-		<path style="&st3;" d="M48,48H0V0h48v48z"/>
-	</g>
-</svg>

amps-python-client-5.3.4.1/docs/user-guide/html/_images/warning.svg

@@ -1,23 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- Generator: Adobe Illustrator 9.0, SVG Export Plug-In  -->
-<!DOCTYPE svg [
-	<!ENTITY st0 "fill:#000000;stroke:#FFFFFF;stroke-width:7.9139;stroke-linejoin:round;">
-	<!ENTITY st1 "fill-rule:nonzero;clip-rule:nonzero;fill:#FFFFFF;stroke:#000000;stroke-miterlimit:4;">
-	<!ENTITY st2 "fill:none;stroke:none;">
-	<!ENTITY st3 "fill:#000000;">
-	<!ENTITY st4 "fill-rule:evenodd;clip-rule:evenodd;stroke:none;">
-	<!ENTITY st5 "fill-rule:nonzero;clip-rule:nonzero;stroke:#000000;stroke-miterlimit:4;">
-]>
-<svg  width="48pt" height="48pt" viewBox="0 0 48 48" xml:space="preserve" xmlns="http://www.w3.org/2000/svg">
-	<g id="Layer_x0020_4" style="&st1;">
-		<g style="&st4;">
-			<path style="&st0;" d="M16.4,42.3L5.7,31.6V16.4L16.4,5.7h15.2l10.7,10.7v15.2L31.6,42.3H16.4z"/>
-			<path style="&st3;" d="M16.4,42.3L5.7,31.6V16.4L16.4,5.7h15.2l10.7,10.7v15.2L31.6,42.3H16.4z"/>
-			<path d="M11.7,17.7l18.7,18.7l5.9-5.9L17.6,11.7l-5.9,5.9z"/>
-			<path d="M11.7,30.5l5.9,5.9l18.7-18.7l-5.9-5.9L11.7,30.5z"/>
-		</g>
-	</g>
-	<g id="crop_x0020_marks" style="&st5;">
-		<path style="&st2;" d="M48,48H0V0h48v48z"/>
-	</g>
-</svg>

amps-python-client-5.3.4.1/docs/user-guide/html/_sources/chapters/acks.rst.txt

@@ -1,232 +0,0 @@
-.. index:: ack,
-
-.. _AMPS Command Reference: ../../../command-reference/html/index.html
-
-.. _acks:
-
-Command Acknowledgment
-======================
-
-
-AMPS command processing is designed to be asynchronous. The design of
-the server makes it possible for an application to send a command to
-AMPS, and receive the results of that command at a later time.
-Acknowledgment of commands is always optional: the server makes no
-requirement that an application request acknowledgment. The AMPS client
-libraries automatically request the acknowledgments required to
-maintain the guarantees the client API provides.
-
-The status and results of a command are returned to a client in the form
-of an acknowledgment, or ``ack``, message. AMPS can return status
-updates at various checkpoints throughout the command processing
-sequence.
-
-For many applications, it may not be necessary for the application to
-request message acknowledgments explicitly. The AMPS clients request a
-set of acknowledgments by default that balance performance with error
-detection.
-
-AMPS supports a variety of ``ack`` types, and allows you to request
-multiple ``ack`` types on each command. For example, the received ``ack``
-type requests that AMPS acknowledge when the command is received, while the
-completed ``ack`` type requests that AMPS acknowledge when it has completed
-the command (or the portion of the command that runs immediately). Each
-AMPS command supports a different set of types, and the precise meaning
-of the ``ack`` returned depends on the command that AMPS is
-acknowledging.
-
-AMPS commands are inherently *asynchronous*, and AMPS does not provide
-acknowledgment messages by default. A client must both explicitly
-request an acknowledgment and then receive and process that
-acknowledgment to know the results of a command. It is normal for time
-to elapse between the request and the acknowledgment, therefore AMPS
-acknowledgments provide a way to correlate the acknowledgment with the
-command that produced it. This is typically done with an identifier that
-the client assigns to a command, which is then returned in the
-acknowledgment for the command.
-
-AMPS supports the acknowledgment types listed in the following table:
-
-.. list-table:: *Acknowledgment types*
-     :header-rows: 1
-
-     * - **Acknowledgment Type**
-
-       - **Description**
-
-     * - ``completed``
-         
-
-       - The command (or a portion of the command) has
-         completed.
-
-     * - ``persisted``
-         
-
-       - The results of the command have been persisted
-         to durable storage.
-
-     * - ``processed``
-
-       - AMPS has processed the command.
-
-     * - ``received``
-
-       - AMPS has received the command.
-
-     * - ``stats``
-         
-
-       - AMPS returns statistics associated with the
-         command.
-
-
-
-Acknowledgments for different commands may not arrive in the order that
-commands were submitted to AMPS. For example, a ``publish`` command to a
-topic that uses synchronous replication will not return a ``persisted``
-acknowledgment until the synchronous replication destinations have
-persisted the message. If the client issues a ``subscribe`` command in
-the meantime, the ``processed`` acknowledgment for the ``subscribe``
-command -- indicating that AMPS has processed the subscription request
--- may well return before the ``persisted`` acknowledgment.
-
-Not all commands support all acknowledgment types, and the meaning of
-each acknowledgment may differ depending on the command submitted. The
-acknowledgments for different commands set different fields on an
-acknowledgment message. See the `AMPS Command Reference`_ for details.
-
-.. _#ug-ack-requesting:
-
-Requesting Acknowledgments
----------------------------
-
-Acknowledgments from the AMPS server are always optional. The AMPS
-clients will request acknowledgments as necessary for processing and
-error reporting. In addition, an application can request acknowledgments
-as necessary to meet the requirements of an application.
-
-The *AMPS Command Reference* contains information on the acknowledgment types
-available for each command and the meaning of those acknowledgments.
-
-
-.. tip::
-
-  **Developer Tip**: The AMPS client libraries automatically request
-  and automatically process the acknowledgments needed for the
-  library itself to work as expected.
-
-  An application can also request acknowledgments explicitly.
-
-  When an application explicitly requests an acknowledgment that is
-  *not* conflated (see the section on :ref:`#ug-ack-conflation` below),
-  the AMPS clients deliver that acknowledgment to the message handler
-  provided on the command, if one was provided.
-
-  If the acknowledgment is conflated, the application must either
-  provide a last chance message handler, or provide a global command
-  type message handler to process acknowledgments.
-
-.. _#ug-ack-receiving:
-
-Receiving Acknowledgments
--------------------------
-
-Acknowledgments for a specific command or subscription are delivered as a
-part of the message stream for that command. In an AMPS client, this means
-that whatever method an application is using to receive responses from AMPS
-will include acknowledgment messages.
-
-Acknowledgments from AMPS have a command type of ``ack``. This command type
-is reserved for responses from AMPS to a client. The ``CommandId`` of the
-acknowledgment message contains the ``CommandId`` provided by the client
-on the command that AMPS is responding to. The client uses this ``CommandId``
-to route the acknowledgment message to the correct message processor in
-the application.
-
-Notice that when acknowledgments are *conflated* -- that is, the
-acknowledgment refers to a number of publish commands -- AMPS does not include
-a ``CommandId`` in the acknowledgment message. Further details are provided in the
-section on :ref:`#ug-ack-conflation`. 
-
-.. _#ug-ack-completed:
-
-Bookmark Subscriptions and Completed Acknowledgments
--------------------------------------------------------
-
-When AMPS is processing a bookmark subscription, a ``completed``
-acknowledgment indicates that the subscription has completed replay from the
-transaction log. This means that the subscription has reached the point in
-the transaction log at which the subscribe command was received, and
-messages delivered on the subscription after the ``completed`` acknowledgment
-are from new publishes.
-
-Bookmark Subscriptions and Persisted Acknowledgments
--------------------------------------------------------
-
-A bookmark subscription typically also requests the ``persisted``
-acknowledgment (the AMPS clients do this automatically). In this case,
-once the replay has reached the end of the transaction log,
-AMPS periodically returns an acknowledgment that includes the last
-bookmark written to the local transaction log and acknowledged
-by all replication destinations that use ``sync`` acknowledgment.
-This information helps with application recovery, particularly in
-cases where publishers are intermittent or low-volume, and the last
-message for a subscription is significantly older than the last
-message evaluated for delivery to the subscription.
-
-This also helps to manage failover in situations where
-multiple instances in a given replication fabric are
-accepting publishes by providing a stable failover point
-across instances.
-
-
-
-.. _#ug-ack-conflation:
-
-Acknowledgment Conflation and Publish Acknowledgments
--------------------------------------------------------
-
-For some commands, AMPS will *conflate* acknowledgments and return
-acknowledgments for multiple commands at one time. When AMPS conflates
-acknowledgments, AMPS provides an identifier other than the command
-identifier that describes which commands the acknowledgment applies to.
-
-For example, when a transaction log is configured (with at least one
-topic recorded), AMPS conflates ``persisted`` acknowledgments in
-response to ``publish`` commands and ``sow_delete`` commands. These conflated
-acknowledgments contain the last client sequence number that the
-acknowledgment applies to rather than the command identifiers or
-sequence numbers for all messages being acknowledged. For example, if an
-application publishes messages with sequence numbers ``1``, ``2``,
-``3``, ``4``, and ``5``, and message ``3`` fails due to entitlement
-restrictions, AMPS will return an ``ack`` indicating success for message
-``2``, an ``ack`` indicating failure for message ``3``, and an ``ack``
-indicating success for message ``5``.
-
-By default, AMPS produces conflated acknowledgments for a given connection
-approximately once a second.
-
-Starting with version 5.2.3.0, AMPS allows configuration of the
-conflation interval. To set a different conflation interval:
-
-* For an individual client, provide an ``ack_conflation`` option in
-  the options string for the logon for that client. This sets the
-  interval at which AMPS will provide acknowledgments to that client.
-
-* For replication acknowledgments, specify the ``AckConflationInterval`` 
-  in the replication ``Destination``. This sets the interval at which the 
-  downstream AMPS server will provide acknowledgments to this AMPS server. 
-
-Notice that when a publisher is publishing to a replicated topic, the
-``ack_conflation`` interval sets the interval at which AMPS acknowledges
-messages that have already been acknowledged by synchronous replication
-destinations, while the ``AckConflationInterval`` specifies how often
-those downstream destinations produce an acknowledgment. In a situation
-where it is important to reduce the default latency of an acknowledgment,
-**both** the server option and the client side option typically need to be set. 
-
-To see more information about the different commands and their supported
-acknowledgment types, please refer to the *AMPS Command Reference*,
-provided with 4.0 and greater versions of the AMPS clients and available from 
-the 60East documentation site at http://docs.crankuptheamps.com/.

amps-python-client-5.3.4.1/docs/user-guide/html/_sources/chapters/actions.rst.txt

@@ -1,111 +0,0 @@
-.. _#ug-actions:
-
-
-.. _actions:
-
-
-Automating AMPS With Actions
-===================================
-
-.. index:: Actions,
-
-AMPS provides the ability to run scheduled tasks or respond to events,
-such as Linux signals, using the Actions interface.
-
-To create an action, you add an ``Actions`` section to the AMPS
-configuration file. Each ``Action`` contains one (or more) ``On``
-statement which specifies when the action occurs, and one (or more)
-``Do`` statement which specifies what the AMPS server does for the
-action. Within an action, AMPS performs each ``Do`` statement in the
-order in which they appear in the file.
-
-
-AMPS actions may require the use of parameters. AMPS allows you to use
-variables in the parameters of an action. You can access these variables
-using the following syntax:
-
-``{{VARIABLE_NAME}}``
-
-AMPS defines a set of default variables when running an action. The
-event, or a previous action, can add variables in the context of the
-action. Those variables can be expanded in subsequent parameters. If a
-variable is used that isn't defined at the point where it is used, AMPS
-will expand that variable to an empty string literal. The context can
-also be updated as the module is running, so any variables that are
-available at any given point in the file depend on what action was
-previously executed.
-
-By default, AMPS loads the following variables when it initializes an
-AMPS action:
-
-.. list-table:: *Default context variables*
-     :header-rows: 1
-
-     * - Variable
-
-       - Description
-
-     * - ``AMPS_INSTANCE_NAME``
-
-       - The name of the AMPS instance.
-
-     * - ``AMPS_BYTE_XX``
-         
-
-       - Insert byte *XX*, where *XX* is a 2-digit
-         uppercase hex number (00-FF). AMPS expands
-         this variable to the corresponding byte
-         value. These variables are useful for
-         creating field separators or producing
-         characters that are not permitted within
-         XML.
-
-     * - ``AMPS_DATETIME``
-         
-
-       - The current date and time in ISO-8601
-         format.
-
-     * - ``AMPS_UNIX_TIMESTAMP``
-         
-
-       - The current date and time as a UNIX
-         timestamp.
-
-
-An example to echo a message when AMPS starts up is shown below. Note
-the AMPS_INSTANCE_NAME is one of the variables that AMPS pushes to the
-context when an action is loaded.
-
-.. code-block:: xml
-
-    <Actions>
-        <Action>
-            <On>
-                <Module>amps-action-on-startup</Module>
-            </On>
-            <Do>
-                <Module>amps-action-do-echo-message</Module>
-                <Options>
-                    <Message>instance={{AMPS_INSTANCE_NAME}}</Message>        
-                </Options>
-            </Do>
-        </Action>
-    </Actions>
-
-AMPS actions are implemented as AMPS modules.  To run each statement, AMPS
-simply calls the module that implements that ``Do`` statement. The module is
-free to take any necessary actions. If a ``Do`` statement returns
-a failure, AMPS does not run subsequent ``Do`` statements in that action.
-This is intended to help make maintenance processes reliable. For example,
-if a ``Do`` statement that is intended to copy a log file to a storage
-directory fails because the device that holds the storage directory is
-not mounted, further steps in the action -- which might do things like
-remove the log file from the original directory -- should not be run. Likewise,
-if AMPS exits unexpectedly during a given ``Do`` statement, subsequent
-statements will not be run.
-
-AMPS provides the modules described in the following sections by default.
-
-.. include:: ../../common/chapters/actions-details.inc
-