got it ! [this took a long time playing]
1] Cmap(); can have 3 inputs : a value, an rgb a bitmap
2] both value and bitmap have 'value' entries
3] thus --> to set the layer weight with value AND mask, one has to use the MAP_TYPE_BITMAP, then set BOTH the value and the pFileName of this 'Cmap()'
tricky ..

Code:
from pymaxwell import *
scene = Cmaxwell(mwcallback);
material = scene.createMaterial( 'mxm_test', False );
layer = material.addLayer();
bsdf = layer.addBSDF();
reflectance = bsdf.getReflectance();
MAP = Cmap();
MAP.type = MAP_TYPE_BITMAP;
MAP.value = 100
MAP.pFileName = "D:/DATA/weightMap.jpg";
layer.setWeight(MAP)
layer.setActiveWeight(MAP)
material.write('C:/Users/userName/Desktop/mxm_test.mxm');