diff --git a/src/cas/RELEASE_NOTES b/src/cas/RELEASE_NOTES index 77bff6732..54b641690 100644 --- a/src/cas/RELEASE_NOTES +++ b/src/cas/RELEASE_NOTES @@ -7,6 +7,8 @@ o The canonical PV name is returned from caServer::pvExistTest() in the supplied buffer and not in a gdd data descriptor. See "casdef.h". old API: + // + // pvExistTest() // // The server tool is encouraged to accept multiple PV name // aliases for the same PV here. However, a unique canonical name @@ -25,25 +27,37 @@ old API: virtual caStatus pvExistTest (const casCtx &ctx, const char *pPVName, gdd &canonicalPVName) = 0; new API: + // + // pvExistTest() // // The server tool is encouraged to accept multiple PV name // aliases for the same PV here. However, one unique canonical name - // must be selected by the srever tool and returned to the - // server lib for each PV. The server will use this canonical - // name to prevent internal duplication of data structures for + // must be selected by the srever tool and returned to the + // server lib for each PV. The server will use this canonical + // name to prevent internal duplication of data structures for // process variables that have multiple aliases. // - // o returns S_casApp_success and fills in the canonical name - // buffer if the PV is in this server tool + // o returns S_casApp_success and a valid canonical name string + // when the PV is in this server tool // // o returns S_casApp_pvNotFound if the PV does not exist in // the server tool // - virtual caStatus pvExistTest (const casCtx &ctx, - const char *pPVName, char *pCanonicalNameBuf, - const unsigned canonicalNameBufSize); + // Examples: + // caServerXXX::pvExistTest(const casCtx &ctx, const char *pPVName) + // { + // return pvExistReturn(S_casApp_success, pPVName); // common + // return pvExistReturn(S_casApp_pvNotFound); // no PV by that name + // + // char pName[9] = "myPVName"; + // return pvExistReturn(S_casApp_success, pName); // also common + // return pvExistReturn(S_casApp_asyncCompletion); // not now + // } + // + virtual pvExistReturn pvExistTest (const casCtx &ctx, + const char *pPVName)=0; -o The server tool must use one of class casAsyncReadIO, casAsyncWriteIO, or +o The server tool must now use one of class casAsyncReadIO, casAsyncWriteIO, or casAsyncPVExistIO in place of casAsyncIO. See "casdef.h".