Reviewed and revised April 2024
xcall MIAMEX, MX_CHKPPN, dev, proj, prog, valid
MX_CHKPPN (MIAMEX 10) checks for the existence of the specified PPN on the specified device.
Parameters
dev (String) [in]
Must be set to a true (non-ersatz) device, including the trailing digit(s) but no colon, e.g. "DSK0"
proj, prog (Num) [in]
Must be set to the two parts of the PPN. Note that for historical reasons, going back to when PPNs were limited to octal values, if passed as B1 variables, they are interpreted octally. In other words, if proj = 64 (decimal) and prog = 99 (decimal), the equivalent PPN would be [100,143]. However, if proj and prog are any other types, they are interpreted decimally, the same proj and prog values would represent PPN [64,99].
valid (Num) [out]
Returns zero if the directory does not exist; else non-zero.
Comments
Since A-Shell devices and PPNs map to host machine directories, this routine is equivalent to checking for the existence of the host machine directory which corresponds to the specified device and PPN according to the DEVICEsp statements in miame.ini.
