Update module version and release date for V4.6.0-rc1

add request timout to PvaClientRPC

.gitignore

@@ -10,3 +10,4 @@ envPaths
 configure/*.local
 !configure/ExampleRELEASE.local
 **/O.*
+QtC-*

Doxyfile

@@ -1,4 +1,4 @@
-# Doxyfile 1.8.6
+# Doxyfile 1.8.10
 
 # This file describes the settings to be used by the documentation system
 # doxygen (www.doxygen.org) for a project.
@@ -32,7 +32,7 @@ DOXYFILE_ENCODING      = UTF-8
 # title of most generated pages and in a few other places.
 # The default value is: My Project.
 
-PROJECT_NAME           = easyPVACPP
+PROJECT_NAME           = pvaClientCPP
 
 # The PROJECT_NUMBER tag can be used to enter a project or revision number. This
 # could be handy for archiving the generated documentation or if some version
@@ -46,10 +46,10 @@ PROJECT_NUMBER         =
 
 PROJECT_BRIEF          =
 
-# With the PROJECT_LOGO tag one can specify an logo or icon that is included in
-# the documentation. The maximum height of the logo should not exceed 55 pixels
-# and the maximum width should not exceed 200 pixels. Doxygen will copy the logo
-# to the output directory.
+# With the PROJECT_LOGO tag one can specify a logo or an icon that is included
+# in the documentation. The maximum height of the logo should not exceed 55
+# pixels and the maximum width should not exceed 200 pixels. Doxygen will copy
+# the logo to the output directory.
 
 PROJECT_LOGO           =
 
@@ -60,7 +60,7 @@ PROJECT_LOGO           =
 
 OUTPUT_DIRECTORY       =
 
-# If the CREATE_SUBDIRS tag is set to YES, then doxygen will create 4096 sub-
+# If the CREATE_SUBDIRS tag is set to YES then doxygen will create 4096 sub-
 # directories (in 2 levels) under the output directory of each output format and
 # will distribute the generated files over these directories. Enabling this
 # option can be useful when feeding doxygen a huge amount of source files, where
@@ -70,6 +70,14 @@ OUTPUT_DIRECTORY       =
 
 CREATE_SUBDIRS         = NO
 
+# If the ALLOW_UNICODE_NAMES tag is set to YES, doxygen will allow non-ASCII
+# characters to appear in the names of generated files. If set to NO, non-ASCII
+# characters will be escaped, for example _xE3_x81_x84 will be used for Unicode
+# U+3044.
+# The default value is: NO.
+
+ALLOW_UNICODE_NAMES    = NO
+
 # The OUTPUT_LANGUAGE tag is used to specify the language in which all
 # documentation generated by doxygen is written. Doxygen will use this
 # information to generate all constant output in the proper language.
@@ -85,14 +93,14 @@ CREATE_SUBDIRS         = NO
 
 OUTPUT_LANGUAGE        = English
 
-# If the BRIEF_MEMBER_DESC tag is set to YES doxygen will include brief member
+# If the BRIEF_MEMBER_DESC tag is set to YES, doxygen will include brief member
 # descriptions after the members that are listed in the file and class
 # documentation (similar to Javadoc). Set to NO to disable this.
 # The default value is: YES.
 
 BRIEF_MEMBER_DESC      = YES
 
-# If the REPEAT_BRIEF tag is set to YES doxygen will prepend the brief
+# If the REPEAT_BRIEF tag is set to YES, doxygen will prepend the brief
 # description of a member or function before the detailed description
 #
 # Note: If both HIDE_UNDOC_MEMBERS and BRIEF_MEMBER_DESC are set to NO, the
@@ -127,7 +135,7 @@ ALWAYS_DETAILED_SEC    = NO
 
 INLINE_INHERITED_MEMB  = YES
 
-# If the FULL_PATH_NAMES tag is set to YES doxygen will prepend the full path
+# If the FULL_PATH_NAMES tag is set to YES, doxygen will prepend the full path
 # before files name in the file list and in the header files. If set to NO the
 # shortest path that makes the file name unique will be used
 # The default value is: YES.
@@ -169,7 +177,7 @@ SHORT_NAMES            = NO
 # description.)
 # The default value is: NO.
 
-JAVADOC_AUTOBRIEF      = YES
+JAVADOC_AUTOBRIEF      = NO
 
 # If the QT_AUTOBRIEF tag is set to YES then doxygen will interpret the first
 # line (until the first dot) of a Qt-style comment as the brief description. If
@@ -197,9 +205,9 @@ MULTILINE_CPP_IS_BRIEF = NO
 
 INHERIT_DOCS           = YES
 
-# If the SEPARATE_MEMBER_PAGES tag is set to YES, then doxygen will produce a
-# new page for each member. If set to NO, the documentation of a member will be
-# part of the file/class/namespace that contains it.
+# If the SEPARATE_MEMBER_PAGES tag is set to YES then doxygen will produce a new
+# page for each member. If set to NO, the documentation of a member will be part
+# of the file/class/namespace that contains it.
 # The default value is: NO.
 
 SEPARATE_MEMBER_PAGES  = NO
@@ -261,11 +269,14 @@ OPTIMIZE_OUTPUT_VHDL   = NO
 # extension. Doxygen has a built-in mapping, but you can override or extend it
 # using this tag. The format is ext=language, where ext is a file extension, and
 # language is one of the parsers supported by doxygen: IDL, Java, Javascript,
-# C#, C, C++, D, PHP, Objective-C, Python, Fortran, VHDL. For instance to make
-# doxygen treat .inc files as Fortran files (default is PHP), and .f files as C
-# (default is Fortran), use: inc=Fortran f=C.
+# C#, C, C++, D, PHP, Objective-C, Python, Fortran (fixed format Fortran:
+# FortranFixed, free formatted Fortran: FortranFree, unknown formatted Fortran:
+# Fortran. In the later case the parser tries to guess whether the code is fixed
+# or free formatted code, this is the default for Fortran type files), VHDL. For
+# instance to make doxygen treat .inc files as Fortran files (default is PHP),
+# and .f files as C (default is Fortran), use: inc=Fortran f=C.
 #
-# Note For files without extension you can use no_extension as a placeholder.
+# Note: For files without extension you can use no_extension as a placeholder.
 #
 # Note that for custom extensions you also need to set FILE_PATTERNS otherwise
 # the files are not read by doxygen.
@@ -284,8 +295,8 @@ MARKDOWN_SUPPORT       = YES
 
 # When enabled doxygen tries to link words that correspond to documented
 # classes, or namespaces to their corresponding documentation. Such a link can
-# be prevented in individual cases by by putting a % sign in front of the word
-# or globally by setting AUTOLINK_SUPPORT to NO.
+# be prevented in individual cases by putting a % sign in front of the word or
+# globally by setting AUTOLINK_SUPPORT to NO.
 # The default value is: YES.
 
 AUTOLINK_SUPPORT       = YES
@@ -325,13 +336,20 @@ SIP_SUPPORT            = NO
 IDL_PROPERTY_SUPPORT   = YES
 
 # If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC
-# tag is set to YES, then doxygen will reuse the documentation of the first
+# tag is set to YES then doxygen will reuse the documentation of the first
 # member in the group (if any) for the other members of the group. By default
 # all members of a group must be documented explicitly.
 # The default value is: NO.
 
 DISTRIBUTE_GROUP_DOC   = NO
 
+# If one adds a struct or class to a group and this option is enabled, then also
+# any nested class or struct is added to the same group. By default this option
+# is disabled and one has to add nested compounds explicitly via \ingroup.
+# The default value is: NO.
+
+GROUP_NESTED_COMPOUNDS = NO
+
 # Set the SUBGROUPING tag to YES to allow class member groups of the same type
 # (for instance a group of public functions) to be put as a subgroup of that
 # type (e.g. under the Public Functions section). Set it to NO to prevent
@@ -390,7 +408,7 @@ LOOKUP_CACHE_SIZE      = 0
 # Build related configuration options
 #---------------------------------------------------------------------------
 
-# If the EXTRACT_ALL tag is set to YES doxygen will assume all entities in
+# If the EXTRACT_ALL tag is set to YES, doxygen will assume all entities in
 # documentation are documented, even if no documentation was available. Private
 # class members and static file members will be hidden unless the
 # EXTRACT_PRIVATE respectively EXTRACT_STATIC tags are set to YES.
@@ -400,35 +418,35 @@ LOOKUP_CACHE_SIZE      = 0
 
 EXTRACT_ALL            = YES
 
-# If the EXTRACT_PRIVATE tag is set to YES all private members of a class will
+# If the EXTRACT_PRIVATE tag is set to YES, all private members of a class will
 # be included in the documentation.
 # The default value is: NO.
 
 EXTRACT_PRIVATE        = NO
 
-# If the EXTRACT_PACKAGE tag is set to YES all members with package or internal
+# If the EXTRACT_PACKAGE tag is set to YES, all members with package or internal
 # scope will be included in the documentation.
 # The default value is: NO.
 
 EXTRACT_PACKAGE        = NO
 
-# If the EXTRACT_STATIC tag is set to YES all static members of a file will be
+# If the EXTRACT_STATIC tag is set to YES, all static members of a file will be
 # included in the documentation.
 # The default value is: NO.
 
 EXTRACT_STATIC         = NO
 
-# If the EXTRACT_LOCAL_CLASSES tag is set to YES classes (and structs) defined
-# locally in source files will be included in the documentation. If set to NO
+# If the EXTRACT_LOCAL_CLASSES tag is set to YES, classes (and structs) defined
+# locally in source files will be included in the documentation. If set to NO,
 # only classes defined in header files are included. Does not have any effect
 # for Java sources.
 # The default value is: YES.
 
 EXTRACT_LOCAL_CLASSES  = NO
 
-# This flag is only useful for Objective-C code. When set to YES local methods,
+# This flag is only useful for Objective-C code. If set to YES, local methods,
 # which are defined in the implementation section but not in the interface are
-# included in the documentation. If set to NO only methods in the interface are
+# included in the documentation. If set to NO, only methods in the interface are
 # included.
 # The default value is: NO.
 
@@ -453,21 +471,21 @@ HIDE_UNDOC_MEMBERS     = NO
 
 # If the HIDE_UNDOC_CLASSES tag is set to YES, doxygen will hide all
 # undocumented classes that are normally visible in the class hierarchy. If set
-# to NO these classes will be included in the various overviews. This option has
-# no effect if EXTRACT_ALL is enabled.
+# to NO, these classes will be included in the various overviews. This option
+# has no effect if EXTRACT_ALL is enabled.
 # The default value is: NO.
 
 HIDE_UNDOC_CLASSES     = NO
 
 # If the HIDE_FRIEND_COMPOUNDS tag is set to YES, doxygen will hide all friend
-# (class|struct|union) declarations. If set to NO these declarations will be
+# (class|struct|union) declarations. If set to NO, these declarations will be
 # included in the documentation.
 # The default value is: NO.
 
 HIDE_FRIEND_COMPOUNDS  = NO
 
 # If the HIDE_IN_BODY_DOCS tag is set to YES, doxygen will hide any
-# documentation blocks found inside the body of a function. If set to NO these
+# documentation blocks found inside the body of a function. If set to NO, these
 # blocks will be appended to the function's detailed documentation block.
 # The default value is: NO.
 
@@ -481,7 +499,7 @@ HIDE_IN_BODY_DOCS      = NO
 INTERNAL_DOCS          = NO
 
 # If the CASE_SENSE_NAMES tag is set to NO then doxygen will only generate file
-# names in lower-case letters. If set to YES upper-case letters are also
+# names in lower-case letters. If set to YES, upper-case letters are also
 # allowed. This is useful if you have classes or files whose names only differ
 # in case and if your file system supports case sensitive file names. Windows
 # and Mac users are advised to set this option to NO.
@@ -490,12 +508,19 @@ INTERNAL_DOCS          = NO
 CASE_SENSE_NAMES       = YES
 
 # If the HIDE_SCOPE_NAMES tag is set to NO then doxygen will show members with
-# their full class and namespace scopes in the documentation. If set to YES the
+# their full class and namespace scopes in the documentation. If set to YES, the
 # scope will be hidden.
 # The default value is: NO.
 
 HIDE_SCOPE_NAMES       = NO
 
+# If the HIDE_COMPOUND_REFERENCE tag is set to NO (default) then doxygen will
+# append additional text to a page's title, such as Class Reference. If set to
+# YES the compound reference will be hidden.
+# The default value is: NO.
+
+HIDE_COMPOUND_REFERENCE= NO
+
 # If the SHOW_INCLUDE_FILES tag is set to YES then doxygen will put a list of
 # the files that are included by a file in the documentation of that file.
 # The default value is: YES.
@@ -523,14 +548,14 @@ INLINE_INFO            = YES
 
 # If the SORT_MEMBER_DOCS tag is set to YES then doxygen will sort the
 # (detailed) documentation of file and class members alphabetically by member
-# name. If set to NO the members will appear in declaration order.
+# name. If set to NO, the members will appear in declaration order.
 # The default value is: YES.
 
 SORT_MEMBER_DOCS       = YES
 
 # If the SORT_BRIEF_DOCS tag is set to YES then doxygen will sort the brief
 # descriptions of file, namespace and class members alphabetically by member
-# name. If set to NO the members will appear in declaration order. Note that
+# name. If set to NO, the members will appear in declaration order. Note that
 # this will also influence the order of the classes in the class list.
 # The default value is: NO.
 
@@ -575,27 +600,25 @@ SORT_BY_SCOPE_NAME     = NO
 
 STRICT_PROTO_MATCHING  = NO
 
-# The GENERATE_TODOLIST tag can be used to enable ( YES) or disable ( NO) the
-# todo list. This list is created by putting \todo commands in the
-# documentation.
+# The GENERATE_TODOLIST tag can be used to enable (YES) or disable (NO) the todo
+# list. This list is created by putting \todo commands in the documentation.
 # The default value is: YES.
 
 GENERATE_TODOLIST      = YES
 
-# The GENERATE_TESTLIST tag can be used to enable ( YES) or disable ( NO) the
-# test list. This list is created by putting \test commands in the
-# documentation.
+# The GENERATE_TESTLIST tag can be used to enable (YES) or disable (NO) the test
+# list. This list is created by putting \test commands in the documentation.
 # The default value is: YES.
 
 GENERATE_TESTLIST      = YES
 
-# The GENERATE_BUGLIST tag can be used to enable ( YES) or disable ( NO) the bug
+# The GENERATE_BUGLIST tag can be used to enable (YES) or disable (NO) the bug
 # list. This list is created by putting \bug commands in the documentation.
 # The default value is: YES.
 
 GENERATE_BUGLIST       = YES
 
-# The GENERATE_DEPRECATEDLIST tag can be used to enable ( YES) or disable ( NO)
+# The GENERATE_DEPRECATEDLIST tag can be used to enable (YES) or disable (NO)
 # the deprecated list. This list is created by putting \deprecated commands in
 # the documentation.
 # The default value is: YES.
@@ -620,8 +643,8 @@ ENABLED_SECTIONS       =
 MAX_INITIALIZER_LINES  = 30
 
 # Set the SHOW_USED_FILES tag to NO to disable the list of files generated at
-# the bottom of the documentation of classes and structs. If set to YES the list
-# will mention the files that were used to generate the documentation.
+# the bottom of the documentation of classes and structs. If set to YES, the
+# list will mention the files that were used to generate the documentation.
 # The default value is: YES.
 
 SHOW_USED_FILES        = YES
@@ -669,8 +692,7 @@ LAYOUT_FILE            =
 # to be installed. See also http://en.wikipedia.org/wiki/BibTeX for more info.
 # For LaTeX the style of the bibliography can be controlled using
 # LATEX_BIB_STYLE. To use this feature you need bibtex and perl available in the
-# search path. Do not use file names with spaces, bibtex cannot handle them. See
-# also \cite for info how to create references.
+# search path. See also \cite for info how to create references.
 
 CITE_BIB_FILES         =
 
@@ -686,7 +708,7 @@ CITE_BIB_FILES         =
 QUIET                  = NO
 
 # The WARNINGS tag can be used to turn on/off the warning messages that are
-# generated to standard error ( stderr) by doxygen. If WARNINGS is set to YES
+# generated to standard error (stderr) by doxygen. If WARNINGS is set to YES
 # this implies that the warnings are on.
 #
 # Tip: Turn warnings on while writing the documentation.
@@ -694,7 +716,7 @@ QUIET                  = NO
 
 WARNINGS               = YES
 
-# If the WARN_IF_UNDOCUMENTED tag is set to YES, then doxygen will generate
+# If the WARN_IF_UNDOCUMENTED tag is set to YES then doxygen will generate
 # warnings for undocumented members. If EXTRACT_ALL is set to YES then this flag
 # will automatically be disabled.
 # The default value is: YES.
@@ -711,8 +733,8 @@ WARN_IF_DOC_ERROR      = YES
 
 # This WARN_NO_PARAMDOC option can be enabled to get warnings for functions that
 # are documented, but have no documentation for their parameters or return
-# value. If set to NO doxygen will only warn about wrong or incomplete parameter
-# documentation, but not about the absence of documentation.
+# value. If set to NO, doxygen will only warn about wrong or incomplete
+# parameter documentation, but not about the absence of documentation.
 # The default value is: NO.
 
 WARN_NO_PARAMDOC       = NO
@@ -740,7 +762,7 @@ WARN_LOGFILE           =
 # The INPUT tag is used to specify the files and/or directories that contain
 # documented source files. You may enter file names like myfile.cpp or
 # directories like /usr/src/myproject. Separate the files or directories with
-# spaces.
+# spaces. See also FILE_PATTERNS and EXTENSION_MAPPING
 # Note: If this tag is empty the current directory is searched.
 
 INPUT                  = include
@@ -756,12 +778,17 @@ INPUT_ENCODING         = UTF-8
 
 # If the value of the INPUT tag contains directories, you can use the
 # FILE_PATTERNS tag to specify one or more wildcard patterns (like *.cpp and
-# *.h) to filter out the source-files in the directories. If left blank the
-# following patterns are tested:*.c, *.cc, *.cxx, *.cpp, *.c++, *.java, *.ii,
-# *.ixx, *.ipp, *.i++, *.inl, *.idl, *.ddl, *.odl, *.h, *.hh, *.hxx, *.hpp,
-# *.h++, *.cs, *.d, *.php, *.php4, *.php5, *.phtml, *.inc, *.m, *.markdown,
-# *.md, *.mm, *.dox, *.py, *.f90, *.f, *.for, *.tcl, *.vhd, *.vhdl, *.ucf,
-# *.qsf, *.as and *.js.
+# *.h) to filter out the source-files in the directories.
+#
+# Note that for custom extensions or not directly supported extensions you also
+# need to set EXTENSION_MAPPING for the extension otherwise the files are not
+# read by doxygen.
+#
+# If left blank the following patterns are tested:*.c, *.cc, *.cxx, *.cpp,
+# *.c++, *.java, *.ii, *.ixx, *.ipp, *.i++, *.inl, *.idl, *.ddl, *.odl, *.h,
+# *.hh, *.hxx, *.hpp, *.h++, *.cs, *.d, *.php, *.php4, *.php5, *.phtml, *.inc,
+# *.m, *.markdown, *.md, *.mm, *.dox, *.py, *.f90, *.f, *.for, *.tcl, *.vhd,
+# *.vhdl, *.ucf, *.qsf, *.as and *.js.
 
 FILE_PATTERNS          =
 
@@ -860,7 +887,7 @@ INPUT_FILTER           =
 FILTER_PATTERNS        =
 
 # If the FILTER_SOURCE_FILES tag is set to YES, the input filter (if set using
-# INPUT_FILTER ) will also be used to filter the input files that are used for
+# INPUT_FILTER) will also be used to filter the input files that are used for
 # producing the source files to browse (i.e. when SOURCE_BROWSER is set to YES).
 # The default value is: NO.
 
@@ -920,7 +947,7 @@ REFERENCED_BY_RELATION = YES
 REFERENCES_RELATION    = YES
 
 # If the REFERENCES_LINK_SOURCE tag is set to YES and SOURCE_BROWSER tag is set
-# to YES, then the hyperlinks from functions in REFERENCES_RELATION and
+# to YES then the hyperlinks from functions in REFERENCES_RELATION and
 # REFERENCED_BY_RELATION lists will link to the source code. Otherwise they will
 # link to the documentation.
 # The default value is: YES.
@@ -997,7 +1024,7 @@ IGNORE_PREFIX          =
 # Configuration options related to the HTML output
 #---------------------------------------------------------------------------
 
-# If the GENERATE_HTML tag is set to YES doxygen will generate HTML output
+# If the GENERATE_HTML tag is set to YES, doxygen will generate HTML output
 # The default value is: YES.
 
 GENERATE_HTML          = YES
@@ -1059,13 +1086,15 @@ HTML_FOOTER            =
 
 HTML_STYLESHEET        =
 
-# The HTML_EXTRA_STYLESHEET tag can be used to specify an additional user-
-# defined cascading style sheet that is included after the standard style sheets
+# The HTML_EXTRA_STYLESHEET tag can be used to specify additional user-defined
+# cascading style sheets that are included after the standard style sheets
 # created by doxygen. Using this option one can overrule certain style aspects.
 # This is preferred over using HTML_STYLESHEET since it does not replace the
-# standard style sheet and is therefor more robust against future updates.
-# Doxygen will copy the style sheet file to the output directory. For an example
-# see the documentation.
+# standard style sheet and is therefore more robust against future updates.
+# Doxygen will copy the style sheet files to the output directory.
+# Note: The order of the extra style sheet files is of importance (e.g. the last
+# style sheet in the list overrules the setting of the previous ones in the
+# list). For an example see the documentation.
 # This tag requires that the tag GENERATE_HTML is set to YES.
 
 HTML_EXTRA_STYLESHEET  =
@@ -1078,10 +1107,10 @@ HTML_EXTRA_STYLESHEET  =
 # files will be copied as-is; there are no commands or markers available.
 # This tag requires that the tag GENERATE_HTML is set to YES.
 
-HTML_EXTRA_FILES       = documentation/overview.html
+HTML_EXTRA_FILES       =
 
 # The HTML_COLORSTYLE_HUE tag controls the color of the HTML output. Doxygen
-# will adjust the colors in the stylesheet and background images according to
+# will adjust the colors in the style sheet and background images according to
 # this color. Hue is specified as an angle on a colorwheel, see
 # http://en.wikipedia.org/wiki/Hue for more information. For instance the value
 # 0 represents red, 60 is yellow, 120 is green, 180 is cyan, 240 is blue, 300
@@ -1112,8 +1141,9 @@ HTML_COLORSTYLE_GAMMA  = 80
 
 # If the HTML_TIMESTAMP tag is set to YES then the footer of each generated HTML
 # page will contain the date and time when the page was generated. Setting this
-# to NO can help when comparing the output of multiple runs.
-# The default value is: YES.
+# to YES can help to show when doxygen was last run and thus if the
+# documentation is up to date.
+# The default value is: NO.
 # This tag requires that the tag GENERATE_HTML is set to YES.
 
 HTML_TIMESTAMP         = YES
@@ -1209,28 +1239,29 @@ GENERATE_HTMLHELP      = NO
 CHM_FILE               =
 
 # The HHC_LOCATION tag can be used to specify the location (absolute path
-# including file name) of the HTML help compiler ( hhc.exe). If non-empty
+# including file name) of the HTML help compiler (hhc.exe). If non-empty,
 # doxygen will try to run the HTML help compiler on the generated index.hhp.
 # The file has to be specified with full path.
 # This tag requires that the tag GENERATE_HTMLHELP is set to YES.
 
 HHC_LOCATION           =
 
-# The GENERATE_CHI flag controls if a separate .chi index file is generated (
-# YES) or that it should be included in the master .chm file ( NO).
+# The GENERATE_CHI flag controls if a separate .chi index file is generated
+# (YES) or that it should be included in the master .chm file (NO).
 # The default value is: NO.
 # This tag requires that the tag GENERATE_HTMLHELP is set to YES.
 
 GENERATE_CHI           = NO
 
-# The CHM_INDEX_ENCODING is used to encode HtmlHelp index ( hhk), content ( hhc)
+# The CHM_INDEX_ENCODING is used to encode HtmlHelp index (hhk), content (hhc)
 # and project file content.
 # This tag requires that the tag GENERATE_HTMLHELP is set to YES.
 
 CHM_INDEX_ENCODING     =
 
-# The BINARY_TOC flag controls whether a binary table of contents is generated (
-# YES) or a normal table of contents ( NO) in the .chm file.
+# The BINARY_TOC flag controls whether a binary table of contents is generated
+# (YES) or a normal table of contents (NO) in the .chm file. Furthermore it
+# enables the Previous and Next buttons.
 # The default value is: NO.
 # This tag requires that the tag GENERATE_HTMLHELP is set to YES.
 
@@ -1343,7 +1374,7 @@ DISABLE_INDEX          = NO
 # index structure (just like the one that is generated for HTML Help). For this
 # to work a browser that supports JavaScript, DHTML, CSS and frames is required
 # (i.e. any modern browser). Windows users are probably better off using the
-# HTML help feature. Via custom stylesheets (see HTML_EXTRA_STYLESHEET) one can
+# HTML help feature. Via custom style sheets (see HTML_EXTRA_STYLESHEET) one can
 # further fine-tune the look of the index. As an example, the default style
 # sheet generated by doxygen has an example that shows how to put an image at
 # the root of the tree instead of the PROJECT_NAME. Since the tree basically has
@@ -1371,7 +1402,7 @@ ENUM_VALUES_PER_LINE   = 4
 
 TREEVIEW_WIDTH         = 250
 
-# When the EXT_LINKS_IN_WINDOW option is set to YES doxygen will open links to
+# If the EXT_LINKS_IN_WINDOW option is set to YES, doxygen will open links to
 # external symbols imported via tag files in a separate window.
 # The default value is: NO.
 # This tag requires that the tag GENERATE_HTML is set to YES.
@@ -1400,7 +1431,7 @@ FORMULA_TRANSPARENT    = YES
 
 # Enable the USE_MATHJAX option to render LaTeX formulas using MathJax (see
 # http://www.mathjax.org) which uses client side Javascript for the rendering
-# instead of using prerendered bitmaps. Use this if you do not have LaTeX
+# instead of using pre-rendered bitmaps. Use this if you do not have LaTeX
 # installed or if you want to formulas look prettier in the HTML output. When
 # enabled you may also need to install MathJax separately and configure the path
 # to it using the MATHJAX_RELPATH option.
@@ -1470,11 +1501,11 @@ SEARCHENGINE           = NO
 
 # When the SERVER_BASED_SEARCH tag is enabled the search engine will be
 # implemented using a web server instead of a web client using Javascript. There
-# are two flavours of web server based searching depending on the
-# EXTERNAL_SEARCH setting. When disabled, doxygen will generate a PHP script for
-# searching and an index file used by the script. When EXTERNAL_SEARCH is
-# enabled the indexing and searching needs to be provided by external tools. See
-# the section "External Indexing and Searching" for details.
+# are two flavors of web server based searching depending on the EXTERNAL_SEARCH
+# setting. When disabled, doxygen will generate a PHP script for searching and
+# an index file used by the script. When EXTERNAL_SEARCH is enabled the indexing
+# and searching needs to be provided by external tools. See the section
+# "External Indexing and Searching" for details.
 # The default value is: NO.
 # This tag requires that the tag SEARCHENGINE is set to YES.
 
@@ -1486,7 +1517,7 @@ SERVER_BASED_SEARCH    = NO
 # external search engine pointed to by the SEARCHENGINE_URL option to obtain the
 # search results.
 #
-# Doxygen ships with an example indexer ( doxyindexer) and search engine
+# Doxygen ships with an example indexer (doxyindexer) and search engine
 # (doxysearch.cgi) which are based on the open source search engine library
 # Xapian (see: http://xapian.org/).
 #
@@ -1499,7 +1530,7 @@ EXTERNAL_SEARCH        = NO
 # The SEARCHENGINE_URL should point to a search engine hosted by a web server
 # which will return the search results when EXTERNAL_SEARCH is enabled.
 #
-# Doxygen ships with an example indexer ( doxyindexer) and search engine
+# Doxygen ships with an example indexer (doxyindexer) and search engine
 # (doxysearch.cgi) which are based on the open source search engine library
 # Xapian (see: http://xapian.org/). See the section "External Indexing and
 # Searching" for details.
@@ -1537,7 +1568,7 @@ EXTRA_SEARCH_MAPPINGS  =
 # Configuration options related to the LaTeX output
 #---------------------------------------------------------------------------
 
-# If the GENERATE_LATEX tag is set to YES doxygen will generate LaTeX output.
+# If the GENERATE_LATEX tag is set to YES, doxygen will generate LaTeX output.
 # The default value is: YES.
 
 GENERATE_LATEX         = NO
@@ -1568,7 +1599,7 @@ LATEX_CMD_NAME         = latex
 
 MAKEINDEX_CMD_NAME     = makeindex
 
-# If the COMPACT_LATEX tag is set to YES doxygen generates more compact LaTeX
+# If the COMPACT_LATEX tag is set to YES, doxygen generates more compact LaTeX
 # documents. This may be useful for small projects and may help to save some
 # trees in general.
 # The default value is: NO.
@@ -1586,9 +1617,12 @@ COMPACT_LATEX          = NO
 PAPER_TYPE             = a4wide
 
 # The EXTRA_PACKAGES tag can be used to specify one or more LaTeX package names
-# that should be included in the LaTeX output. To get the times font for
-# instance you can specify
-# EXTRA_PACKAGES=times
+# that should be included in the LaTeX output. The package can be specified just
+# by its name or with the correct syntax as to be used with the LaTeX
+# \usepackage command. To get the times font for instance you can specify :
+# EXTRA_PACKAGES=times or EXTRA_PACKAGES={times}
+# To use the option intlimits with the amsmath package you can specify:
+# EXTRA_PACKAGES=[intlimits]{amsmath}
 # If left blank no extra packages will be included.
 # This tag requires that the tag GENERATE_LATEX is set to YES.
 
@@ -1602,23 +1636,36 @@ EXTRA_PACKAGES         =
 #
 # Note: Only use a user-defined header if you know what you are doing! The
 # following commands have a special meaning inside the header: $title,
-# $datetime, $date, $doxygenversion, $projectname, $projectnumber. Doxygen will
-# replace them by respectively the title of the page, the current date and time,
-# only the current date, the version number of doxygen, the project name (see
-# PROJECT_NAME), or the project number (see PROJECT_NUMBER).
+# $datetime, $date, $doxygenversion, $projectname, $projectnumber,
+# $projectbrief, $projectlogo. Doxygen will replace $title with the empty
+# string, for the replacement values of the other commands the user is referred
+# to HTML_HEADER.
 # This tag requires that the tag GENERATE_LATEX is set to YES.
 
 LATEX_HEADER           =
 
 # The LATEX_FOOTER tag can be used to specify a personal LaTeX footer for the
 # generated LaTeX document. The footer should contain everything after the last
-# chapter. If it is left blank doxygen will generate a standard footer.
+# chapter. If it is left blank doxygen will generate a standard footer. See
+# LATEX_HEADER for more information on how to generate a default footer and what
+# special commands can be used inside the footer.
 #
 # Note: Only use a user-defined footer if you know what you are doing!
 # This tag requires that the tag GENERATE_LATEX is set to YES.
 
 LATEX_FOOTER           =
 
+# The LATEX_EXTRA_STYLESHEET tag can be used to specify additional user-defined
+# LaTeX style sheets that are included after the standard style sheets created
+# by doxygen. Using this option one can overrule certain style aspects. Doxygen
+# will copy the style sheet files to the output directory.
+# Note: The order of the extra style sheet files is of importance (e.g. the last
+# style sheet in the list overrules the setting of the previous ones in the
+# list).
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_EXTRA_STYLESHEET =
+
 # The LATEX_EXTRA_FILES tag can be used to specify one or more extra images or
 # other source files which should be copied to the LATEX_OUTPUT output
 # directory. Note that the files will be copied as-is; there are no commands or
@@ -1636,8 +1683,8 @@ LATEX_EXTRA_FILES      =
 
 PDF_HYPERLINKS         = NO
 
-# If the LATEX_PDFLATEX tag is set to YES, doxygen will use pdflatex to generate
-# the PDF file directly from the LaTeX files. Set this option to YES to get a
+# If the USE_PDFLATEX tag is set to YES, doxygen will use pdflatex to generate
+# the PDF file directly from the LaTeX files. Set this option to YES, to get a
 # higher quality PDF documentation.
 # The default value is: YES.
 # This tag requires that the tag GENERATE_LATEX is set to YES.
@@ -1678,11 +1725,19 @@ LATEX_SOURCE_CODE      = NO
 
 LATEX_BIB_STYLE        = plain
 
+# If the LATEX_TIMESTAMP tag is set to YES then the footer of each generated
+# page will contain the date and time when the page was generated. Setting this
+# to NO can help when comparing the output of multiple runs.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_LATEX is set to YES.
+
+LATEX_TIMESTAMP        = NO
+
 #---------------------------------------------------------------------------
 # Configuration options related to the RTF output
 #---------------------------------------------------------------------------
 
-# If the GENERATE_RTF tag is set to YES doxygen will generate RTF output. The
+# If the GENERATE_RTF tag is set to YES, doxygen will generate RTF output. The
 # RTF output is optimized for Word 97 and may not look too pretty with other RTF
 # readers/editors.
 # The default value is: NO.
@@ -1697,7 +1752,7 @@ GENERATE_RTF           = NO
 
 RTF_OUTPUT             = rtf
 
-# If the COMPACT_RTF tag is set to YES doxygen generates more compact RTF
+# If the COMPACT_RTF tag is set to YES, doxygen generates more compact RTF
 # documents. This may be useful for small projects and may help to save some
 # trees in general.
 # The default value is: NO.
@@ -1734,11 +1789,21 @@ RTF_STYLESHEET_FILE    =
 
 RTF_EXTENSIONS_FILE    =
 
+# If the RTF_SOURCE_CODE tag is set to YES then doxygen will include source code
+# with syntax highlighting in the RTF output.
+#
+# Note that which sources are shown also depends on other settings such as
+# SOURCE_BROWSER.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_RTF is set to YES.
+
+RTF_SOURCE_CODE        = NO
+
 #---------------------------------------------------------------------------
 # Configuration options related to the man page output
 #---------------------------------------------------------------------------
 
-# If the GENERATE_MAN tag is set to YES doxygen will generate man pages for
+# If the GENERATE_MAN tag is set to YES, doxygen will generate man pages for
 # classes and files.
 # The default value is: NO.
 
@@ -1762,6 +1827,13 @@ MAN_OUTPUT             = man
 
 MAN_EXTENSION          = .3
 
+# The MAN_SUBDIR tag determines the name of the directory created within
+# MAN_OUTPUT in which the man pages are placed. If defaults to man followed by
+# MAN_EXTENSION with the initial . removed.
+# This tag requires that the tag GENERATE_MAN is set to YES.
+
+MAN_SUBDIR             =
+
 # If the MAN_LINKS tag is set to YES and doxygen generates man output, then it
 # will generate one additional man file for each entity documented in the real
 # man page(s). These additional files only source the real man page, but without
@@ -1775,7 +1847,7 @@ MAN_LINKS              = NO
 # Configuration options related to the XML output
 #---------------------------------------------------------------------------
 
-# If the GENERATE_XML tag is set to YES doxygen will generate an XML file that
+# If the GENERATE_XML tag is set to YES, doxygen will generate an XML file that
 # captures the structure of the code including all documentation.
 # The default value is: NO.
 
@@ -1789,19 +1861,7 @@ GENERATE_XML           = NO
 
 XML_OUTPUT             = xml
 
-# The XML_SCHEMA tag can be used to specify a XML schema, which can be used by a
-# validating XML parser to check the syntax of the XML files.
-# This tag requires that the tag GENERATE_XML is set to YES.
-
-XML_SCHEMA             =
-
-# The XML_DTD tag can be used to specify a XML DTD, which can be used by a
-# validating XML parser to check the syntax of the XML files.
-# This tag requires that the tag GENERATE_XML is set to YES.
-
-XML_DTD                =
-
-# If the XML_PROGRAMLISTING tag is set to YES doxygen will dump the program
+# If the XML_PROGRAMLISTING tag is set to YES, doxygen will dump the program
 # listings (including syntax highlighting and cross-referencing information) to
 # the XML output. Note that enabling this will significantly increase the size
 # of the XML output.
@@ -1814,7 +1874,7 @@ XML_PROGRAMLISTING     = YES
 # Configuration options related to the DOCBOOK output
 #---------------------------------------------------------------------------
 
-# If the GENERATE_DOCBOOK tag is set to YES doxygen will generate Docbook files
+# If the GENERATE_DOCBOOK tag is set to YES, doxygen will generate Docbook files
 # that can be used to generate PDF.
 # The default value is: NO.
 
@@ -1828,14 +1888,23 @@ GENERATE_DOCBOOK       = NO
 
 DOCBOOK_OUTPUT         = docbook
 
+# If the DOCBOOK_PROGRAMLISTING tag is set to YES, doxygen will include the
+# program listings (including syntax highlighting and cross-referencing
+# information) to the DOCBOOK output. Note that enabling this will significantly
+# increase the size of the DOCBOOK output.
+# The default value is: NO.
+# This tag requires that the tag GENERATE_DOCBOOK is set to YES.
+
+DOCBOOK_PROGRAMLISTING = NO
+
 #---------------------------------------------------------------------------
 # Configuration options for the AutoGen Definitions output
 #---------------------------------------------------------------------------
 
-# If the GENERATE_AUTOGEN_DEF tag is set to YES doxygen will generate an AutoGen
-# Definitions (see http://autogen.sf.net) file that captures the structure of
-# the code including all documentation. Note that this feature is still
-# experimental and incomplete at the moment.
+# If the GENERATE_AUTOGEN_DEF tag is set to YES, doxygen will generate an
+# AutoGen Definitions (see http://autogen.sf.net) file that captures the
+# structure of the code including all documentation. Note that this feature is
+# still experimental and incomplete at the moment.
 # The default value is: NO.
 
 GENERATE_AUTOGEN_DEF   = NO
@@ -1844,7 +1913,7 @@ GENERATE_AUTOGEN_DEF   = NO
 # Configuration options related to the Perl module output
 #---------------------------------------------------------------------------
 
-# If the GENERATE_PERLMOD tag is set to YES doxygen will generate a Perl module
+# If the GENERATE_PERLMOD tag is set to YES, doxygen will generate a Perl module
 # file that captures the structure of the code including all documentation.
 #
 # Note that this feature is still experimental and incomplete at the moment.
@@ -1852,7 +1921,7 @@ GENERATE_AUTOGEN_DEF   = NO
 
 GENERATE_PERLMOD       = NO
 
-# If the PERLMOD_LATEX tag is set to YES doxygen will generate the necessary
+# If the PERLMOD_LATEX tag is set to YES, doxygen will generate the necessary
 # Makefile rules, Perl scripts and LaTeX code to be able to generate PDF and DVI
 # output from the Perl module output.
 # The default value is: NO.
@@ -1860,9 +1929,9 @@ GENERATE_PERLMOD       = NO
 
 PERLMOD_LATEX          = NO
 
-# If the PERLMOD_PRETTY tag is set to YES the Perl module output will be nicely
+# If the PERLMOD_PRETTY tag is set to YES, the Perl module output will be nicely
 # formatted so it can be parsed by a human reader. This is useful if you want to
-# understand what is going on. On the other hand, if this tag is set to NO the
+# understand what is going on. On the other hand, if this tag is set to NO, the
 # size of the Perl module output will be much smaller and Perl will parse it
 # just the same.
 # The default value is: YES.
@@ -1882,14 +1951,14 @@ PERLMOD_MAKEVAR_PREFIX =
 # Configuration options related to the preprocessor
 #---------------------------------------------------------------------------
 
-# If the ENABLE_PREPROCESSING tag is set to YES doxygen will evaluate all
+# If the ENABLE_PREPROCESSING tag is set to YES, doxygen will evaluate all
 # C-preprocessor directives found in the sources and include files.
 # The default value is: YES.
 
 ENABLE_PREPROCESSING   = YES
 
-# If the MACRO_EXPANSION tag is set to YES doxygen will expand all macro names
-# in the source code. If set to NO only conditional compilation will be
+# If the MACRO_EXPANSION tag is set to YES, doxygen will expand all macro names
+# in the source code. If set to NO, only conditional compilation will be
 # performed. Macro expansion can be done in a controlled way by setting
 # EXPAND_ONLY_PREDEF to YES.
 # The default value is: NO.
@@ -1905,7 +1974,7 @@ MACRO_EXPANSION        = NO
 
 EXPAND_ONLY_PREDEF     = NO
 
-# If the SEARCH_INCLUDES tag is set to YES the includes files in the
+# If the SEARCH_INCLUDES tag is set to YES, the include files in the
 # INCLUDE_PATH will be searched if a #include is found.
 # The default value is: YES.
 # This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
@@ -1947,9 +2016,9 @@ PREDEFINED             =
 EXPAND_AS_DEFINED      =
 
 # If the SKIP_FUNCTION_MACROS tag is set to YES then doxygen's preprocessor will
-# remove all refrences to function-like macros that are alone on a line, have an
-# all uppercase name, and do not end with a semicolon. Such function macros are
-# typically used for boiler-plate code, and will confuse the parser if not
+# remove all references to function-like macros that are alone on a line, have
+# an all uppercase name, and do not end with a semicolon. Such function macros
+# are typically used for boiler-plate code, and will confuse the parser if not
 # removed.
 # The default value is: YES.
 # This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
@@ -1969,7 +2038,7 @@ SKIP_FUNCTION_MACROS   = YES
 # where loc1 and loc2 can be relative or absolute paths or URLs. See the
 # section "Linking to external documentation" for more information about the use
 # of tag files.
-# Note: Each tag file must have an unique name (where the name does NOT include
+# Note: Each tag file must have a unique name (where the name does NOT include
 # the path). If a tag file is not located in the directory in which doxygen is
 # run, you must also specify the path to the tagfile here.
 
@@ -1981,20 +2050,21 @@ TAGFILES               =
 
 GENERATE_TAGFILE       =
 
-# If the ALLEXTERNALS tag is set to YES all external class will be listed in the
-# class index. If set to NO only the inherited external classes will be listed.
+# If the ALLEXTERNALS tag is set to YES, all external class will be listed in
+# the class index. If set to NO, only the inherited external classes will be
+# listed.
 # The default value is: NO.
 
 ALLEXTERNALS           = NO
 
-# If the EXTERNAL_GROUPS tag is set to YES all external groups will be listed in
-# the modules index. If set to NO, only the current project's groups will be
+# If the EXTERNAL_GROUPS tag is set to YES, all external groups will be listed
+# in the modules index. If set to NO, only the current project's groups will be
 # listed.
 # The default value is: YES.
 
 EXTERNAL_GROUPS        = YES
 
-# If the EXTERNAL_PAGES tag is set to YES all external pages will be listed in
+# If the EXTERNAL_PAGES tag is set to YES, all external pages will be listed in
 # the related pages index. If set to NO, only the current project's pages will
 # be listed.
 # The default value is: YES.
@@ -2011,7 +2081,7 @@ PERL_PATH              = /usr/bin/perl
 # Configuration options related to the dot tool
 #---------------------------------------------------------------------------
 
-# If the CLASS_DIAGRAMS tag is set to YES doxygen will generate a class diagram
+# If the CLASS_DIAGRAMS tag is set to YES, doxygen will generate a class diagram
 # (in HTML and LaTeX) for classes with base or super classes. Setting the tag to
 # NO turns the diagrams off. Note that this option also works with HAVE_DOT
 # disabled, but it is recommended to install and use dot, since it yields more
@@ -2036,7 +2106,7 @@ MSCGEN_PATH            =
 
 DIA_PATH               =
 
-# If set to YES, the inheritance and collaboration graphs will hide inheritance
+# If set to YES the inheritance and collaboration graphs will hide inheritance
 # and usage relations if the target is undocumented or is not a class.
 # The default value is: YES.
 
@@ -2061,7 +2131,7 @@ HAVE_DOT               = NO
 
 DOT_NUM_THREADS        = 0
 
-# When you want a differently looking font n the dot files that doxygen
+# When you want a differently looking font in the dot files that doxygen
 # generates you can specify the font name using DOT_FONTNAME. You need to make
 # sure dot is able to find the font, which can be done by putting it in a
 # standard location or by setting the DOTFONTPATH environment variable or by
@@ -2109,7 +2179,7 @@ COLLABORATION_GRAPH    = YES
 
 GROUP_GRAPHS           = YES
 
-# If the UML_LOOK tag is set to YES doxygen will generate inheritance and
+# If the UML_LOOK tag is set to YES, doxygen will generate inheritance and
 # collaboration diagrams in a style similar to the OMG's Unified Modeling
 # Language.
 # The default value is: NO.
@@ -2161,7 +2231,8 @@ INCLUDED_BY_GRAPH      = YES
 #
 # Note that enabling this option will significantly increase the time of a run.
 # So in most cases it will be better to enable call graphs for selected
-# functions only using the \callgraph command.
+# functions only using the \callgraph command. Disabling a call graph can be
+# accomplished by means of the command \hidecallgraph.
 # The default value is: NO.
 # This tag requires that the tag HAVE_DOT is set to YES.
 
@@ -2172,7 +2243,8 @@ CALL_GRAPH             = NO
 #
 # Note that enabling this option will significantly increase the time of a run.
 # So in most cases it will be better to enable caller graphs for selected
-# functions only using the \callergraph command.
+# functions only using the \callergraph command. Disabling a caller graph can be
+# accomplished by means of the command \hidecallergraph.
 # The default value is: NO.
 # This tag requires that the tag HAVE_DOT is set to YES.
 
@@ -2195,11 +2267,15 @@ GRAPHICAL_HIERARCHY    = YES
 DIRECTORY_GRAPH        = YES
 
 # The DOT_IMAGE_FORMAT tag can be used to set the image format of the images
-# generated by dot.
+# generated by dot. For an explanation of the image formats see the section
+# output formats in the documentation of the dot tool (Graphviz (see:
+# http://www.graphviz.org/)).
 # Note: If you choose svg you need to set HTML_FILE_EXTENSION to xhtml in order
 # to make the SVG files visible in IE 9+ (other browsers do not have this
 # requirement).
-# Possible values are: png, jpg, gif and svg.
+# Possible values are: png, jpg, gif, svg, png:gd, png:gd:gd, png:cairo,
+# png:cairo:gd, png:cairo:cairo, png:cairo:gdiplus, png:gdiplus and
+# png:gdiplus:gdiplus.
 # The default value is: png.
 # This tag requires that the tag HAVE_DOT is set to YES.
 
@@ -2242,6 +2318,19 @@ MSCFILE_DIRS           =
 
 DIAFILE_DIRS           =
 
+# When using plantuml, the PLANTUML_JAR_PATH tag should be used to specify the
+# path where java can find the plantuml.jar file. If left blank, it is assumed
+# PlantUML is not used or called during a preprocessing step. Doxygen will
+# generate a warning when it encounters a \startuml command in this case and
+# will not generate output for the diagram.
+
+PLANTUML_JAR_PATH      =
+
+# When using plantuml, the specified paths are searched for files specified by
+# the !include statement in a plantuml block.
+
+PLANTUML_INCLUDE_PATH  =
+
 # The DOT_GRAPH_MAX_NODES tag can be used to set the maximum number of nodes
 # that will be shown in the graph. If the number of nodes in a graph becomes
 # larger than this value, doxygen will truncate the graph, which is visualized
@@ -2278,7 +2367,7 @@ MAX_DOT_GRAPH_DEPTH    = 0
 
 DOT_TRANSPARENT        = NO
 
-# Set the DOT_MULTI_TARGETS tag to YES allow dot to generate multiple output
+# Set the DOT_MULTI_TARGETS tag to YES to allow dot to generate multiple output
 # files in one run (i.e. multiple -o and -T options on the command line). This
 # makes dot run faster, but since only newer versions of dot (>1.8.10) support
 # this, this feature is disabled by default.
@@ -2295,7 +2384,7 @@ DOT_MULTI_TARGETS      = NO
 
 GENERATE_LEGEND        = YES
 
-# If the DOT_CLEANUP tag is set to YES doxygen will remove the intermediate dot
+# If the DOT_CLEANUP tag is set to YES, doxygen will remove the intermediate dot
 # files that are used to generate the various graphs.
 # The default value is: YES.
 # This tag requires that the tag HAVE_DOT is set to YES.

LICENSE

@@ -1,12 +1,17 @@
+Copyright and License Terms
+---------------------------
 
-Copyright (c) 2008 Martin R. Kraimer
-Copyright (c) 2006 The University of Chicago, as Operator of Argonne
+Copyright (c) 2006-2016 Martin R. Kraimer
+Copyright (c) 2006-2016 UChicago Argonne LLC, as Operator of Argonne
      National Laboratory.
 Copyright (c) 2006 Deutsches Elektronen-Synchrotron,
      Member of the Helmholtz Association, (DESY), HAMBURG, GERMANY.
-Copyright (c) 2007 Control System Laboratory,
+Copyright (c) 2007-2016 Control System Laboratory,
     (COSYLAB) Ljubljana Slovenia
-
+Copyright (c) 2010-2016 Brookhaven Science Associates, as Operator
+    of Brookhaven National Laboratory
+Copyright (c) 2011-2016 Diamond Light Source Limited,
+    (DLS) Didcot, United Kingdom
 
 Permission is hereby granted, free of charge, to any person
 obtaining a copy of this software and associated documentation
@@ -31,48 +36,30 @@ OTHER DEALINGS IN THE SOFTWARE.
 
 ________________________________________________________________________
 
-This software is in part copyrighted by the University of Chicago (UofC)
+Additional Disclaimers
+----------------------
 
-In no event shall UofC be liable to any party for direct, indirect,
-special, incidental, or consequential damages arising out of the use of
-this software, its documentation, or any derivatives thereof, even if
-UofC has been advised of the possibility of such damage.
+This software is copyright in part by these institutions:
 
-UofC specifically disclaims any warranties, including, but not limited
-to, the implied warranties of merchantability, fitness for a particular
-purpose, and non-infringement.  This software is provided on an "as is"
-basis, and UofC has no obligation to provide maintenance, support,
-updates, enhancements, or modifications.
+  * Brookhaven Science Associates, as Operator of Brookhaven
+    National Laboratory, New York, USA
+  * Control System Laboratory, Ljubljana, Slovenia
+  * Deutsches Elektronen-Synchroton, Member of the Helmholtz
+    Association, Hamburg, Germany
+  * Diamond Light Source Limited, Didcot, United Kingdom
+  * Helmholtz-Zentrum Berlin fuer Materialien und Energie m.b.H.,
+    Berlin, Germany.
+  * UChicage Argonne LLC, as Operator of Argonne National Laboratory,
+    Illinois, USA
 
-________________________________________________________________________
+In no event shall these institutions be liable to any party for direct,
+indirect, special, incidental, or consequential damages arising out of
+the use of this software, its documentation, or any derivatives thereof,
+even if advised of the possibility of such damage.
 
-This software is in part copyrighted by the BERLINER SPEICHERRING
-GESELLSCHAFT FUER SYNCHROTRONSTRAHLUNG M.B.H. (BESSY), BERLIN, GERMANY.
+These institutions specifically disclaim any warranties, including, but
+not limited to, the implied warranties of merchantability, fitness for a
+particular purpose, and non-infringement. This software is provided on
+an "as is" basis, and these institutions have no obligation to provide
+maintenance, support, updates, enhancements, or modifications.
 
-In no event shall BESSY be liable to any party for direct, indirect,
-special, incidental, or consequential damages arising out of the use of
-this software, its documentation, or any derivatives thereof, even if
-BESSY has been advised of the possibility of such damage.
-
-BESSY specifically disclaims any warranties, including, but not limited
-to, the implied warranties of merchantability, fitness for a particular
-purpose, and non-infringement.  This software is provided on an "as is"
-basis, and BESSY has no obligation to provide maintenance, support,
-updates, enhancements, or modifications.
-
-________________________________________________________________________
-
-This software is in part copyrighted by the Deutsches Elektronen-Synchroton,
-    Member of the Helmholtz Association, (DESY), HAMBURG, GERMANY.
-
-In no event shall DESY be liable to any party for direct, indirect,
-special, incidental, or consequential damages arising out of the use of
-this software, its documentation, or any derivatives thereof, even if
-DESY has been advised of the possibility of such damage.
-
-DESY specifically disclaims any warranties, including, but not limited
-to, the implied warranties of merchantability, fitness for a particular
-purpose, and non-infringement.  This software is provided on an "as is"
-basis, and DESY has no obligation to provide maintenance, support,
-updates, enhancements, or modifications.
-________________________________________________________________________

LICENSE.txt

@@ -1,78 +0,0 @@
-
-Copyright (c) 2008 Martin R. Kraimer
-Copyright (c) 2006 The University of Chicago, as Operator of Argonne
-     National Laboratory.
-Copyright (c) 2006 Deutsches Elektronen-Synchrotron,
-     Member of the Helmholtz Association, (DESY), HAMBURG, GERMANY.
-Copyright (c) 2007 Control System Laboratory,
-    (COSYLAB) Ljubljana Slovenia
-
-
-Permission is hereby granted, free of charge, to any person
-obtaining a copy of this software and associated documentation
-files (the "Software"), to deal in the Software without
-restriction, including without limitation the rights to use,
-copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the
-Software is furnished to do so, subject to the following
-conditions:
-
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
-OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
-HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
-WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
-FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
-OTHER DEALINGS IN THE SOFTWARE.
-
-________________________________________________________________________
-
-This software is in part copyrighted by the University of Chicago (UofC)
-
-In no event shall UofC be liable to any party for direct, indirect,
-special, incidental, or consequential damages arising out of the use of
-this software, its documentation, or any derivatives thereof, even if
-UofC has been advised of the possibility of such damage.
-
-UofC specifically disclaims any warranties, including, but not limited
-to, the implied warranties of merchantability, fitness for a particular
-purpose, and non-infringement.  This software is provided on an "as is"
-basis, and UofC has no obligation to provide maintenance, support,
-updates, enhancements, or modifications.
-
-________________________________________________________________________
-
-This software is in part copyrighted by the BERLINER SPEICHERRING
-GESELLSCHAFT FUER SYNCHROTRONSTRAHLUNG M.B.H. (BESSY), BERLIN, GERMANY.
-
-In no event shall BESSY be liable to any party for direct, indirect,
-special, incidental, or consequential damages arising out of the use of
-this software, its documentation, or any derivatives thereof, even if
-BESSY has been advised of the possibility of such damage.
-
-BESSY specifically disclaims any warranties, including, but not limited
-to, the implied warranties of merchantability, fitness for a particular
-purpose, and non-infringement.  This software is provided on an "as is"
-basis, and BESSY has no obligation to provide maintenance, support,
-updates, enhancements, or modifications.
-
-________________________________________________________________________
-
-This software is in part copyrighted by the Deutsches Elektronen-Synchroton,
-    Member of the Helmholtz Association, (DESY), HAMBURG, GERMANY.
-
-In no event shall DESY be liable to any party for direct, indirect,
-special, incidental, or consequential damages arising out of the use of
-this software, its documentation, or any derivatives thereof, even if
-DESY has been advised of the possibility of such damage.
-
-DESY specifically disclaims any warranties, including, but not limited
-to, the implied warranties of merchantability, fitness for a particular
-purpose, and non-infringement.  This software is provided on an "as is"
-basis, and DESY has no obligation to provide maintenance, support,
-updates, enhancements, or modifications.
-________________________________________________________________________

Makefile

@@ -1,20 +1,10 @@
 #Makefile at top of application tree
 TOP = .
 include $(TOP)/configure/CONFIG
-DIRS := $(DIRS) $(filter-out $(DIRS), configure)
-DIRS := $(DIRS) $(filter-out $(DIRS), src)
-DIRS := $(DIRS) $(filter-out $(DIRS), example)
+DIRS += configure
 
-EMBEDDED_TOPS := $(EMBEDDED_TOPS) $(filter-out $(EMBEDDED_TOPS), example)
-
-define DIR_template
- $(1)_DEPEND_DIRS = configure
-endef
-$(foreach dir, $(filter-out configure,$(DIRS)),$(eval $(call DIR_template,$(dir))))
-
-define EMB_template
- $(1)_DEPEND_DIRS = src
-endef
-$(foreach dir, $(EMBEDDED_TOPS),$(eval $(call EMB_template,$(dir))))
+DIRS += src
+src_DEPEND_DIRS = configure
 
 include $(TOP)/configure/RULES_TOP
+

README.md

@@ -15,23 +15,22 @@ then just type:
 
     make
 
-If RELEASE.local does not exist then look at <b>configure/RELEASE</b>
-for directions for how to build.
+It can also be built by:
+
+    cp configure/ExampleRELEASE.local configure/RELEASE.local
+    edit configure/RELEASE.local
+    make
+
 
 Examples
 ------------
 
-The examples require the database in pvaClientTestCPP.
-For example:
-
-    mrk> pwd
-    /home/epicsv4/pvaClientTestCPP/database/iocBoot/exampleDatabase
-    mrk> ../../bin/linux-x86_64/exampleDatabase st.cmd 
+Project exampleCPP has examples for pvaClientCPP
 
 Status
 ------
 
-* The API is for release 4.5.0-pre1
+* The API is for EPICS Version 4 release 4.6.0
 * Everything defined in pvaClient.h is ready but see below for remaining work.
 * Everything defined in pvaClientMultiChannel.h is ready but see below for remaining work.
 
@@ -39,7 +38,7 @@ Status
 pvaClientChannel
 ---------------
 
-Channel::getField and channelArray are not supported for release 4.5
+Channel::getField and channelArray are not supported for release 4.6
 
 pvaClientMultiChannel
 ---------------
@@ -47,5 +46,4 @@ pvaClientMultiChannel
 For release 4.5 support is available for multiDouble and NTMultiChannel.
 In the future additional support should be provided that at least includes NTScalarMultiChannel.
 
-Testing with some channels not connected have not been done.
-At least some testing with missing channels should be done before final release 4.5
+Testing with some channels not connected has not been done.

configure/CONFIG_SITE

@@ -20,8 +20,5 @@
 #   INSTALL_LOCATION here.
 #INSTALL_LOCATION=</path/name/to/install/top>
 
-INSTALL_INCLUDE = $(INSTALL_LOCATION)/include/pv
-USR_INCLUDES += -I $(INSTALL_LOCATION)/include
-
 -include $(TOP)/../CONFIG_SITE.local
 -include $(TOP)/configure/CONFIG_SITE.local

configure/ExampleRELEASE.local

@@ -1,9 +1,8 @@
+EPICS4_DIR=/home/epicsv4/master
+PVACCESS=${EPICS4_DIR}/pvAccessCPP
+NORMATIVETYPES=${EPICS4_DIR}/normativeTypesCPP
+PVDATA=${EPICS4_DIR}/pvDataCPP
+PVCOMMON=${EPICS4_DIR}/pvCommonCPP
 
 TEMPLATE_TOP=$(EPICS_BASE)/templates/makeBaseApp/top
-
 EPICS_BASE=/home/install/epics/base
-V4BASE=/home/epicsv4
-PVCOMMON=${V4BASE}/pvCommonCPP
-PVDATA=${V4BASE}/pvDataCPP
-NORMATIVETYPES=${V4BASE}/normativeTypesCPP
-PVACCESS=${V4BASE}/pvAccessCPP

documentation/RELEASE_NOTES.md

@@ -0,0 +1,19 @@
+EPICS V4 release 4.6
+==========================
+
+* The examples are moved to exampleCPP.
+* Support for channelRPC is now available.
+* In PvaClientMultiChannel checkConnected() now throws an exception if connect fails.
+
+
+
+EPICS V4 release 4.5
+==========================
+
+
+pvaClient is a synchronous API for pvAccess.
+
+
+This is the first release of pvaClientCPP.
+It provides an API that is similar to pvaClientJava.
+

documentation/pvaClientCPP.html

@@ -26,25 +26,7 @@
 
 <div class="head">
 <h1>EPICS pvaClientCPP</h1>
-<!-- Maturity: Working Draft or Request for Comments, or Recommendation, and date.  -->
-<h2 class="nocount">EPICS V4 Working Group, Working Draft,
-03-August-2015</h2>
-<dl>
-  <dt>This version:</dt>
-    <dd><a
-      href="pvaClientCPP.html">pvaClientCPP.html
-    </a> </dd>
-  <dt>Latest version:</dt>
-    <dd><a
-      href="pvaClientCPP_20150803.html">pvaClientCPP_20150803.html
-    </a> </dd>
-  <dt>Previous version:</dt>
-    <dd><a
-      href="pvaClientCPP_20150626.html">pvaClientCPP_20150626.html
-    </a> </dd>
-  <dt>Editors:</dt>
-    <dd>Marty Kraimer, BNL</dd>
-</dl>
+<h2 class="nocount">Release 4.2.1 - 2016-08-26</h2>
 
 <h2 class="nocount">Abstract</h2>
 
@@ -78,11 +60,6 @@ The data for the channels is presented via normative type NTMultiChannel.
       Control System</a>.</p>
 
 
-
-<h2 class="nocount">Status of this Document and of the pvaClient Software</h2>
-
-<p>pvaClientCPP is ready for use.</p>
-
 </div> <!-- head -->
 
 <div id="toc">
@@ -92,91 +69,51 @@ The data for the channels is presented via normative type NTMultiChannel.
 <!-- Place what you would like in the Table of Contents, inside the contents div -->
 <div id="contents" class="contents">	  
 <hr />
-
-<h2>Introduction</h2>
-
-<p>pvaClient is a synchronous API for accessing PVData via PVAccess. It provides
-an interface to many of the features provided by pvData and pvAccess.</p>
-
-<p>This document describes the layout of the source files in this project.</p>
+<h2>Overview</h2>
 <p>
-A user overview is available via
-<a
-href="./pvaClientOverview.html">pvaClientOverview.html
+pvaClientCPP is one of the components of 
+<a href="http://epics-pvdata.sourceforge.net">
+EPICS Version 4
 </a>
 </p>
+<p>This document is only a guide to help locate code and documentation related to pvDatabaseCPP
+</p>
 <p>
-Doxygen documentation is available at
+It is intended for developers that want to use pvDatabaseCPP.
+</p>
+<h2>Developer Guide</h2>
+<p>A guide for developers is available at
 <a
-href="./html/index.html">doxygenDoc
+href="http://epics-pvdata.sourceforge.net/informative/developerGuide/developerGuide.html">
+developerGuide
 </a>
 </p>
-<h2>Example Database</h2>
-<p>The examples require that the database provided by project pvaClientTestCPP
-is running.
-For example:</p>
-<pre>
-mrk&gt; pwd
-/home/epicsv4/pvaClientTestCPP/database/iocBoot/exampleDatabase
-mrk&gt; ../../bin/linux-x86_64/exampleDatabase st.cmd 
-</pre>
-<h2>Examples</h2>
-<p>Examples are in directory <b>example/src</b>.
-An example of how to run them is:</p>
-<pre>
-mrk&gt; pwd
-/home/epicsv4/pvaClientCPP/example
-mrk&gt; bin/linux-x86_64/examplePvaClientGet 
-</pre>
-<p>The following is a brief description of each example.
-In order to understand each example it
-helps to also look at the source for the example.</p>
-<h2>examplePvaClientGet</h2>
-<p>This has a number of examples:</p>
-<dl>
-   <dt>exampleDouble</dt>
-      <dd>
-         This shows two methods for getting data from a channel that has a numeric
-         scalar value field.
-     </dd>
-   <dt>exampleDoubleArray</dt>
-      <dd>
-         This shows two methods for getting data from a channel that has a
-         double array value field.
-     </dd>
-   <dt>exampleCADouble</dt>
-      <dd>
-         This is like exampleDouble except it uses provider <b>ca</b>.
-     </dd>
-   <dt>exampleCADoubleArray</dt>
-      <dd>
-         This is like exampleDoubleArray except it uses provider <b>ca</b>.
-     </dd>
-   <dt>examplePowerSupply</dt>
-      <dd>
-       This is an example of getting data from a channel that does not
-        have a value field.
-     </dd>
-</dl>
-<h2>examplePvaClientMonitor</h2>
-<p>This is an example of creating a monitor on a channel.
-It monitors a scalar double field.
-It also issues puts to the same channel so that it can make the monitors occur.
+<p>This guide discusses all the components that are part of an <b>EPICS V4</b> release.
+Some understanding of the components and how they are related is necessary in order to
+develop code that uses pvDatabaseCPP.
+In particular read everything related to pvaClient.
 </p>
-<h2>examplePvaClientPut</h2>
-<p>This example gets and puts to channels exampleDouble
-and exampleDoubleArray.</p>
-<h2>examplePvaClientProcess</h2>
-<p>This example makes a process request to channel exampleDouble.</p>
-<h2>helloWorldPutGet</h2>
-<p>This is an example of issuing a channelPutGet.</p>
-<h2>examplePvaClientMultiDouble</h2>
-<p>This is an example of using pvaClientMultiChannel,
-pvaClientMultiGetDouble, pvaClientMultiPutDouble, and pvaClientMultiMonitorDouble.
+<p>The developerGuide discusses code in a way that applies to both CPP and C++.
+For the descriptions of the CPP specific code consult the next section.
 </p>
-<h2>helloWorldRPC</h2>
-<p>This is an example of issuing a channelRPC request.
-It does <b>not</b> use pva.</p>
+
+<h2>doxygen</h2>
+<p>doxygen documentation is available at
+<a
+href="./html/index.html">doxygen</a>
+</p>
+
+<h2>exampleCPP</h2>
+<p>Example code is available as part of this release.
+<a
+href="http://epics-pvdata.sourceforge.net/docbuild/exampleCPP/tip/documentation/exampleCPP.html">
+exampleCPP
+</a>
+</p>
+<p>In particular look at exampleClient.
+It has many examples of using pvaClientCPP.
+</p>
+
 </div> <!-- class="contents" -->
 </body>
 </html>

documentation/pvaClientCPP_20150626.html

@@ -1,199 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-      "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-<head>
-  <meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
-  <title>EPICS pva</title>
-  <link rel="stylesheet" type="text/css"
-  href="http://epics-pvdata.sourceforge.net/base.css" />
-  <link rel="stylesheet" type="text/css"
-  href="http://epics-pvdata.sourceforge.net/epicsv4.css" />
-  <style type="text/css">
-/*<![CDATA[*/
-     .about { margin-left: 3em; margin-right: 3em; font-size: .83em}
-     table { margin-left: auto; margin-right: auto }
-     .diagram { text-align: center; margin: 2.5em 0 }
-     body { margin-right: 10% }
-/*]]>*/</style>
-
- <!-- Script that generates the Table of Contents -->
-  <script type="text/javascript" src="http://epics-pvdata.sourceforge.net/script/tocgen.js"></script>
-
-</head>
-
-<body>
-
-<div class="head">
-<h1>EPICS pvaClientCPP</h1>
-<!-- Maturity: Working Draft or Request for Comments, or Recommendation, and date.  -->
-<h2 class="nocount">EPICS V4 Working Group, Working Draft,
-26-June-2015</h2>
-<dl>
-  <dt>This version:</dt>
-    <dd><a
-      href="pvaClientCPP.html">pvaClientCPP.html
-    </a> </dd>
-  <dt>Latest version:</dt>
-    <dd><a
-      href="pvaClientCPP_20150626.html">pvaClientCPP_20150626.html
-    </a> </dd>
-  <dt>Previous version:</dt>
-    <dd><a
-      href="easyPVA_20150609.html">easyPVA_20150609.html</a>
-    </dd>
-  <dt>Editors:</dt>
-    <dd>Marty Kraimer, BNL</dd>
-</dl>
-
-<h2 class="nocount">Abstract</h2>
-
-<p>pvaClient is a software library that provides to an EPICS client programmer, a friendly
-client side programming interface to the data of an EPICS based control system. It is intended 
-for such uses as rapid development of ad hoc programs by controls engineers, or to provide 
-scientists a way to directly develop analytical applications.</p>
-
-<p>Specifically, pvaClient provides a synchronous interface for pvAccess, which is the
-software support for high speed controls network communications used in EPICS version 4.
-pvAccess provides a callback based interface, which can be hard to use.
-pvaClient provides an interface that does not require callbacks even for monitors.
-</p>
-pvaClientChannel provides many "convenience" methods to directly get and put 
-scalar and scalarArray data types.
-Additional methods provide access to the full features of pvAccess.
-</p>
-<p>
-pvaClientMultiChannel provides access to data from multiple channels.
-It can be used directly by a client or via pvaClientMultiDouble or pvaClientNTMultiChannel.
-pvaClientMultiDouble allows the client to get and put data to multiple channels.
-But each channel must have a value field that is a numeric scalar.
-pvaClientNTMultiChannel allows the client to get and put data to multiple channels.
-Each channel must have a value field.
-The data for the channels is presented via normative type NTMultiChannel.
-</p>
-  <!-- last para of Abstract is boilerplate reference to EPICS -->
-      <p>For more information about EPICS generally, please refer to the home page of the <a
-       href="http://www.aps.anl.gov/epics/">Experimental Physics and Industrial
-      Control System</a>.</p>
-
-
-
-<h2 class="nocount">Status of this Document and of the pvaClient Software</h2>
-
-<p>pvaClientCPP is ready for use.</p>
-
-</div> <!-- head -->
-
-<div id="toc">
-  <h2 class="nocount">Table of Contents</h2>
-</div>
-
-<!-- Place what you would like in the Table of Contents, inside the contents div -->
-<div id="contents" class="contents">	  
-<hr />
-
-<h2>Introduction</h2>
-
-<p>pvaClient is a synchronous API for accessing PVData via PVAccess. It provides
-an interface to many of the features provided by pvData and pvAccess.</p>
-
-<p>This document describes the layout of the source files in this project.</p>
-<p>
-A user overview is available via
-<a
-href="./pvaClientOverview.html">pvaClientOverview.html
-</a>
-</p>
-<p>
-Doxygen documentation is available at
-<a
-href="./html/index.html">doxygenDoc
-</a>
-</p>
-<h2>Example Database</h2>
-<p>The examples require that an example pvAccess server is runnimg.
-To get the test database go to:</p>
-<a
-href="https://github.com/epics_base/pvaClientTestCPP/blob/master/database.zip">pvaClientTestCPP/database.zip
-</a>
-Then select "raw file" and You will be able to download the zip file.
-<p>
-When unzipped this is used to create an example IOC database.
-</p>
-<p>
-After unzipping the file:
-</p>
-<pre>
-cd database/configure
-cp ExampleRELEASE.local RELEASE.local
-edit RELEASE.local
-cd ..
-make
-cd iocBoot/exampleDatabase
-../../bin/&lt;arch:&gt;/exampleDatabase st.cmd
-</pre>
-<h2>Examples</h2>
-<p>Examples are in directory <b>example/src</b>.
-An example of how to run them is:</p>
-<pre>
-mrk&gt; pwd
-/home/epicsv4/pvaClientCPP/example
-mrk&gt; bin/linux-x86_64/examplePvaClientGet 
-</pre>
-<p>The following is a brief description of each example.
-In order to understand each example it
-helps to also look at the source for the example.</p>
-<h2>examplePvaClientGet</h2>
-<p>This has a number of examples:</p>
-<dl>
-   <dt>exampleDouble</dt>
-      <dd>
-         This shows two methods for getting data from a channel that has a numeric
-         scalar value field.
-     </dd>
-   <dt>exampleDoubleArray</dt>
-      <dd>
-         This shows two methods for getting data from a channel that has a
-         double array value field.
-     </dd>
-   <dt>exampleCADouble</dt>
-      <dd>
-         This is like exampleDouble except it uses provider <b>ca</b>.
-     </dd>
-   <dt>exampleCADoubleArray</dt>
-      <dd>
-         This is like exampleDoubleArray except it uses provider <b>ca</b>.
-     </dd>
-   <dt>examplePowerSupply</dt>
-      <dd>
-       This is an example of getting data from a channel that does not
-        have a value field.
-     </dd>
-</dl>
-<h2>examplePvaClientMonitor</h2>
-<p>This is an example of creating a monitor on a channel.
-It monitors a channel that models a powerSupply, i. e. it is not a "standard" record.
-It does not have a value field.
-</p>
-<p>After starting the example a change can be made to the powerSupply by issuing:</p>
-<pre>
-pvput -r "power.value,voltage.value" examplePowerSupply 6 6
-</pre>
-<h2>examplePvaClientPut</h2>
-<p>This example gets and puts to channel exampleDouble.</p>
-<h2>examplePvaClientProcess</h2>
-<p>This example makes a process request to channel exampleDouble.</p>
-<h2>helloWorldPutGet</h2>
-<p>This is an example of issuing a channelPutGet.</p>
-<h2>examplePvaClientMultiDouble</h2>
-<p>This is an example of issuing gets and puts to multiple channels where each
-channel has a numeric scalar value field.</p>
-<h2>examplePvaClientNTMultiChannel</h2>
-<p>This is an example of using NDMultiChannel to obtain data from multiple channels.
-</p>
-<h2>helloWorldRPC</h2>
-<p>This is an example of issuing a channelRPC request.
-It does <b>not</b> use pva.</p>
-</div> <!-- class="contents" -->
-</body>
-</html>

documentation/pvaClientCPP_20150803.html

@@ -1,182 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-      "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-<head>
-  <meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
-  <title>EPICS pva</title>
-  <link rel="stylesheet" type="text/css"
-  href="http://epics-pvdata.sourceforge.net/base.css" />
-  <link rel="stylesheet" type="text/css"
-  href="http://epics-pvdata.sourceforge.net/epicsv4.css" />
-  <style type="text/css">
-/*<![CDATA[*/
-     .about { margin-left: 3em; margin-right: 3em; font-size: .83em}
-     table { margin-left: auto; margin-right: auto }
-     .diagram { text-align: center; margin: 2.5em 0 }
-     body { margin-right: 10% }
-/*]]>*/</style>
-
- <!-- Script that generates the Table of Contents -->
-  <script type="text/javascript" src="http://epics-pvdata.sourceforge.net/script/tocgen.js"></script>
-
-</head>
-
-<body>
-
-<div class="head">
-<h1>EPICS pvaClientCPP</h1>
-<!-- Maturity: Working Draft or Request for Comments, or Recommendation, and date.  -->
-<h2 class="nocount">EPICS V4 Working Group, Working Draft,
-03-August-2015</h2>
-<dl>
-  <dt>This version:</dt>
-    <dd><a
-      href="pvaClientCPP.html">pvaClientCPP.html
-    </a> </dd>
-  <dt>Latest version:</dt>
-    <dd><a
-      href="pvaClientCPP_20150803.html">pvaClientCPP_20150803.html
-    </a> </dd>
-  <dt>Previous version:</dt>
-    <dd><a
-      href="pvaClientCPP_20150626.html">pvaClientCPP_20150626.html
-    </a> </dd>
-  <dt>Editors:</dt>
-    <dd>Marty Kraimer, BNL</dd>
-</dl>
-
-<h2 class="nocount">Abstract</h2>
-
-<p>pvaClient is a software library that provides to an EPICS client programmer, a friendly
-client side programming interface to the data of an EPICS based control system. It is intended 
-for such uses as rapid development of ad hoc programs by controls engineers, or to provide 
-scientists a way to directly develop analytical applications.</p>
-
-<p>Specifically, pvaClient provides a synchronous interface for pvAccess, which is the
-software support for high speed controls network communications used in EPICS version 4.
-pvAccess provides a callback based interface, which can be hard to use.
-pvaClient provides an interface that does not require callbacks even for monitors.
-</p>
-<p>
-pvaClientChannel provides many "convenience" methods to directly get and put 
-scalar and scalarArray data types.
-Additional methods provide access to the full features of pvAccess.
-</p>
-<p>
-pvaClientMultiChannel provides access to data from multiple channels.
-It can be used directly by a client or via pvaClientMultiDouble or pvaClientNTMultiChannel.
-pvaClientMultiDouble allows the client to get and put data to multiple channels.
-But each channel must have a value field that is a numeric scalar.
-pvaClientNTMultiChannel allows the client to get and put data to multiple channels.
-Each channel must have a value field.
-The data for the channels is presented via normative type NTMultiChannel.
-</p>
-  <!-- last para of Abstract is boilerplate reference to EPICS -->
-      <p>For more information about EPICS generally, please refer to the home page of the <a
-       href="http://www.aps.anl.gov/epics/">Experimental Physics and Industrial
-      Control System</a>.</p>
-
-
-
-<h2 class="nocount">Status of this Document and of the pvaClient Software</h2>
-
-<p>pvaClientCPP is ready for use.</p>
-
-</div> <!-- head -->
-
-<div id="toc">
-  <h2 class="nocount">Table of Contents</h2>
-</div>
-
-<!-- Place what you would like in the Table of Contents, inside the contents div -->
-<div id="contents" class="contents">	  
-<hr />
-
-<h2>Introduction</h2>
-
-<p>pvaClient is a synchronous API for accessing PVData via PVAccess. It provides
-an interface to many of the features provided by pvData and pvAccess.</p>
-
-<p>This document describes the layout of the source files in this project.</p>
-<p>
-A user overview is available via
-<a
-href="./pvaClientOverview.html">pvaClientOverview.html
-</a>
-</p>
-<p>
-Doxygen documentation is available at
-<a
-href="./html/index.html">doxygenDoc
-</a>
-</p>
-<h2>Example Database</h2>
-<p>The examples require that the database provided by project pvaClientTestCPP
-is running.
-For example:</p>
-<pre>
-mrk&gt; pwd
-/home/epicsv4/pvaClientTestCPP/database/iocBoot/exampleDatabase
-mrk&gt; ../../bin/linux-x86_64/exampleDatabase st.cmd 
-</pre>
-<h2>Examples</h2>
-<p>Examples are in directory <b>example/src</b>.
-An example of how to run them is:</p>
-<pre>
-mrk&gt; pwd
-/home/epicsv4/pvaClientCPP/example
-mrk&gt; bin/linux-x86_64/examplePvaClientGet 
-</pre>
-<p>The following is a brief description of each example.
-In order to understand each example it
-helps to also look at the source for the example.</p>
-<h2>examplePvaClientGet</h2>
-<p>This has a number of examples:</p>
-<dl>
-   <dt>exampleDouble</dt>
-      <dd>
-         This shows two methods for getting data from a channel that has a numeric
-         scalar value field.
-     </dd>
-   <dt>exampleDoubleArray</dt>
-      <dd>
-         This shows two methods for getting data from a channel that has a
-         double array value field.
-     </dd>
-   <dt>exampleCADouble</dt>
-      <dd>
-         This is like exampleDouble except it uses provider <b>ca</b>.
-     </dd>
-   <dt>exampleCADoubleArray</dt>
-      <dd>
-         This is like exampleDoubleArray except it uses provider <b>ca</b>.
-     </dd>
-   <dt>examplePowerSupply</dt>
-      <dd>
-       This is an example of getting data from a channel that does not
-        have a value field.
-     </dd>
-</dl>
-<h2>examplePvaClientMonitor</h2>
-<p>This is an example of creating a monitor on a channel.
-It monitors a scalar double field.
-It also issues puts to the same channel so that it can make the monitors occur.
-</p>
-<h2>examplePvaClientPut</h2>
-<p>This example gets and puts to channels exampleDouble
-and exampleDoubleArray.</p>
-<h2>examplePvaClientProcess</h2>
-<p>This example makes a process request to channel exampleDouble.</p>
-<h2>helloWorldPutGet</h2>
-<p>This is an example of issuing a channelPutGet.</p>
-<h2>examplePvaClientMultiDouble</h2>
-<p>This is an example of using pvaClientMultiChannel,
-pvaClientMultiGetDouble, pvaClientMultiPutDouble, and pvaClientMultiMonitorDouble.
-</p>
-<h2>helloWorldRPC</h2>
-<p>This is an example of issuing a channelRPC request.
-It does <b>not</b> use pva.</p>
-</div> <!-- class="contents" -->
-</body>
-</html>

documentation/pvaClientOverview.html

@@ -1,313 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-      "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-<head>
-  <meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
-  <title>pva C++ Overview</title>
-  <link rel="stylesheet" type="text/css"
-  href="http://epics-pvdata.sourceforge.net/base.css" />
-  <link rel="stylesheet" type="text/css"
-  href="http://epics-pvdata.sourceforge.net/epicsv4.css" />
-  <style type="text/css">
-/*<![CDATA[*/
-     .about { margin-left: 3em; margin-right: 3em; font-size: .83em}
-     table { margin-left: auto; margin-right: auto }
-     .diagram { text-align: center; margin: 2.5em 0 }
-     body { margin-right: 10% }
-/*]]>*/</style>
-
- <!-- Script that generates the Table of Contents -->
-  <script type="text/javascript" src="http://epics-pvdata.sourceforge.net/script/tocgen.js"></script>
-
-</head>
-
-<body>
-
-<div class="head">
-<h1>PvaClient C++ Overview</h1>
-
-</div> <!-- head -->
-
-<div id="toc">
-  <h2 class="nocount">Table of Contents</h2>
-</div>
-
-<!-- Place what you would like in the Table of Contents, inside the contents div -->
-<div id="contents" class="contents">	  
-<hr />
-
-<h2>Introduction</h2>
-
-<p>PvaClient is a synchronous API for accessing PVData via PVAccess.
-It also provides a number of convenience methods.
-It allows the client to request access without checking for failure,
-but throws an exception if a request fails.
-A client can also check for failues and thus prevent exceptions.</p>
-
-<p>The PvaClient API has the following features:</p>
-<ol>
-  <li>Provides a synchronous API rather than the callback API provided by pvAccess.</li>
-  <li>Makes common requests pva.</li>
-  <li>Provides full access to the pvAccess API for more demanding
-  applications</li>
-  <li>Allows efficient client side programs.</li>
-  <li>Takes care of most object resource management problems.</li>
-</ol>
-<p>Simple examples of using pva:</p>
-<pre>
-// pvaGet
-PvaClientPtr pva = PvaClient::create();
-double value = pva-&gt;channel("exampleDouble")-&gt;get()-&gt;getData()-&gt;getDouble();
-
-// pvaPut
-PvaClientChannelPtr channel = pva-&gt;channel("exampleDouble");
-PvaClientPutPtr put = channel-&gt;put();
-PvaClientPutDataPtr putData = put-&gt;getData();
-putData-&gt;putDouble(3.0); put-&gt;put();
-
-// pvaMonitor
-PvaClientMonitorPtr monitor = pva-&gt;channel("examplePowerSupply")-&gt;monitor("");
-PvaClientMonitorDataPtr pvaData = monitor-&gt;getData();
-while(true) {
-    monitor-&gt;waitEvent();
-    cout &lt;&lt; "changed\n";
-    pvaData-&gt;showChanged(cout);
-    cout &lt;&lt; "overrun\n";
-    pvaData-&gt;showOverrun(cout);
-    monitor-&gt;releaseEvent();
-}
-
-// pvaProcess
-PvaClientChannelPtr channel = pva-&gt;channel("exampleDouble");
-PvaClientProcessPtr process = channel-&gt;createProcess();
-process-&gt;process();
-
-</pre>
-<p><b>pvClientCPP/example</b> includes a number of examples.</p>
-<p>pvaClient does <b>not</b> provide support for:</p>
-<dl>
-   <dt>ChannelArray</dt>
-     <dd>TBD</dd>
-   <dt>ChannelRPC</dt>
-     <dd>pvAccess itself already provides a synchronous interface.
-       The examples include helloWorldRPC, which is an example of using channelRP.
-     </dd>
-</dl>
-
-<h2>PvaClient</h2>
-<p>An instance of PvaClient is obtained via the call:</p>
-<pre>
-PvaClientPtr pva = PvaClient::create();
-</pre>
-
-<p>PvaClient has methods to create instances of <b>PvaClientChannel</b>.
-The client can specify the provider name or use the default provider.
-The client can manage it's own channels or can let pvaClient cache channels.
-An example of using the cached method is:</p>
-<pre>
-PvaClientChannelPtr pvaChannel = pva-&gt;channel("exampleDouble");
-</pre>
-<p>This will attempt to connect to channel exampleDouble.
-Since the client did not specify a timeout an exception wll be thrown if
-the connection request fails.
-The client will block until the connection is made or an exception is thrown.
-If the request succeeds, pva caches the pvaChannel so that if the
-client makes another request for the same channel the cached object is
-returned to the client.
-</p>
-<p>An example of using a non cached method is:</p>
-<pre>
-PvaClientChannelPtr pvaChannel = pva-&gt;createChannel("exampleDouble");
-</pre>
-<p>This will create an PvaClientChannel and return it to the client.
-The client must itself connect.
-This is useful if the client wants to connect to multiple channels in parallel.
-</p>
-
-<h2>PvaClientChannel - Wrapper For Single Channel</h2>
-<h3>PvaClientChannel</h3>
-<p>This provides methods for connecting to a channel and for creating instances of
-PvaClientField, PvaClientProcess, ..., PvaClientPutGet.</p>
-<p>Connection must be made before any create  method is called or
-an exception is raised.
-The following is a synchronous connection request:</p>
-<pre>
-pvaChannel-&gt;connect(5.0); // BLOCKS AND THROWS IF NO CONNECT
-</pre>
-<p>This blocks until then connection is made or until timout occurs.
-An exception is raised if the connection request fails.
-</p>
-<p>The same request can be made without blocking and without exceptions.</p>
-<pre>
-pvaChannel-&gt;issueConnect(); // DOES NOT BLOCK
-.....
-Status status =pvaChannel-&gt;waitConnect(5.0);  // BLOCKS DOES NOT THROW
-if(!status.isOK()) {
-   // failure do something
-}
-</pre>
-<p>Once the channel is connected other PvaClient objects can be created.
-For example:</p>
-<pre>
-PvaClientGetPtr pvaGet = pvaChannel-&gt;get(); // DOES BLOCK
-</pre>
-<p>This is a caching request.
-If the client already has made an identical request the client will receive the
-cached object.
-If a new pvaGet is created than it is connected before it is returned to the client.
-</p>
-<p>The client can also managed it's own objects:</p>
-<pre>
-PvaClientGetPtr pvaGet = pvaChannel-&gt;createGet(); // DOES NOT BLOCK
-</pre>
-<p>The client must connect the pvaGet.</p>
-
-<h3>PvaClientGetData</h3>
-<p>This provides the data returned by pvaGet and pvaPutGet.
-It is obtained via:</p>
-<pre>
-PvaClientGetDataPtr pvaData = pvaGet-&gt;getData();
-</pre>
-<p>It provides methods to get everything returned by channelGet.
-In addition there are methods that make it easier to handle a value
-field that is a scalar or a scalarArray.
-Also for a scalar that is a double or a scalarArray with element type double.
-</p>
-<p>An example is:</p>
-<pre>
-double value = pvaData-&gt;getDouble();
-</pre>
-<p>It also keeps a bitSet showing which fields have changed since the last channelGet or channelPutGet.</p>
-
-<h3>PvaClientMonitorData</h3>
-<p>To the client this looks identical to PvaClientGetData except that
-it provides two BitSets: changedBitSet and overrrunBitSet.
-It is used by pvaMonitor.
-</p>
-<h3>PvaClientPutData</h3>
-<p>This is used to provided data for pvaPut and pvaPutGet.
-It has many of the same methods as pvaGetData.
-It does not have a bitSet.
-It also has put methods like:</p>
-<pre>
-void pvaData-&gt;putDouble(5.0);
-</pre>
-<h3>PvaClientGet</h3>
-<p>This provides methods to connect to channelGet and to issue get request.
-To connect via a single synchronous call:</p>
-<pre>
-eastGet-&gt;connect();  // BLOCKS AND CAN THROW
-</pre>
-<p>This can also be done in two steps:</p>
-<pre>
-pvaGet-&gt;issueConnect(); // DOES NOT BLOCK
-...
-Status status = pvaGet-&gt;waitConnect(); // BLOCKS AND DOES NOT HROW
-</pre>
-<p>Once connected gets are issued via either:</p>
-<pre>
-void pvaGet-&gt;get(); // BLOCKS AND CAN THROW
-</pre>
-or
-<pre>
-pvaGet-&gt;issueGet(); // DOES NOT BLOCK
-...
-Status status = pvaGet-&gt;waitGet(); // BLOCKS AND DOES NOT THROW
-</pre>
-<h3>PvaClientPut</h3>
-<p>This is similar to pvaGet except that it wraps channelPut instead of channelGet.
-</p>
-<p>Once connected puts are issued via either:</p>
-<pre>
-void pvaPut-&gt;put(); // BLOCKS AND CAN THROW
-</pre>
-or
-<pre>
-pvaPut-&gt;issuePut(); // DOES NOT BLOCK
-...
-Status status = pvaPut-&gt;waitPut(); // BLOCKS AND DOES NOT THROW
-</pre>
-<h3>PvaClientMonitor</h3>
-<p>Connecting is similar to pvaGet and pvaPut.
-The other methods are:</p>
-<dl>
-   <dt>start</dt>
-     <dd>Starts monitoring</dd>
-   <dt>stop</dt>
-     <dd>Stops monitoring</dd>
-   <dt>poll</dt>
-     <dd>polls for a monitorEvent.
-      The data is avalable via pvaMonitorData.
-     </dd>
-   <dt>releaseEvent</dt>
-      <dd>Release the data from the last poll.
-       Note that this must be called before another poll is requested.
-       </dd>
-   <dt>waitEvent</dt>
-      <dd>Block until a monitorEvent is available.
-      If true is returned a poll has already been issued.
-      </dd>
-   <dt>setRequester</dt>
-      <dd>A client callback is registered to receive notice of monitorEvents.</dd>
-</dl>
-<h3>PvaClientProcess</h3>
-<p>Connecting is similar to pvaGet.
-It has methods:</p>
-<dl>
-   <dt>process</dt>
-     <dd>call issueProcess and waitProcess.</dd>
-   <dt>issueProcess</dt>
-      <dd>call channelProcess-&gt;process() and return immediately.
-      </dd>
-   <dt>waitProcess</dt>
-      <dd>Wait for process to complete.</dd>
-</dl>
-<h3>PvaClientPutGet</h3>
-<p>Connecting is similar to pvaGet.
-It has methods:</p>
-<dl>
-    <dt>putGet</dt>
-       <dd>calls issuePutGet and waitPutGet.
-        throws an exception if not successfull.
-       </dd>
-    <dt>issuePutGet</dt>
-        <dd>
-         Calls channel-&gt;putGet() and returns.
-        </dd>
-    <dt>waitPutGet</dt>
-        <dd>
-          Waits until putGet completes and returns status.
-        </dd>
-    <dt>getGet,issueGetGet, and waitGetGet</dt>
-        <dd>Gets the data for the get part of channelPutGet.</dd>
-    <dt>getPut,issueGetPut,and waitGetPut</dt>
-        <dd>Gets the data for the put part of channelPutGet.</dd>
-    <dt>getPutData</dt>
-        <dd>
-         Returns the PvaClientData for the put part of channelPutGet.
-        </dd>
-    <dt>getGetData</dt>
-        <dd>
-         Returns the PvaClientData for the get part of channelPutGet.
-        </dd>
-</dl>
-<p>Look at javaDoc for details.</p>
-
-<h2>PvaClientMultiChannel - Wrapper For Multiple Channels</h2>
-<h3>PvaClientMultiChannel</h3>
-<p>This provides methods for connecting to multiple channels.
-</p>
-<h3>PvaClientMultiGetDouble</h3>
-<p>This provides support for channelGet to multiple channels.
-</p>
-<h3>PvaClientMultiPutDouble</h3>
-<p>This provides support for channelPut to multiple channels.
-</p>
-<h3>PvaClientMultiMonitorDouble</h3>
-<p>This provides support for monitoring changes to multiple channels.
-</p>
-
-</div> <!-- class="contents" -->
-</body>
-</html>

example/Makefile

@@ -1,13 +0,0 @@
-# Makefile at top of application tree
-
-TOP = .
-include $(TOP)/configure/CONFIG
-
-DIRS += configure
-
-DIRS += src
-src_DEPEND_DIRS = configure
-
-include $(TOP)/configure/RULES_TOP
-
-

example/configure/CONFIG

@@ -1,29 +0,0 @@
-# CONFIG - Load build configuration data
-#
-# Do not make changes to this file!
-
-# Allow user to override where the build rules come from
-RULES = $(EPICS_BASE)
-
-# RELEASE files point to other application tops
-include $(TOP)/configure/RELEASE
--include $(TOP)/configure/RELEASE.$(EPICS_HOST_ARCH).Common
-ifdef T_A
--include $(TOP)/configure/RELEASE.Common.$(T_A)
--include $(TOP)/configure/RELEASE.$(EPICS_HOST_ARCH).$(T_A)
-endif
-
-CONFIG = $(RULES)/configure
-include $(CONFIG)/CONFIG
-
-# Override the Base definition:
-INSTALL_LOCATION = $(TOP)
-
-# CONFIG_SITE files contain other build configuration settings
-include $(TOP)/configure/CONFIG_SITE
--include $(TOP)/configure/CONFIG_SITE.$(EPICS_HOST_ARCH).Common
-ifdef T_A
- -include $(TOP)/configure/CONFIG_SITE.Common.$(T_A)
- -include $(TOP)/configure/CONFIG_SITE.$(EPICS_HOST_ARCH).$(T_A)
-endif
-

example/configure/CONFIG_SITE

@@ -1,27 +0,0 @@
-# CONFIG_SITE
-
-# Make any application-specific changes to the EPICS build
-#   configuration variables in this file.
-#
-# Host/target specific settings can be specified in files named
-#   CONFIG_SITE.$(EPICS_HOST_ARCH).Common
-#   CONFIG_SITE.Common.$(T_A)
-#   CONFIG_SITE.$(EPICS_HOST_ARCH).$(T_A)
-
-# CHECK_RELEASE controls the consistency checking of the support
-#   applications pointed to by the RELEASE* files.
-# Normally CHECK_RELEASE should be set to YES.
-# Set CHECK_RELEASE to NO to disable checking completely.
-# Set CHECK_RELEASE to WARN to perform consistency checking but
-#   continue building anyway if conflicts are found.
-CHECK_RELEASE = WARN
-
-# To install files into a location other than $(TOP) define
-#   INSTALL_LOCATION here.
-#INSTALL_LOCATION=</path/name/to/install/top>
-
-INSTALL_INCLUDE = $(INSTALL_LOCATION)/include/pv
-USR_INCLUDES += -I $(INSTALL_LOCATION)/include
-
--include $(TOP)/../../CONFIG_SITE.local
--include $(TOP)/../configure/CONFIG_SITE.local

example/configure/ExampleRELEASE.local

@@ -1,7 +0,0 @@
-EPICS_BASE=/home/install/epics/base
-TEMPLATE_TOP=$(EPICS_BASE)/templates/makeBaseApp/top
-EPICSV4HOME=/home/hg
-PVCOMMON=${EPICSV4HOME}/pvCommonCPP
-PVDATA=${EPICSV4HOME}/pvDataCPP
-PVACCESS=${EPICSV4HOME}/pvAccessCPP
-EASYPVA==${EPICSV4HOME}/easyPVACPP

example/configure/Makefile

@@ -1,8 +0,0 @@
-TOP=..
-
-include $(TOP)/configure/CONFIG
-
-TARGETS = $(CONFIG_TARGETS)
-CONFIGS += $(subst ../,,$(wildcard $(CONFIG_INSTALLS)))
-
-include $(TOP)/configure/RULES

example/configure/RELEASE

@@ -1,41 +0,0 @@
-# pvDatabaseCPP/example RELEASE - Location of external support modules
-#
-# IF YOU CHANGE this file or any file it includes you must
-# subsequently do a "gnumake rebuild" in the application's
-# top level directory.
-#
-# The build process does not check dependencies against files
-# that are outside this application, thus you should also do a
-# "gnumake rebuild" in the top level directory after EPICS_BASE
-# or any other external module pointed to below is rebuilt.
-#
-# Host- or target-specific settings can be given in files named
-#  RELEASE.$(EPICS_HOST_ARCH).Common
-#  RELEASE.Common.$(T_A)
-#  RELEASE.$(EPICS_HOST_ARCH).$(T_A)
-
-# EPICS V4 Developers: Do not edit the locations in this file!
-#
-# Create a file RELEASE.local pointing to your PVASRV, PVACCESS,
-# PVDATA, PVCOMMON and EPICS_BASE build directories, e.g.
-#   PVASRV   = /path/to/epics/pvaSrvCPP
-#   PVACCESS = /path/to/epics/pvAccessCPP
-#   PVDATA   = /path/to/epics/pvDataCPP
-#   PVCOMMON = /path/to/epics/pvCommonCPP
-#   EPICS_BASE = /path/to/epics/base
-
-# If this example is built in a directory under pvDatabaseCPP,
-# use the following definitions:
-
-EASYPVA = $(TOP)/..
-
--include $(TOP)/../configure/RELEASE.local
--include $(TOP)/../../RELEASE.local
-
-# If you copied this example from pvDatabaseCPP to be built as a
-# standalone TOP, adjust and use the following definitions:
-
-#EASYPVA = /path/to/epics/easyPVACPP
-
-#-include $(TOP)/../RELEASE.local
-#-include $(TOP)/configure/RELEASE.local

example/configure/RULES

@@ -1,6 +0,0 @@
-# RULES
-
-include $(CONFIG)/RULES
-
-# Library should be rebuilt because LIBOBJS may have changed.
-$(LIBNAME): ../Makefile

example/configure/RULES.ioc

@@ -1,2 +0,0 @@
-#RULES.ioc
-include $(CONFIG)/RULES.ioc

example/configure/RULES_DIRS

@@ -1,2 +0,0 @@
-#RULES_DIRS
-include $(CONFIG)/RULES_DIRS

example/configure/RULES_TOP

@@ -1,3 +0,0 @@
-#RULES_TOP
-include $(CONFIG)/RULES_TOP
-

example/src/Makefile

@@ -1,71 +0,0 @@
-TOP=..
-
-include $(TOP)/configure/CONFIG
-#----------------------------------------
-#  ADD MACRO DEFINITIONS AFTER THIS LINE
-
-
-PROD_HOST += examplePvaClientProcess
-examplePvaClientProcess_SRCS += examplePvaClientProcess.cpp
-examplePvaClientProcess_LIBS += pvaClient
-examplePvaClientProcess_LIBS += pvAccess
-examplePvaClientProcess_LIBS += pvData
-examplePvaClientProcess_LIBS += Com
-
-PROD_HOST += examplePvaClientGet
-examplePvaClientGet_SRCS += examplePvaClientGet.cpp
-examplePvaClientGet_LIBS += pvaClient
-examplePvaClientGet_LIBS += pvAccess
-examplePvaClientGet_LIBS += pvData
-examplePvaClientGet_LIBS += Com
-
-PROD_HOST += examplePvaClientPut
-examplePvaClientPut_SRCS += examplePvaClientPut.cpp
-examplePvaClientPut_LIBS += pvaClient
-examplePvaClientPut_LIBS += pvAccess
-examplePvaClientPut_LIBS += pvData
-examplePvaClientPut_LIBS += Com
-
-PROD_HOST += examplePvaClientMonitor
-examplePvaClientMonitor_SRCS += examplePvaClientMonitor.cpp
-examplePvaClientMonitor_LIBS += pvaClient
-examplePvaClientMonitor_LIBS += pvAccess
-examplePvaClientMonitor_LIBS += pvData
-examplePvaClientMonitor_LIBS += Com
-
-PROD_HOST += examplePvaClientMultiDouble
-examplePvaClientMultiDouble_SRCS += examplePvaClientMultiDouble.cpp
-examplePvaClientMultiDouble_LIBS += pvaClient
-examplePvaClientMultiDouble_LIBS += pvAccess
-examplePvaClientMultiDouble_LIBS += pvData
-examplePvaClientMultiDouble_LIBS += Com
-
-PROD_HOST += examplePvaClientNTMulti
-examplePvaClientNTMulti_SRCS += examplePvaClientNTMulti.cpp
-examplePvaClientNTMulti_LIBS += pvaClient
-examplePvaClientNTMulti_LIBS += pvAccess
-examplePvaClientNTMulti_LIBS += pvData
-examplePvaClientNTMulti_LIBS += Com
-
-PROD_HOST += helloWorldRPC
-helloWorldRPC_SRCS += helloWorldRPC.cpp
-helloWorldRPC_LIBS += pvaClient
-helloWorldRPC_LIBS += pvAccess
-helloWorldRPC_LIBS += nt
-helloWorldRPC_LIBS += pvData
-helloWorldRPC_LIBS += Com
-
-PROD_HOST += helloWorldPutGet
-helloWorldPutGet_SRCS += helloWorldPutGet.cpp
-helloWorldPutGet_LIBS += pvaClient
-helloWorldPutGet_LIBS += pvAccess
-helloWorldPutGet_LIBS += nt
-helloWorldPutGet_LIBS += pvData
-helloWorldPutGet_LIBS += Com
-
-#===========================
-
-include $(TOP)/configure/RULES
-#----------------------------------------
-#  ADD RULES AFTER THIS LINE
-

example/src/examplePvaClientGet.cpp

@@ -1,146 +0,0 @@
-/*examplePvaClientGet.cpp */
-/**
- * Copyright - See the COPYRIGHT that is included with this distribution.
- * EPICS pvData is distributed subject to a Software License Agreement found
- * in file LICENSE that is included with this distribution.
- */
-/**
- * @author mrk
- */
-
-/* Author: Marty Kraimer */
-
-#include <iostream>
-
-#include <pv/pvaClient.h>
-
-using namespace std;
-using namespace epics::pvData;
-using namespace epics::pvAccess;
-using namespace epics::pvaClient;
-
-
-static void exampleDouble(PvaClientPtr const &pva)
-{
-    cout << "example double scalar\n";
-    double value;
-    try {
-        cout << "short way\n";
-        value =  pva->channel("exampleDouble")->get()->getData()->getDouble();
-        cout << "as double " << value << endl;
-    } catch (std::runtime_error e) {
-        cout << "exception " << e.what() << endl;
-    }
-    cout << "long way\n";
-    PvaClientChannelPtr pvaChannel = pva->createChannel("exampleDouble");
-    pvaChannel->issueConnect();
-    Status status = pvaChannel->waitConnect(2.0);
-    if(!status.isOK()) {cout << " connect failed\n"; return;}
-    PvaClientGetPtr pvaGet = pvaChannel->createGet();
-    pvaGet->issueConnect();
-    status = pvaGet->waitConnect();
-    if(!status.isOK()) {cout << " createGet failed\n"; return;}
-    PvaClientGetDataPtr pvaData = pvaGet->getData();
-    value = pvaData->getDouble();
-    cout << "as double " << value << endl;
-}
-
-static void exampleDoubleArray(PvaClientPtr const &pva)
-{
-    cout << "example double array\n";
-    shared_vector<const double> value;
-    try {
-        cout << "short way\n";
-        value =  pva->channel("exampleDoubleArray")->get()->getData()->getDoubleArray();
-        cout << "as doubleArray " << value << endl;
-    } catch (std::runtime_error e) {
-        cout << "exception " << e.what() << endl;
-    }
-    try {
-        cout << "long way\n";
-        PvaClientChannelPtr pvaChannel = pva->createChannel("exampleDoubleArray");
-        pvaChannel->connect(2.0);
-        PvaClientGetPtr pvaGet = pvaChannel->createGet();
-        PvaClientGetDataPtr pvaData = pvaGet->getData();
-        value = pvaData->getDoubleArray();
-        cout << "as doubleArray " << value << endl;
-    } catch (std::runtime_error e) {
-        cout << "exception " << e.what() << endl;
-    }
-}
-
-static void examplePowerSupply(PvaClientPtr const &pva)
-{
-    cout << "example powerSupply\n";
-    PVStructurePtr pvStructure;
-    try {
-        cout << "short way\n";
-        pvStructure =  pva->channel("examplePowerSupply")->
-            get("field()")->getData()->getPVStructure();
-        cout << pvStructure << endl;
-    } catch (std::runtime_error e) {
-        cout << "exception " << e.what() << endl;
-    }
-     
-}
-
-static void exampleCADouble(PvaClientPtr const &pva)
-{
-    cout << "example double scalar\n";
-    double value;
-    try {
-        cout << "short way\n";
-        value =  pva->channel("double00","ca",5.0)->get()->getData()->getDouble();
-        cout << "as double " << value << endl;
-    } catch (std::runtime_error e) {
-        cout << "exception " << e.what() << endl;
-    }
-    cout << "long way\n";
-    PvaClientChannelPtr pvaChannel = pva->createChannel("double00","ca");
-    pvaChannel->issueConnect();
-    Status status = pvaChannel->waitConnect(2.0);
-    if(!status.isOK()) {cout << " connect failed\n"; return;}
-    PvaClientGetPtr pvaGet = pvaChannel->createGet();
-    pvaGet->issueConnect();
-    status = pvaGet->waitConnect();
-    if(!status.isOK()) {cout << " createGet failed\n"; return;}
-    PvaClientGetDataPtr pvaData = pvaGet->getData();
-    value = pvaData->getDouble();
-    cout << "as double " << value << endl;
-}
-
-static void exampleCADoubleArray(PvaClientPtr const &pva)
-{
-    cout << "example double array\n";
-    shared_vector<const double> value;
-    try {
-        cout << "short way\n";
-        value =  pva->channel("doubleArray","ca",5.0)->get()->getData()->getDoubleArray();
-        cout << "as doubleArray " << value << endl;
-    } catch (std::runtime_error e) {
-        cout << "exception " << e.what() << endl;
-    }
-    try {
-        cout << "long way\n";
-        PvaClientChannelPtr pvaChannel = pva->createChannel("doubleArray","ca");
-        pvaChannel->connect(2.0);
-        PvaClientGetPtr pvaGet = pvaChannel->createGet();
-        PvaClientGetDataPtr pvaData = pvaGet->getData();
-        value = pvaData->getDoubleArray();
-        cout << "as doubleArray " << value << endl;
-    } catch (std::runtime_error e) {
-        cout << "exception " << e.what() << endl;
-    }
-}
-
-int main(int argc,char *argv[])
-{
-    PvaClientPtr pva= PvaClient::create();
-    exampleDouble(pva);
-    exampleDoubleArray(pva);
-    examplePowerSupply(pva);
-    exampleCADouble(pva);
-    exampleCADoubleArray(pva);
-    cout << "done\n";
-    return 0;
-}

example/src/examplePvaClientMonitor.cpp

@@ -1,61 +0,0 @@
-/*examplePvaClientMonitor.cpp */
-/**
- * Copyright - See the COPYRIGHT that is included with this distribution.
- * EPICS pvData is distributed subject to a Software License Agreement found
- * in file LICENSE that is included with this distribution.
- */
-/**
- * @author mrk
- */
-
-/* Author: Marty Kraimer */
-
-#include <epicsThread.h>
-
-#include <iostream>
-
-#include <pv/pvaClient.h>
-
-using namespace std;
-using namespace epics::pvData;
-using namespace epics::pvAccess;
-using namespace epics::pvaClient;
-
-
-static void exampleMonitor(PvaClientPtr const &pva,string provider)
-{
-    PvaClientMonitorPtr monitor = pva->channel("double00",provider,2.0)->monitor("");
-    PvaClientMonitorDataPtr monitorData = monitor->getData();
-    PvaClientPutPtr put = pva->channel("double00",provider,2.0)->put("");
-    PvaClientPutDataPtr putData = put->getData();
-    for(size_t ntimes=0; ntimes<5; ++ntimes)
-    {
-         double value = ntimes;
-         cout << "put " << value << endl;
-         putData->putDouble(value); put->put();
-         if(!monitor->waitEvent(.1)) {
-               cout << "waitEvent returned false. Why???";
-               continue;
-         } else while(true) {
-             cout << "monitor " << monitorData->getDouble() << endl;
-             cout << "changed\n";
-             monitorData->showChanged(cout);
-             cout << "overrun\n";
-             monitorData->showOverrun(cout);
-             monitor->releaseEvent();
-             if(!monitor->poll()) break;
-         }
-     }
-}
-
-
-int main(int argc,char *argv[])
-{
-    PvaClientPtr pva = PvaClient::create();
-    cout << "exampleMonitor pva\n";
-    exampleMonitor(pva,"pva");
-    cout << "exampleMonitor ca\n";
-    exampleMonitor(pva,"ca");
-    cout << "done\n";
-    return 0;
-}

example/src/examplePvaClientMultiDouble.cpp

@@ -1,79 +0,0 @@
-/*examplePvaClientMultiDouble.cpp */
-/**
- * Copyright - See the COPYRIGHT that is included with this distribution.
- * EPICS pvData is distributed subject to a Software License Agreement found
- * in file LICENSE that is included with this distribution.
- */
-/**
- * @author mrk
- */
-
-/* Author: Marty Kraimer */
-
-#include <iostream>
-
-#include <pv/pvaClientMultiChannel.h>
-
-using namespace std;
-using namespace epics::pvData;
-using namespace epics::pvAccess;
-using namespace epics::pvaClient;
-
-static void example(
-     PvaClientPtr const &pva,
-     string provider,
-     shared_vector<const string> const &channelNames)
-{
-    
-    size_t num = channelNames.size();
-cout << "num " << num << " names " << channelNames << endl;
-    PvaClientMultiChannelPtr multiChannel(
-        PvaClientMultiChannel::create(pva,channelNames,provider));
-    PvaClientMultiGetDoublePtr multiGet(multiChannel->createGet());
-    PvaClientMultiPutDoublePtr multiPut(multiChannel->createPut());
-    PvaClientMultiMonitorDoublePtr multiMonitor(multiChannel->createMonitor());
-    shared_vector<double> data(num,0);
-    for(double value = 0.2; value< 2.3; value+= 1.0) {
-        try {
-            for(size_t i=0; i<num; ++i) data[i] = value + i;
-            cout << "put " << data << endl;
-            multiPut->put(data);
-            data =  multiGet->get();
-            cout << "get " << data << endl;
-            bool result = multiMonitor->waitEvent(.1);
-            while(result) {
-                cout << "monitor  data " << multiMonitor->get() << endl;
-                result = multiMonitor->poll();
-        }
-        } catch (std::runtime_error e) {
-            cout << "exception " << e.what() << endl;
-        }
-    }
-}
-
-int main(int argc,char *argv[])
-{
-    PvaClientPtr pva = PvaClient::create();
-    size_t num = 5;
-    shared_vector<string> channelNames(num);
-    channelNames[0] = "double01";
-    channelNames[1] = "int01";
-    channelNames[2] = "double03";
-    channelNames[3] = "double04";
-    channelNames[4] = "double05";
-    cout << "double pva\n";
-    shared_vector<const string> names(freeze(channelNames));
-    example(pva,"pva",names);
-    cout << "double ca\n";
-    example(pva,"ca",names);
-    channelNames = shared_vector<string>(num);
-    channelNames[0] = "exampleDouble01";
-    channelNames[1] = "exampleInt";
-    channelNames[2] = "exampleDouble03";
-    channelNames[3] = "exampleDouble04";
-    channelNames[4] = "exampleDouble05";
-    names = freeze(channelNames);
-    cout << "exampleDouble pva\n";
-    example(pva,"pva",names);
-    return 0;
-}

example/src/examplePvaClientNTMulti.cpp

@@ -1,141 +0,0 @@
-/*examplePvaClientNTMulti.cpp */
-/**
- * Copyright - See the COPYRIGHT that is included with this distribution.
- * EPICS pvData is distributed subject to a Software License Agreement found
- * in file LICENSE that is included with this distribution.
- */
-/**
- * @author mrk
- */
-
-/* Author: Marty Kraimer */
-
-#include <iostream>
-
-#include <pv/pvaClientMultiChannel.h>
-#include <pv/convert.h>
-
-using std::tr1::static_pointer_cast;
-using namespace std;
-using namespace epics::pvData;
-using namespace epics::pvAccess;
-using namespace epics::pvaClient;
-
-static PVDataCreatePtr pvDataCreate = getPVDataCreate();
-static ConvertPtr convert = getConvert();
-
-static void setValue(PVUnionPtr const &pvUnion, double value)
-{
-    UnionConstPtr u = pvUnion->getUnion();
-    FieldConstPtr field = u->getField(0);
-    Type type = field->getType();
-    if(type==scalar) {
-         ScalarConstPtr scalar = static_pointer_cast<const Scalar>(field);
-         ScalarType scalarType = scalar->getScalarType();
-         if(scalarType==pvDouble) {
-              PVDoublePtr pvValue = static_pointer_cast<PVDouble>(
-                   pvDataCreate->createPVScalar(pvDouble));
-              pvValue->put(value);
-              pvUnion->set(0,pvValue);
-              return;
-         }
-         if(scalarType==pvString) {
-              PVStringPtr pvValue = static_pointer_cast<PVString>(
-                   pvDataCreate->createPVScalar(pvString));
-              stringstream ss;
-              ss << "value" << value;
-              pvValue->put(ss.str());
-              pvUnion->set(0,pvValue);
-              return;
-         }
-         throw std::runtime_error("only pvDouble and pvString are supported");
-    }
-    if(type==scalarArray) {
-         ScalarArrayConstPtr scalarArray = static_pointer_cast<const ScalarArray>(field);
-         ScalarType scalarType = scalarArray->getElementType();
-         if(scalarType==pvDouble) {
-              size_t num = 5;
-              PVDoubleArrayPtr pvValue = static_pointer_cast<PVDoubleArray>(
-                   pvDataCreate->createPVScalarArray(pvDouble));
-              shared_vector<double> data(num);
-              for(size_t i=0; i<num; ++i) data[i] = value +i;
-              pvValue->replace(freeze(data));
-              pvUnion->set(0,pvValue);
-              return;
-         }
-         if(scalarType==pvString) {
-              size_t num = 5;
-              PVStringArrayPtr pvValue = static_pointer_cast<PVStringArray>(
-                   pvDataCreate->createPVScalarArray(pvString));
-              shared_vector<string> data(num);
-              for(size_t i=0; i<num; ++i) {
-                  stringstream ss;
-                  ss << "value" << value << i;
-                  data[i] = ss.str();
-              }
-              pvValue->replace(freeze(data));
-              pvUnion->set(0,pvValue);
-              return;
-         }
-         throw std::runtime_error("only pvDouble and pvString are supported");
-    }
-    throw std::runtime_error("only scalar and scalarArray fields are supported");
-}
-
-static void example(
-     PvaClientPtr const &pva,
-     string provider,
-     shared_vector<const string> const &channelNames)
-{
-    
-    size_t num = channelNames.size();
-    PvaClientMultiChannelPtr multiChannel(
-        PvaClientMultiChannel::create(pva,channelNames,provider));
-    PvaClientNTMultiGetPtr multiGet(multiChannel->createNTGet());
-    PvaClientNTMultiPutPtr multiPut(multiChannel->createNTPut());
-    PvaClientNTMultiMonitorPtr multiMonitor(multiChannel->createNTMonitor());
-    shared_vector<epics::pvData::PVUnionPtr> data = multiPut->getValues();
-    for(double value = 0.0; value< 2.1; value+= 1.0) {
-        for(size_t i=0; i<num ; ++i) {
-             PVUnionPtr pvUnion = data[i];
-             setValue(pvUnion,value);
-        }
-        multiPut->put();
-        multiGet->get();
-        PvaClientNTMultiDataPtr multiData = multiGet->getData();
-        PVStructurePtr pvStructure = multiData->getNTMultiChannel()->getPVStructure();
-        cout << "pvStructure\n" << pvStructure << endl;
-        bool result = multiMonitor->waitEvent(.1);
-        while(result) {
-            multiData = multiMonitor->getData();
-            pvStructure = multiData->getNTMultiChannel()->getPVStructure();
-            cout << "monitor pvStructure\n" << pvStructure << endl;
-            result = multiMonitor->poll();
-        }
-    }
-}
-
-int main(int argc,char *argv[])
-{
-    PvaClientPtr pva = PvaClient::create();
-    size_t num = 4;
-    shared_vector<string> channelNames(num);
-    channelNames[0] = "double01";
-    channelNames[1] = "string01";
-    channelNames[2] = "doubleArray01";
-    channelNames[3] = "stringArray01";
-    cout << "dbRecord pva\n";
-    shared_vector<const string> names(freeze(channelNames));
-    example(pva,"pva",names);
-    cout << "dbRecord ca\n";
-    example(pva,"ca",names);
-    channelNames = shared_vector<string>(num);
-    channelNames[0] = "exampleDouble";
-    channelNames[1] = "exampleString";
-    channelNames[2] = "exampleDoubleArray";
-    channelNames[3] = "exampleStringArray";
-    names = freeze(channelNames);
-    cout << "pvRecord pva\n";
-    example(pva,"pva",names);
-    return 0;
-}

example/src/examplePvaClientProcess.cpp

@@ -1,44 +0,0 @@
-/*examplePvaClientProcess.cpp */
-/**
- * Copyright - See the COPYRIGHT that is included with this distribution.
- * EPICS pvData is distributed subject to a Software License Agreement found
- * in file LICENSE that is included with this distribution.
- */
-/**
- * @author mrk
- */
-
-/* Author: Marty Kraimer */
-
-#include <iostream>
-
-#include <pv/pvaClient.h>
-
-using namespace std;
-using namespace epics::pvData;
-using namespace epics::pvAccess;
-using namespace epics::pvaClient;
-
-
-static void exampleProcess(PvaClientPtr const &pva)
-{
-    cout << "example process\n";
-    PvaClientChannelPtr channel = pva->channel("exampleDouble");
-    PvaClientProcessPtr process = channel->createProcess();
-    try {
-        process->process();
-        cout <<  channel->get("field()")->getData()->showChanged(cout) << endl;
-        process->process();
-        cout <<  channel->get("field()")->getData()->showChanged(cout) << endl;
-    } catch (std::runtime_error e) {
-        cout << "exception " << e.what() << endl;
-    }
-}
-
-
-int main(int argc,char *argv[])
-{
-    PvaClientPtr pva = PvaClient::create();
-    exampleProcess(pva);
-    return 0;
-}

example/src/examplePvaClientPut.cpp

@@ -1,77 +0,0 @@
-/*examplePvaClientPut.cpp */
-/**
- * Copyright - See the COPYRIGHT that is included with this distribution.
- * EPICS pvData is distributed subject to a Software License Agreement found
- * in file LICENSE that is included with this distribution.
- */
-/**
- * @author mrk
- */
-
-/* Author: Marty Kraimer */
-
-#include <iostream>
-
-#include <pv/pvaClient.h>
-#include <pv/convert.h>
-
-using std::tr1::static_pointer_cast;
-using namespace std;
-using namespace epics::pvData;
-using namespace epics::pvAccess;
-using namespace epics::pvaClient;
-
-static ConvertPtr convert = getConvert();
-
-
-static void examplePut(PvaClientPtr const &pva)
-{
-    cout << "example put\n";
-    PvaClientChannelPtr channel = pva->channel("exampleDouble");
-    PvaClientPutPtr put = channel->put();
-    PvaClientPutDataPtr putData = put->getData();
-    PvaClientMonitorPtr monitor = pva->channel("exampleDouble")->monitor("");
-    PvaClientMonitorDataPtr monitorData = monitor->getData();
-    try {
-        putData->putDouble(3.0); put->put();
-        cout <<  channel->get("field()")->getData()->showChanged(cout) << endl;
-        putData->putDouble(4.0); put->put();
-        cout <<  channel->get("field()")->getData()->showChanged(cout) << endl;
-        if(!monitor->waitEvent()) {
-               cout << "waitEvent returned false. Why???";
-        } else while(true) {
-             cout << "monitor changed\n" << monitorData->showChanged(cout);
-             monitor->releaseEvent();
-             if(!monitor->poll()) break;
-        }
-    } catch (std::runtime_error e) {
-        cout << "exception " << e.what() << endl;
-    }
-}
-
-static void examplePVFieldPut(PvaClientPtr const &pva)
-{
-    cout << "example put\n";
-    PvaClientChannelPtr channel = pva->channel("exampleDouble");
-    PvaClientPutPtr put = channel->put();
-    PvaClientPutDataPtr putData = put->getData();
-    PVFieldPtr pvField = putData->getValue();
-    PVScalarPtr pvScalar = static_pointer_cast<PVScalar>(pvField);
-    try {
-        convert->fromDouble(pvScalar,1.0); put->put();
-        cout <<  channel->get("field()")->getData()->showChanged(cout) << endl;
-        convert->fromDouble(pvScalar,2.0); put->put();
-        cout <<  channel->get("field()")->getData()->showChanged(cout) << endl;
-    } catch (std::runtime_error e) {
-        cout << "exception " << e.what() << endl;
-    }
-}
-
-
-int main(int argc,char *argv[])
-{
-    PvaClientPtr pva = PvaClient::create();
-    examplePut(pva);
-    examplePVFieldPut(pva);
-    return 0;
-}

example/src/helloWorldPutGet.cpp

@@ -1,48 +0,0 @@
-/*helloWorldPutGet.cpp */
-/**
- * Copyright - See the COPYRIGHT that is included with this distribution.
- * EPICS pvData is distributed subject to a Software License Agreement found
- * in file LICENSE that is included with this distribution.
- */
-/**
- * @author mrk
- */
-
-/* Author: Marty Kraimer */
-
-#include <iostream>
-
-#include <pv/pvaClient.h>
-
-using namespace std;
-using namespace epics::pvData;
-using namespace epics::pvAccess;
-using namespace epics::pvaClient;
-
-
-static void example(PvaClientPtr const &pva)
-{
-    cout << "helloWorldPutGet\n";
-    try {
-        PvaClientChannelPtr channel = pva->channel("exampleHello");
-        PvaClientPutGetPtr putGet = channel->createPutGet();
-        putGet->connect();
-        PvaClientPutDataPtr putData = putGet->getPutData();
-        PVStructurePtr arg = putData->getPVStructure();
-        PVStringPtr pvValue = arg->getSubField<PVString>("argument.value");
-        pvValue->put("World");
-        putGet->putGet();
-        PvaClientGetDataPtr getData = putGet->getGetData();
-        cout << getData->getPVStructure() << endl;
-    } catch (std::runtime_error e) {
-        cout << "exception " << e.what() << endl;
-    }
-}
-
-
-int main(int argc,char *argv[])
-{
-    PvaClientPtr pva = PvaClient::create();
-    example(pva);
-    return 0;
-}

example/src/helloWorldRPC.cpp

@@ -1,77 +0,0 @@
-/*helloWorldRPC.cpp */
-/**
- * Copyright - See the COPYRIGHT that is included with this distribution.
- * EPICS pvData is distributed subject to a Software License Agreement found
- * in file LICENSE that is included with this distribution.
- */
-/**
- * @author mrk
- */
-
-/* Author: Marty Kraimer */
-
-#include <iostream>
-#include <pv/pvData.h>
-#include <pv/pvAccess.h>
-#include <pv/rpcClient.h>
-
-using namespace std;
-using namespace epics::pvData;
-using namespace epics::pvAccess;
-
-static FieldCreatePtr fieldCreate = getFieldCreate();
-static PVDataCreatePtr pvDataCreate = getPVDataCreate();
-
-
-static void exampleSimple()
-{
-    StructureConstPtr  topStructure = fieldCreate->createFieldBuilder()->
-        add("value",pvString)->
-        createStructure();
-    PVStructurePtr pvRequest = pvDataCreate->createPVStructure(topStructure);
-    PVStringPtr pvArgument = pvRequest->getSubField<PVString>("value");
-    pvArgument->put("World");
-    cout << "example channeRPC simple\n";
-    try {
-        PVStructurePtr pvResult =
-            RPCClient::sendRequest("exampleHelloRPC", pvRequest);
-        cout << "result\n" << pvResult << endl;
-    } catch (RPCRequestException &e) {
-        cout << e.what() << endl;
-    }
-}
-
-void exampleMore()
-{
-    StructureConstPtr  topStructure = fieldCreate->createFieldBuilder()->
-        add("value",pvString)->
-        createStructure();
-    PVStructurePtr pvRequest = pvDataCreate->createPVStructure(topStructure);
-    PVStringPtr pvArgument = pvRequest->getSubField<PVString>("value");
-    pvArgument->put("World");
-    cout << "example channeRPC more\n";
-    try {
-        RPCClient::shared_pointer client = RPCClient::create("exampleHelloRPC");
-        client->issueConnect();
-        if (client->waitConnect())
-        {
-            client->issueRequest(pvRequest);
-            PVStructure::shared_pointer result = client->waitResponse();
-            std::cout << *result << std::endl;
-        }
-        else {
-            cout << "waitConnect timeout\n";
-            return;
-        }
-    } catch (RPCRequestException &e) {
-        cout << e.what() << endl;
-    }
-}
-
-
-int main(int argc,char *argv[])
-{
-    exampleSimple();
-    exampleMore();
-    return 0;
-}

jenkins/cloudbees_build

@@ -6,22 +6,46 @@
 #
 # Author: Ralph Lange <ralph.lange@gmx.de>
 # Copyright (C) 2013 Helmholtz-Zentrum Berlin für Materialien und Energie GmbH
-# Copyright (C) 2014-2015 ITER Organization.
+# Copyright (C) 2014-2016 ITER Organization.
 # All rights reserved. Use is subject to license terms.
 
+installTool () {
+    local module=$1
+    local version=$2
+
+    wget -nv https://openepics.ci.cloudbees.com/job/${module}-${version}_Build/lastSuccessfulBuild/artifact/${module,,}-${version}.CB-dist.tar.gz
+    tar -xzf ${module,,}-${version}.CB-dist.tar.gz
+}
+
+installE4 () {
+    local module=$1
+    local branch=$2
+
+    # If microbench version does not exist, try without
+    if [ "${MB}" = "WITH_MICROBENCH" ]; then
+        if ! wget -nv https://openepics.ci.cloudbees.com/job/e4-cpp-${module}-${branch}-build/BASE=${BASE},MB=WITH_MICROBENCH/lastSuccessfulBuild/artifact/${module}.CB-dist.tar.gz; then
+            wget -nv https://openepics.ci.cloudbees.com/job/e4-cpp-${module}-${branch}-build/BASE=${BASE},MB=NO_MICROBENCH/lastSuccessfulBuild/artifact/${module}.CB-dist.tar.gz
+        fi
+    else
+        wget -nv https://openepics.ci.cloudbees.com/job/e4-cpp-${module}-${branch}-build/BASE=${BASE},MB=NO_MICROBENCH/lastSuccessfulBuild/artifact/${module}.CB-dist.tar.gz
+    fi
+    tar -xzf ${module}.CB-dist.tar.gz
+}
+
 ###########################################
-# Determine EPICS Base version
+# Defaults for EPICS Base and MB
 
-DEFAULT_BASE=3.14.12.5
+DEFAULT_BASE=3.15.4
+BASE=${BASE:-${DEFAULT_BASE}}
+MB=${MB:-"NO_MICROBENCH"}
 
-BASE=${1:-${DEFAULT_BASE}}
-USE_MB=${2:-"MB_NO"}
+###########################################
+# Dependent module branches
 
-# Dependent module branches (empty = master)
-PVCOMMON_BRANCH="Release-4.1-"
-PVDATA_BRANCH="Release-5.0-"
-PVACCESS_BRANCH="Release-4.1-"
-NORMATIVETYPES_BRANCH="Release-5.0-"
+PVCOMMON_BRANCH="release-4.2"
+PVDATA_BRANCH="release-6.0"
+PVACCESS_BRANCH="release-5.0"
+NORMATIVETYPES_BRANCH="release-5.1"
 
 ###########################################
 # Fetch and unpack dependencies
@@ -32,19 +56,13 @@ rm -fr ${STUFF}
 mkdir -p ${STUFF}
 cd ${STUFF}
 
-wget -nv https://openepics.ci.cloudbees.com/job/Base-${BASE}_Build/lastSuccessfulBuild/artifact/base-${BASE}.CB-dist.tar.gz
-wget -nv https://openepics.ci.cloudbees.com/job/pvDataCPP_${PVDATA_BRANCH}Build/BASE=${BASE},USE_MB=MB_NO/lastSuccessfulBuild/artifact/pvData.CB-dist.tar.gz
-wget -nv https://openepics.ci.cloudbees.com/job/pvAccessCPP_${PVACCESS_BRANCH}Build/BASE=${BASE},USE_MB=${USE_MB}/lastSuccessfulBuild/artifact/pvAccess.CB-dist.tar.gz
-wget -nv https://openepics.ci.cloudbees.com/job/normativeTypesCPP_${NORMATIVETYPES_BRANCH}Build/BASE=${BASE},USE_MB=MB_NO/lastSuccessfulBuild/artifact/normativeTypes.CB-dist.tar.gz
-tar -xzf base-${BASE}.CB-dist.tar.gz
-tar -xzf pvData.CB-dist.tar.gz
-tar -xzf pvAccess.CB-dist.tar.gz
-tar -xzf normativeTypes.CB-dist.tar.gz
+installTool Boost 1.61.0
+installTool Base ${BASE}
 
-if [ "${USE_MB}" = "MB_YES" ]; then
-    wget -nv https://openepics.ci.cloudbees.com/job/pvCommonCPP_${PVCOMMON_BRANCH}Build/BASE=${BASE},USE_MB=MB_YES/lastSuccessfulBuild/artifact/pvCommon.CB-dist.tar.gz
-    tar -xzf pvCommon.CB-dist.tar.gz
-fi
+installE4 pvCommon ${PVCOMMON_BRANCH}
+installE4 pvData ${PVDATA_BRANCH}
+installE4 pvAccess ${PVACCESS_BRANCH}
+installE4 normativeTypes ${NORMATIVETYPES_BRANCH}
 
 ###########################################
 # Build
@@ -65,7 +83,8 @@ make distclean all
 ###########################################
 # Test
 
-make runtests
+# no regression tests
+#make runtests
 
 ###########################################
 # Create distribution

jenkins/cloudbees_doc

@@ -6,15 +6,39 @@
 #
 # Author: Ralph Lange <ralph.lange@gmx.de>
 # Copyright (C) 2013 Helmholtz-Zentrum Berlin für Materialien und Energie GmbH
-# Copyright (C) 2014-2015 ITER Organization.
+# Copyright (C) 2014-2016 ITER Organization.
 # All rights reserved. Use is subject to license terms.
 
+installTool () {
+    local module=$1
+    local version=$2
+
+    wget -nv https://openepics.ci.cloudbees.com/job/${module}-${version}_Build/lastSuccessfulBuild/artifact/${module,,}-${version}.CB-dist.tar.gz
+    tar -xzf ${module,,}-${version}.CB-dist.tar.gz
+}
+
+installE4 () {
+    local module=$1
+    local branch=$2
+
+    # If microbench version does not exist, try without
+    if [ "${MB}" = "WITH_MICROBENCH" ]; then
+        if ! wget -nv https://openepics.ci.cloudbees.com/job/e4-cpp-${module}-${branch}-build/BASE=${BASE},MB=WITH_MICROBENCH/lastSuccessfulBuild/artifact/${module}.CB-dist.tar.gz; then
+            wget -nv https://openepics.ci.cloudbees.com/job/e4-cpp-${module}-${branch}-build/BASE=${BASE},MB=NO_MICROBENCH/lastSuccessfulBuild/artifact/${module}.CB-dist.tar.gz
+        fi
+    else
+        wget -nv https://openepics.ci.cloudbees.com/job/e4-cpp-${module}-${branch}-build/BASE=${BASE},MB=NO_MICROBENCH/lastSuccessfulBuild/artifact/${module}.CB-dist.tar.gz
+    fi
+    tar -xzf ${module}.CB-dist.tar.gz
+}
+
 ###########################################
-# Determine EPICS Base version
+# Defaults for EPICS Base and parameters
 
-DEFAULT_BASE=3.14.12.5
-
-BASE=${1:-${DEFAULT_BASE}}
+BASE=3.15.4
+PUBLISH=${PUBLISH:-NO}
+BRANCH=${BRANCH:-master}
+MB=NO_MICROBENCH
 
 ###########################################
 # Fetch and unpack dependencies
@@ -25,16 +49,14 @@ rm -fr ${STUFF}
 mkdir -p ${STUFF}
 cd ${STUFF}
 
-wget -nv https://openepics.ci.cloudbees.com/job/Doxygen-1.8.3_Build/lastSuccessfulBuild/artifact/doxygen-1.8.3.CB-dist.tar.gz
-tar -xzf doxygen-1.8.3.CB-dist.tar.gz
+installTool Doxygen 1.8.11
 
 ###########################################
 # Generate
 
 cd ${WORKSPACE}
 
-wget -nv https://openepics.ci.cloudbees.com/job/pvaClientCPP_Build/BASE=${BASE},USE_MB=MB_NO/lastSuccessfulBuild/artifact/pvaClient.CB-dist.tar.gz
-tar -xzf pvaClient.CB-dist.tar.gz
+installE4 pvaClient ${BRANCH}
 
 export PATH=${STUFF}/bin:${PATH}
 
@@ -43,4 +65,9 @@ doxygen
 ###########################################
 # Publish
 
-rsync -aqP --delete -e ssh documentation epics-jenkins@web.sourceforge.net:/home/project-web/epics-pvdata/htdocs/docbuild/pvaClientCPP/tip
+if [ "${PUBLISH}" != "NO" ]; then
+    # Upload explicit dummy to ensure target directory exists
+    echo "Created by CloudBees Jenkins upload job. Should be deleted as part of the job." > DUMMY
+    rsync -q -e ssh DUMMY epics-jenkins@web.sourceforge.net:/home/project-web/epics-pvdata/htdocs/docbuild/pvaClientCPP/${PUBLISH}/
+    rsync -aqP --delete -e ssh documentation epics-jenkins@web.sourceforge.net:/home/project-web/epics-pvdata/htdocs/docbuild/pvaClientCPP/${PUBLISH}/
+fi

src/Makefile

@@ -5,8 +5,11 @@ include $(TOP)/configure/CONFIG
 
 LIBRARY += pvaClient
 
-INC += pvaClient.h
-INC += pvaClientMultiChannel.h
+# shared library ABI version.
+SHRLIB_VERSION ?= 4.2
+
+INC += pv/pvaClient.h
+INC += pv/pvaClientMultiChannel.h
 
 LIBSRCS += pvaClient.cpp
 LIBSRCS += pvaClientPutData.cpp
@@ -26,8 +29,9 @@ LIBSRCS += pvaClientNTMultiPut.cpp
 LIBSRCS += pvaClientNTMultiData.cpp
 LIBSRCS += pvaClientNTMultiGet.cpp
 LIBSRCS += pvaClientNTMultiMonitor.cpp
+LIBSRCS += pvaClientRPC.cpp
 
-pvaClient_LIBS += pvAccess pvData nt Com
+pvaClient_LIBS += pvAccess nt pvData Com
 pvaClient_LIBS +=  $(EPICS_BASE_IOC_LIBS)
 
 include $(TOP)/configure/RULES

src/pv/pvaClientMultiChannel.h

@@ -12,14 +12,21 @@
 #define PVACLIENTMULTICHANNEL_H
 
 #ifdef epicsExportSharedSymbols
-#   define pvaClientEpicsExportSharedSymbols
+#   define pvaClientMultiChannelEpicsExportSharedSymbols
 #   undef epicsExportSharedSymbols
 #endif
 
-#include <pv/pvaClient.h>
 #include <pv/ntmultiChannel.h>
 #include <pv/createRequest.h>
 
+#ifdef pvaClientMultiChannelEpicsExportSharedSymbols
+#   define epicsExportSharedSymbols
+#	undef pvaClientMultiChannelEpicsExportSharedSymbols
+#endif
+
+
+#include <pv/pvaClient.h>
+
 
 namespace epics { namespace pvaClient { 
 
@@ -55,7 +62,7 @@ class epicsShareClass PvaClientMultiChannel :
 {
 public:
     POINTER_DEFINITIONS(PvaClientMultiChannel);
-    /** Create a PvaClientMultiChannel.
+    /** @brief Create a PvaClientMultiChannel.
      * @param pvaClient The interface to pvaClient.
      * @param channelNames The names of the channel..
      * @param providerName The name of the provider.
@@ -69,101 +76,85 @@ public:
          size_t maxNotConnected=0
      );
      /**
-     * Destructor
+     * @brief Destructor
      */
     ~PvaClientMultiChannel();
-    /** Destroy the pvAccess connections.
-     */
-    void destroy();
-    /** Get the channelNames.
+    /** @brief Get the channelNames.
      * @return The names.
      */
     epics::pvData::shared_vector<const std::string> getChannelNames();
-    /** Connect to the channels.
+    /** @brief Connect to the channels.
+     *
      * This calls issueConnect and waitConnect.
      * An exception is thrown if connect fails.
      * @param timeout The time to wait for connecting to the channel.
      * @return status of request
      */
     epics::pvData::Status connect(double timeout=5);
-    /** Are all channels connected?
+    /** @brief Are all channels connected?
      * @return if all are connected.
      */
     bool allConnected();
-    /** Has a connection state change occured?
+    /** @brief Has a connection state change occured?
      * @return (true, false) if (at least one, no) channel has changed state.
      */
     bool connectionChange();
-    /** Get the connection state of each channel.
+    /** @brief Get the connection state of each channel.
      * @return The state of each channel.
      */
     epics::pvData::shared_vector<epics::pvData::boolean> getIsConnected();
-    /** Get the pvaClientChannelArray.
+    /** @brief Get the pvaClientChannelArray.
      * @return The shared pointer.
      */
     PvaClientChannelArray getPvaClientChannelArray();
-    /** Get pvaClient.
+    /** @brief Get pvaClient.
      * @return The shared pointer.
      */
     PvaClientPtr getPvaClient();
     /**
-     * create a pvaClientMultiGetDouble
+     * @brief create a pvaClientMultiGetDouble
      * @return The interface.
      */
     PvaClientMultiGetDoublePtr createGet();   
     /**
-     * create a pvaClientMultiPutDouble
+     * @brief Create a pvaClientMultiPutDouble.
      * @return The interface.
      */
     PvaClientMultiPutDoublePtr createPut();
     /**
-     * Create a pvaClientMultiMonitorDouble.
+     * @brief Create a pvaClientMultiMonitorDouble.
      * @return The interface.
      */
     PvaClientMultiMonitorDoublePtr createMonitor();
     /**
-     * Create a pvaClientNTMultiPut.
+     * @brief Create a pvaClientNTMultiPut.
      * @return The interface.
      */
     PvaClientNTMultiPutPtr createNTPut();
     /**
-     * Create a pvaClientNTMultiGet.
-     * This calls the next method with request = "value,alarm,timeStamp"
-     * @return The interface.
-     */
-    PvaClientNTMultiGetPtr createNTGet();
-    /**
-     * Create a pvaClientNTMultiGet;
+     * @brief Create a pvaClientNTMultiGet;
      * @param request The request for each channel.
      * @return The interface.
      */
-    PvaClientNTMultiGetPtr createNTGet(std::string const &request);
+    PvaClientNTMultiGetPtr createNTGet(
+        std::string const &request = "field(value,alarm,timeStamp)");
     /**
-     * Create a pvaClientNTMultiMonitor.
-     * This calls the next method with request = "value,alarm,timeStamp"
-     * @return The interface.
-     */
-    PvaClientNTMultiMonitorPtr createNTMonitor();
-    /**
-     * Create a pvaClientNTMultiPut.
+     * @brief Create a pvaClientNTMultiPut.
      * @param request The request for each channel.
      * @return The interface.
      */
-    PvaClientNTMultiMonitorPtr createNTMonitor(std::string const &request);
-    /** Get the shared pointer to self.
-     * @return The shared pointer.
+    PvaClientNTMultiMonitorPtr createNTMonitor(
+        std::string const &request= "field(value,alarm,timeStamp)");
+     /** Deprecated method
+     * \deprecated This method will go away in future versions. 
      */
-    PvaClientMultiChannelPtr getPtrSelf()
-    {
-        return shared_from_this();
-    }
+    void destroy()  EPICS_DEPRECATED {}
 private:
     PvaClientMultiChannel(
         PvaClientPtr const &pvaClient,
         epics::pvData::shared_vector<const std::string> const & channelName,
         std::string const & providerName,
         size_t maxNotConnected);
-
     void checkConnected();
     
     PvaClientPtr pvaClient;
@@ -178,12 +169,10 @@ private:
     PvaClientChannelArray pvaClientChannelArray;
     epics::pvData::shared_vector<epics::pvData::boolean> isConnected;
     epics::pvData::CreateRequest::shared_pointer createRequest;
-    bool isDestroyed;
-    
 };
 
 /**
- *  This provides channelGet to multiple channels where each channel has a numeric scalar value field.
+ *  @brief Provides channelGet to multiple channels where each channel has a numeric scalar value field.
  */
 class epicsShareClass PvaClientMultiGetDouble :
     public std::tr1::enable_shared_from_this<PvaClientMultiGetDouble>
@@ -193,7 +182,7 @@ public:
     POINTER_DEFINITIONS(PvaClientMultiGetDouble);
     
     /**
-     * Factory method that creates a PvaClientMultiGetDouble.
+     * @brief Create a PvaClientMultiGetDouble.
      * @param pvaClientMultiChannel The interface to PvaClientMultiChannel.
      * @param pvaClientChannelArray The PvaClientChannel array.
      * @return The interface.
@@ -204,25 +193,26 @@ public:
 
     ~PvaClientMultiGetDouble();
 
-    /** Destroy the pvAccess connection.
-     */
-    void destroy();
      /**
-     * Create a channelGet for each channel.
-     */
+      * @brief Create a channelGet for each channel.
+      */
     void connect();
     /**
-     * get the data.
+     * @brief Get the data.
      * @return The double[] where each element is the value field of the corresponding channel.
      */
     epics::pvData::shared_vector<double> get();
-    /** Get the shared pointer to self.
+    /** @brief Get the shared pointer to self.
      * @return The shared pointer.
      */
     PvaClientMultiGetDoublePtr getPtrSelf()
     {
         return shared_from_this();
     }
+    /** Deprecated method
+     * \deprecated This method will go away in future versions. 
+     */
+    void destroy()  EPICS_DEPRECATED {}
 private:
     PvaClientMultiGetDouble(
          PvaClientMultiChannelPtr const &pvaClientMultiChannel,
@@ -236,11 +226,10 @@ private:
     epics::pvData::shared_vector<double> doubleValue;
     std::vector<PvaClientGetPtr> pvaClientGet;
     bool isGetConnected;
-    bool isDestroyed;
 };
 
 /**
- * This provides channelPut to multiple channels where each channel has a numeric scalar value field.
+ * @brief Provides channelPut to multiple channels where each channel has a numeric scalar value field.
  */
 class epicsShareClass PvaClientMultiPutDouble :
     public std::tr1::enable_shared_from_this<PvaClientMultiPutDouble>
@@ -249,35 +238,34 @@ class epicsShareClass PvaClientMultiPutDouble :
 public:
     POINTER_DEFINITIONS(PvaClientMultiPutDouble);
    
-    /**
-     * Factory method that creates a PvaClientMultiPutDouble.
+    /** @brief Create a PvaClientMultiPutDouble.
      * @param pvaClientMultiChannel The interface to PvaClientMultiChannel.
      * @param pvaClientChannelArray The PvaClientChannel array.
      * @return The interface.
      */
     static PvaClientMultiPutDoublePtr create(
-         PvaClientMultiChannelPtr const &pvaMultiChannel,
+         PvaClientMultiChannelPtr const &pvaClientMultiChannel,
          PvaClientChannelArray const &pvaClientChannelArray);
     ~PvaClientMultiPutDouble();
-
-    /** Destroy the pvAccess connection.
-     */
-    void destroy();
      /**
-     * Create a channelPut for each channel.
+     * @brief Create a channelPut for each channel.
      */
     void connect();
-    /** put data to each channel as a double
+    /** @brief put data to each channel as a double
      * @param data The array of data for each channel.
      */
     void put(epics::pvData::shared_vector<double> const &data);
-    /** Get the shared pointer to self.
+    /** @brief Get the shared pointer to self.
      * @return The shared pointer.
      */
     PvaClientMultiPutDoublePtr getPtrSelf()
     {
         return shared_from_this();
     }
+    /** Deprecated method
+     * \deprecated This method will go away in future versions. 
+     */
+    void destroy()  EPICS_DEPRECATED {}
 private:
     PvaClientMultiPutDouble(
          PvaClientMultiChannelPtr const &pvaClientMultiChannel,
@@ -290,11 +278,10 @@ private:
 
     std::vector<PvaClientPutPtr> pvaClientPut;
     bool isPutConnected;
-    bool isDestroyed;
 };
 
 /**
- * This provides a monitor to multiple channels where each channel has a numeric scalar value field.
+ * @brief Provides a monitor to multiple channels where each channel has a numeric scalar value field.
  */
 class epicsShareClass PvaClientMultiMonitorDouble :
     public std::tr1::enable_shared_from_this<PvaClientMultiMonitorDouble>
@@ -303,49 +290,49 @@ class epicsShareClass PvaClientMultiMonitorDouble :
 public:
     POINTER_DEFINITIONS(PvaClientMultiMonitorDouble);
     
-    /**
-     * Factory method that creates a PvaClientMultiMonitorDouble.
+    /** @brief Create a PvaClientMultiMonitorDouble.
      * @param pvaClientMultiChannel The interface to PvaClientMultiChannel.
      * @param pvaClientChannelArray The PvaClientChannel array.
      * @return The interface.
      */
     static PvaClientMultiMonitorDoublePtr create(
-         PvaClientMultiChannelPtr const &pvaMultiChannel,
+         PvaClientMultiChannelPtr const &pvaClientMultiChannel,
          PvaClientChannelArray const &pvaClientChannelArray);
     ~PvaClientMultiMonitorDouble();
-
-    /** Destroy the pvAccess connection.
-     */
-    void destroy();
      /**
-     * Create a channel monitor for each channel.
-     */
+      * @brief Connect a channel monitor for each channel.
+      */
     void connect();
      /**
-     * poll each channel.
+     * @brief Poll each channel.
+     *
      * If any has new data it is used to update the double[].
      * @return (false,true) if (no, at least one) value was updated.
      */
     bool poll();
     /**
-     * Wait until poll returns true.
-     * @param waitForEvent The time to keep trying.
+     * @brief Wait until poll returns true.
+     * @param secondsToWait The time to keep trying.
      * A thread sleep of .1 seconds occurs between each call to poll.
      * @return (false,true) if (timeOut, poll returned true).
      */
-    bool waitEvent(double waitForEvent);
+    bool waitEvent(double secondsToWait);
     /**
      * get the data.
      *  @return The double[] where each element is the value field of the corresponding channel.
      */
     epics::pvData::shared_vector<double> get();
-    /** Monitor the shared pointer to self.
+    /** @brief Monitor the shared pointer to self.
      * @return The shared pointer.
      */
     PvaClientMultiMonitorDoublePtr getPtrSelf()
     {
         return shared_from_this();
     }
+    /** Deprecated method
+     * \deprecated This method will go away in future versions. 
+     */
+    void destroy()  EPICS_DEPRECATED {}
 private:
     PvaClientMultiMonitorDouble(
          PvaClientMultiChannelPtr const &pvaClientMultiChannel,
@@ -359,11 +346,10 @@ private:
     epics::pvData::shared_vector<double> doubleValue;
     std::vector<PvaClientMonitorPtr> pvaClientMonitor;
     bool isMonitorConnected;
-    bool isDestroyed;
 };
 
 /**
- *  This provides channelGet to multiple channels where the value field of each channel is presented as a union.
+ *  @brief Provides channelGet to multiple channels where the value field of each channel is presented as a union.
  */
 class epicsShareClass PvaClientNTMultiGet :
     public std::tr1::enable_shared_from_this<PvaClientNTMultiGet>
@@ -372,7 +358,7 @@ class epicsShareClass PvaClientNTMultiGet :
 public:
     POINTER_DEFINITIONS(PvaClientNTMultiGet);
      /**
-     * Factory method that creates a PvaClientNTMultiGet.
+     * @brief Create a PvaClientNTMultiGet.
      * @param pvaClientMultiChannel The interface to PvaClientMultiChannel.
      * @param pvaClientChannelArray The PvaClientChannel array.
      * @param pvRequest The pvRequest for each channel.
@@ -384,30 +370,30 @@ public:
          epics::pvData::PVStructurePtr const &  pvRequest);
 
     ~PvaClientNTMultiGet();
-
-    /** Destroy the pvAccess connection.
-     */
-    void destroy();
      /**
-     * Create a channelGet for each channel.
-     */
+      * @brief Connect a channelGet for each channel.
+      */
     void connect();
     /**
-     * get data for each channel.
+     * @brief Get each channel.
      */
     void get();
     /**
-     * get the data.
+     * @brief Get the data from the last get.
      * @return the pvaClientNTMultiData.
      */
     PvaClientNTMultiDataPtr getData();
-    /** Get the shared pointer to self.
+    /** @brief Get the shared pointer to self.
      * @return The shared pointer.
      */
     PvaClientNTMultiGetPtr getPtrSelf()
     {
         return shared_from_this();
     }
+    /** Deprecated method
+     * \deprecated This method will go away in future versions. 
+     */
+    void destroy()  EPICS_DEPRECATED {}
 private:
     PvaClientNTMultiGet(
          epics::pvData::UnionConstPtr const & u,
@@ -425,11 +411,10 @@ private:
     PvaClientNTMultiDataPtr pvaClientNTMultiData;
     std::vector<PvaClientGetPtr> pvaClientGet;
     bool isConnected;
-    bool isDestroyed;
 };
 
 /**
- *  This provides channelPut to multiple channels where the value field of each channel is presented as a union.
+ *  @brief Provides channelPut to multiple channels where the value field of each channel is presented as a union.
  */
 class epicsShareClass PvaClientNTMultiPut :
     public std::tr1::enable_shared_from_this<PvaClientNTMultiPut>
@@ -438,7 +423,7 @@ class epicsShareClass PvaClientNTMultiPut :
 public:
     POINTER_DEFINITIONS(PvaClientNTMultiPut);
     /**
-     * Factory method that creates a PvaClientNTMultiPut.
+     * @brief Create a PvaClientNTMultiPut.
      * @param pvaClientMultiChannel The interface to PvaClientMultiChannel.
      * @param pvaClientChannelArray The PvaClientChannel array.
      * @return The interface.
@@ -446,31 +431,32 @@ public:
     static PvaClientNTMultiPutPtr create(
          PvaClientMultiChannelPtr const &pvaClientMultiChannel,
          PvaClientChannelArray const &pvaClientChannelArray);
+     
     ~PvaClientNTMultiPut();
-
-    /** Destroy the pvAccess connection.
-     */
-    void destroy();
      /**
-     * Create a channelPut for each channel.
+     * @brief Connect a channelPut for each channel.
      */
     void connect();
     /**
-     * get the value field of each channel as a union.
+     * @brief Get the value field of each channel as a union.
      * @return A shared vector of union.
      */
     epics::pvData::shared_vector<epics::pvData::PVUnionPtr> getValues();
     /**
-     * put the data to each channel.
+     * @brief Issue a put for each channel.
 '    */
     void put();
-    /** Get the shared pointer to self.
+    /** @brief Get the shared pointer to self.
      * @return The shared pointer.
      */
     PvaClientNTMultiPutPtr getPtrSelf()
     {
         return shared_from_this();
     }
+    /** Deprecated method
+     * \deprecated This method will go away in future versions. 
+     */
+    void destroy()  EPICS_DEPRECATED {}
 private:
     PvaClientNTMultiPut(
          PvaClientMultiChannelPtr const &pvaClientMultiChannel,
@@ -485,11 +471,10 @@ private:
     epics::pvData::shared_vector<epics::pvData::PVFieldPtr> value;
     std::vector<PvaClientPutPtr> pvaClientPut;
     bool isConnected;
-    bool isDestroyed;
 };
 
 /**
- *  This provides channel monitor to multiple channels where the value field of each channel is presented as a union.
+ *  @brief Provides channel monitor to multiple channels where the value field of each channel is presented as a union.
  */
 class epicsShareClass PvaClientNTMultiMonitor :
     public std::tr1::enable_shared_from_this<PvaClientNTMultiMonitor>
@@ -497,41 +482,37 @@ class epicsShareClass PvaClientNTMultiMonitor :
 
 public:
     POINTER_DEFINITIONS(PvaClientNTMultiMonitor);
-    /**
-     * Factory method that creates a PvaClientNTMultiMonitor.
+    /** @brief Create a PvaClientNTMultiMonitor.
      * @param pvaClientMultiChannel The interface to PvaClientMultiChannel.
      * @param pvaClientChannelArray The PvaClientChannel array.
      * @param pvRequest The pvRequest for each channel.
      * @return The interface.
      */
     static PvaClientNTMultiMonitorPtr create(
-         PvaClientMultiChannelPtr const &pvaNTMultiChannel,
+         PvaClientMultiChannelPtr const &pvaClientMultiChannel,
          PvaClientChannelArray const &pvaClientChannelArray,
          epics::pvData::PVStructurePtr const &  pvRequest);
     ~PvaClientNTMultiMonitor();
-
-    /** Destroy the pvAccess connection.
-     */
-    void destroy();
      /**
-     * Create a channel monitor for each channel.
+     * @brief Connect to a channel monitor for each channel.
      */
     void connect();
      /**
-     * poll each channel.
+     * @brief Poll each channel.
+     *
      * If any has new data it is used to update the double[].
      * @return (false,true) if (no, at least one) value was updated.
      */
     bool poll();
     /**
-     * Wait until poll returns true.
-     * @param waitForEvent The time to keep trying.
+     * @brief Wait until poll returns true.
+     * @param secondsToWait The time to keep trying.
      * A thread sleep of .1 seconds occurs between each call to poll.
      * @return (false,true) if (timeOut, poll returned true).
      */
-    bool waitEvent(double waitForEvent);
+    bool waitEvent(double secondsToWait);
      /**
-     * get the data.
+     * @brief Get the data for the last successfull poll.
      * @return the pvaClientNTMultiData.
      */
     PvaClientNTMultiDataPtr getData();
@@ -542,6 +523,10 @@ public:
     {
         return shared_from_this();
     }
+    /** Deprecated method
+     * \deprecated This method will go away in future versions. 
+     */
+    void destroy()  EPICS_DEPRECATED {}
 private:
     PvaClientNTMultiMonitor(
          epics::pvData::UnionConstPtr const & u,
@@ -557,11 +542,10 @@ private:
     PvaClientNTMultiDataPtr pvaClientNTMultiData;
     std::vector<PvaClientMonitorPtr> pvaClientMonitor;
     bool isConnected;
-    bool isDestroyed;
 };
 
 /**
- *  This provides NTMultiChannel data for both PvaClientNTMultiGet and PvaClientNTMultiMonitor.
+ *  @brief Provides NTMultiChannel data for both PvaClientNTMultiGet and PvaClientNTMultiMonitor.
  */
 class epicsShareClass PvaClientNTMultiData :
     public std::tr1::enable_shared_from_this<PvaClientNTMultiData>
@@ -570,7 +554,8 @@ class epicsShareClass PvaClientNTMultiData :
 public:
     POINTER_DEFINITIONS(PvaClientNTMultiData);
     /**
-     * Factory method that creates a PvaClientNTMultiData.
+     * @brief Create a PvaClientNTMultiData.
+     *
      * Normally only called by PvaClientNTMultiGet and PvaClientNTMultiMonitor.
      * @param u The union interface for the value field of each channel.
      * @param pvaClientMultiChannel The interface to PvaClientMultiChannel.
@@ -579,47 +564,47 @@ public:
      */
     static PvaClientNTMultiDataPtr create(
          epics::pvData::UnionConstPtr const & u,
-         PvaClientMultiChannelPtr const &pvaNTMultiChannel,
+         PvaClientMultiChannelPtr const &pvaClientMultiChannel,
          PvaClientChannelArray const &pvaClientChannelArray,
          epics::pvData::PVStructurePtr const &  pvRequest);
     ~PvaClientNTMultiData();
-    /** Destroy the pvAccess connection.
-     */
-    void destroy();
-
+    
     /**
-     * Get the number of channels.
+     * @brief Get the number of channels.
      * @return The number of channels.
      */
     size_t getNumber();
    
     /**
-     * Set the timeStamp base for computing deltaTimes. 
+     * @brief Set the timeStamp base for computing deltaTimes. 
      */
     void startDeltaTime();
    
     /**
-     * Update NTMultiChannel fields.
+     * @brief Update NTMultiChannel fields.
      */
     void endDeltaTime();
     /**
-     * Get the time when the last get was made.
+     * @brief Get the time when the last get was made.
      * @return The timeStamp.
      */
     epics::pvData::TimeStamp getTimeStamp(); 
     /**
-     * Get the  NTMultiChannel.
+     * @brief Get the  NTMultiChannel.
      * @return The value.
      */
     epics::nt::NTMultiChannelPtr getNTMultiChannel();
-    /** Get the shared pointer to self.
+    /** @brief Get the shared pointer to self.
      * @return The shared pointer.
      */
     PvaClientNTMultiDataPtr getPtrSelf()
     {
         return shared_from_this();
     }
-   
+    /** Deprecated method
+     * \deprecated This method will go away in future versions. 
+     */
+    void destroy()  EPICS_DEPRECATED {}
 private:
     PvaClientNTMultiData(
          epics::pvData::UnionConstPtr const & u,
@@ -638,7 +623,6 @@ private:
     std::vector<epics::pvData::PVStructurePtr> topPVStructure;
     bool gotAlarm;
     bool gotTimeStamp;
-    bool isDestroyed;
     
     epics::pvData::StructureConstPtr ntMultiChannelStructure;
     epics::pvData::shared_vector<epics::pvData::PVUnionPtr> unionValue;
@@ -661,9 +645,3 @@ private:
 
 #endif  /* PVACLIENTMULTICHANNEL_H */
 
-/** @page Overview Documentation
- *
- * <a href = "../pvaClientOverview.html">pvaClientOverview.html</a>
- *
- */
-

src/pvaClient.cpp

@@ -9,13 +9,15 @@
  * @date 2015.02
  */
 
-#define epicsExportSharedSymbols
 #include <map>
-#include <pv/pvaClient.h>
 #include <pv/createRequest.h>
 #include <pv/clientFactory.h>
 #include <pv/caProvider.h>
 
+#define epicsExportSharedSymbols
+
+#include <pv/pvaClient.h>
+
 using std::tr1::static_pointer_cast;
 using namespace epics::pvData;
 using namespace epics::pvAccess;
@@ -24,65 +26,18 @@ using namespace std;
 
 namespace epics { namespace pvaClient { 
 
-static FieldCreatePtr fieldCreate = getFieldCreate(); 
-static const string pvaClientName = "pvaClient";
-static const string defaultProvider = "pva";
-static UnionConstPtr variantUnion = fieldCreate->createVariantUnion();
 
-namespace pvaClientPvt {
-
-    static size_t numberPvaClient = 0;
-    static bool firstTime = true;
-    static Mutex mutex;
-    
-    class StartStopClientFactory {
-    public:
-        static void PvaClientBeingConstructed()
-        {
-            bool saveFirst = false;
-            { 
-                 Lock xx(mutex);
-                 ++numberPvaClient;
-                 saveFirst = firstTime;
-                 firstTime = false;
-            }
-            if(saveFirst) {
-                ClientFactory::start();
-                CAClientFactory::start();
-            }
-        }
-    
-        static void PvaClientBeingDestroyed() {
-            size_t numLeft = 0;
-            {
-                 Lock xx(mutex);
-                 --numberPvaClient;
-                  numLeft = numberPvaClient;
-            }
-            if(numLeft<=0) {
-                ClientFactory::stop();
-                CAClientFactory::stop();
-            }
-        }
-    };
-
-} // namespace pvaClientPvt
-
-class PvaClientChannelCache
+class epicsShareClass PvaClientChannelCache
 {
 public:
     PvaClientChannelCache(){}
     ~PvaClientChannelCache(){
-         destroy();
+         if(PvaClient::getDebug()) cout << "PvaClientChannelCache::~PvaClientChannelCache\n";
      }
-    void destroy() {
-       pvaClientChannelMap.clear();
-    }
     PvaClientChannelPtr getChannel(
         string const & channelName,
         string const & providerName);
     void addChannel(PvaClientChannelPtr const & pvaClientChannel);
-    void removeChannel(string const & channelName,string const & providerName);
     void showCache();
     size_t cacheSize();
 private:
@@ -104,17 +59,12 @@ void PvaClientChannelCache::addChannel(PvaClientChannelPtr const & pvaClientChan
      Channel::shared_pointer channel = pvaClientChannel->getChannel();
      string name = channel->getChannelName()
          + channel->getProvider()->getProviderName();
-     pvaClientChannelMap.insert(std::pair<string,PvaClientChannelPtr>(
-         name,pvaClientChannel));
-}
-
-void PvaClientChannelCache::removeChannel(
-        string const & channelName,
-        string const & providerName)
-{
-    string name = channelName + providerName;
     map<string,PvaClientChannelPtr>::iterator iter = pvaClientChannelMap.find(name);
-    if(iter!=pvaClientChannelMap.end()) pvaClientChannelMap.erase(iter);
+    if(iter!=pvaClientChannelMap.end()) {
+        throw std::runtime_error("pvaClientChannelCache::addChannel channel already cached");
+    }
+    pvaClientChannelMap.insert(std::pair<string,PvaClientChannelPtr>(
+         name,pvaClientChannel));
 }
 
 void PvaClientChannelCache::showCache()
@@ -127,10 +77,8 @@ void PvaClientChannelCache::showCache()
          string channelName = channel->getChannelName();
          string providerName = channel->getProvider()->getProviderName();
          cout << "channel " << channelName << " provider " << providerName << endl;
-         cout << "  get and put cacheSize " << pvaChannel->cacheSize() << endl;
          pvaChannel->showCache();
-    }
-    
+    } 
 }
 
 size_t PvaClientChannelCache::cacheSize()
@@ -139,35 +87,60 @@ size_t PvaClientChannelCache::cacheSize()
 
 }
 
-using namespace epics::pvaClient::pvaClientPvt;
+bool PvaClient::debug = false;
 
-PvaClientPtr PvaClient::create()
+PvaClientPtr PvaClient::get(std::string const & providerNames)
 {
-    PvaClientPtr xx(new PvaClient());
-    StartStopClientFactory::PvaClientBeingConstructed();
-    return xx;
+    static  PvaClientPtr master;
+    static Mutex mutex;
+    Lock xx(mutex);
+    if(!master) {
+        master = PvaClientPtr(new PvaClient(providerNames));
+    }
+    return master;
 }
 
 
-PvaClient::PvaClient()
-:   pvaClientChannelCache(new PvaClientChannelCache()),
-    isDestroyed(false)
+PvaClient::PvaClient(std::string const & providerNames)
+:  pvaClientChannelCache(new PvaClientChannelCache()),
+   pvaStarted(false),
+   caStarted(false)
 {
+    stringstream ss(providerNames);
+    string providerName;
+    while (getline(ss, providerName, ' '))
+    {
+         ChannelProviderRegistry::shared_pointer registry(getChannelProviderRegistry());
+         if(providerName=="pva") {
+             ClientFactory::start();
+             pvaStarted = true;
+         } else if(providerName=="ca") {
+             CAClientFactory::start();
+             caStarted = true;
+         } else {
+             if(!registry->getProvider(providerName)) {
+                  cerr << "PvaClient::get provider " << providerName  << " not known" << endl;
+             }
+         }
+    }
 }
 
 PvaClient::~PvaClient() {
-    destroy();
-}
-
-void PvaClient::destroy()
-{
-    {
-        Lock xx(mutex);
-        if(isDestroyed) return;
-        isDestroyed = true;
+    if(PvaClient::debug) {
+        cout<< "PvaClient::~PvaClient()\n"
+            << "pvaChannel cache:\n";
+        showCache();
+    }
+    if(pvaStarted){
+        if(PvaClient::debug) cout<< "calling ClientFactory::stop()\n";
+        ClientFactory::stop();
+        if(PvaClient::debug) cout<< "after calling ClientFactory::stop()\n";
+    }
+    if(caStarted) {
+        if(PvaClient::debug) cout<< "calling CAClientFactory::stop()\n";
+        CAClientFactory::stop();
+        if(PvaClient::debug) cout<< "after calling CAClientFactory::stop()\n";
     }
-    pvaClientChannelCache.reset();
-    StartStopClientFactory::PvaClientBeingDestroyed();
 }
 
 string PvaClient:: getRequesterName()
@@ -208,7 +181,7 @@ PvaClientChannelPtr PvaClient::channel(
 
 PvaClientChannelPtr PvaClient::createChannel(string const & channelName, string const & providerName)
 {
-     return PvaClientChannel::create(getPtrSelf(),channelName,providerName);
+     return PvaClientChannel::create(shared_from_this(),channelName,providerName);
 }
 
 void PvaClient::setRequester(RequesterPtr const & requester)
@@ -218,12 +191,16 @@ void PvaClient::setRequester(RequesterPtr const & requester)
 
 void PvaClient::clearRequester()
 {
-    requester = Requester::weak_pointer();
+    requester.reset();
 }
 
 void PvaClient::showCache()
 {
-    pvaClientChannelCache->showCache();
+    if(pvaClientChannelCache->cacheSize()>=1) {
+        pvaClientChannelCache->showCache();
+    } else {
+         cout << "pvaClientChannelCache is empty\n";
+    }
 }
 
 

src/pvaClientChannel.cpp

@@ -8,14 +8,15 @@
  * @author mrk
  * @date 2015.02
  */
-#define epicsExportSharedSymbols
 
 #include <map>
 #include <pv/event.h>
 #include <pv/lock.h>
-#include <pv/pvaClient.h>
 #include <pv/createRequest.h>
 
+#define epicsExportSharedSymbols
+
+#include <pv/pvaClient.h>
 
 using std::tr1::static_pointer_cast;
 using namespace epics::pvData;
@@ -25,13 +26,13 @@ using namespace std;
 namespace epics { namespace pvaClient {
 
 
-class PvaClientGetCache
+class epicsShareClass PvaClientGetCache
 {
 public:
     PvaClientGetCache(){}
-    ~PvaClientGetCache();
-    void destroy() {
-       pvaClientGetMap.clear();
+    ~PvaClientGetCache()
+    {
+        if(PvaClient::getDebug()) cout << "PvaClientGetCache::~PvaClientGetCache\n";
     }
     PvaClientGetPtr getGet(string const & request);
     void addGet(string const & request,PvaClientGetPtr const & pvaClientGet);
@@ -41,11 +42,6 @@ private:
     map<string,PvaClientGetPtr> pvaClientGetMap;
 };
 
-PvaClientGetCache::~PvaClientGetCache()
-{
-    destroy();
-}
-
 PvaClientGetPtr PvaClientGetCache::getGet(string const & request)
 {
     map<string,PvaClientGetPtr>::iterator iter = pvaClientGetMap.find(request);
@@ -55,8 +51,11 @@ PvaClientGetPtr PvaClientGetCache::getGet(string const & request)
 
 void PvaClientGetCache::addGet(string const & request,PvaClientGetPtr const & pvaClientGet)
 {
-     pvaClientGetMap.insert(std::pair<string,PvaClientGetPtr>(
-         request,pvaClientGet));
+     map<string,PvaClientGetPtr>::iterator iter = pvaClientGetMap.find(request);
+     if(iter!=pvaClientGetMap.end()) {
+         throw std::runtime_error("pvaClientGetCache::addGet pvaClientGet already cached");
+     }
+     pvaClientGetMap.insert(std::pair<string,PvaClientGetPtr>(request,pvaClientGet));
 }
 
 void PvaClientGetCache::showCache()
@@ -74,13 +73,13 @@ size_t PvaClientGetCache::cacheSize()
 
 }
 
-class PvaClientPutCache
+class epicsShareClass PvaClientPutCache
 {
 public:
     PvaClientPutCache(){}
-    ~PvaClientPutCache();
-    void destroy() {
-       pvaClientPutMap.clear();
+    ~PvaClientPutCache()
+    {
+         if(PvaClient::getDebug()) cout << "PvaClientPutCache::~PvaClientPutCache\n";
     }
     PvaClientPutPtr getPut(string const & request);
     void addPut(string const & request,PvaClientPutPtr const & pvaClientPut);
@@ -90,10 +89,6 @@ private:
     map<string,PvaClientPutPtr> pvaClientPutMap;
 };
 
-PvaClientPutCache::~PvaClientPutCache()
-{
-    destroy();
-}
 
 PvaClientPutPtr PvaClientPutCache::getPut(string const & request)
 {
@@ -104,6 +99,10 @@ PvaClientPutPtr PvaClientPutCache::getPut(string const & request)
 
 void PvaClientPutCache::addPut(string const & request,PvaClientPutPtr const & pvaClientPut)
 {
+     map<string,PvaClientPutPtr>::iterator iter = pvaClientPutMap.find(request);
+     if(iter!=pvaClientPutMap.end()) {
+         throw std::runtime_error("pvaClientPutCache::addPut pvaClientPut already cached");
+     }
      pvaClientPutMap.insert(std::pair<string,PvaClientPutPtr>(
          request,pvaClientPut));
 }
@@ -123,30 +122,63 @@ size_t PvaClientPutCache::cacheSize()
 
 }
 
-class ChannelRequesterImpl : public ChannelRequester
+class epicsShareClass ChannelRequesterImpl : public ChannelRequester
 {
-     PvaClientChannel *pvaClientChannel;
+    PvaClientChannel::weak_pointer pvaClientChannel;
+    PvaClient::weak_pointer pvaClient;
 public:
-     ChannelRequesterImpl(PvaClientChannel *pvaClientChannel)
-     : pvaClientChannel(pvaClientChannel) {}
-    void channelCreated(
-        const Status& status,
-        Channel::shared_pointer const & channel)
-    { pvaClientChannel->channelCreated(status,channel); }
-    void channelStateChange(
-        Channel::shared_pointer const & channel,
-        Channel::ConnectionState connectionState)
-    {pvaClientChannel->channelStateChange(channel,connectionState);}
-    tr1::shared_ptr<Channel> getChannel() {return pvaClientChannel->getChannel();}
-    string getRequesterName()
-    {return pvaClientChannel->getRequesterName();}
-    void message(
-        string const & message,
-        MessageType messageType)
-    { pvaClientChannel->message(message,messageType); }
-    void destroy() {pvaClientChannel->destroy();}
+    ChannelRequesterImpl(
+        PvaClientChannelPtr const & pvaClientChannel,
+        PvaClientPtr const &pvaClient)
+    : pvaClientChannel(pvaClientChannel),
+      pvaClient(pvaClient)
+    {}
+    virtual ~ChannelRequesterImpl() {
+        if(PvaClient::getDebug()) std::cout << "~ChannelRequesterImpl" << std::endl;
+    }
+
+    virtual std::string getRequesterName() {
+        PvaClientChannelPtr clientChannel(pvaClientChannel.lock());
+        if(!clientChannel) return string("clientChannel is null");
+        return clientChannel->getRequesterName();
+    }
+
+    virtual void message(std::string const & message, epics::pvData::MessageType messageType) {
+        PvaClientChannelPtr clientChannel(pvaClientChannel.lock());
+        if(!clientChannel) return;
+        clientChannel->message(message,messageType);
+    }
+
+    virtual void channelCreated(
+         const epics::pvData::Status& status,
+         Channel::shared_pointer const & channel)
+    {
+        PvaClientChannelPtr clientChannel(pvaClientChannel.lock());
+        if(!clientChannel) return;
+        clientChannel->channelCreated(status,channel);
+    }
+
+    virtual void channelStateChange(
+          Channel::shared_pointer const & channel,
+          Channel::ConnectionState connectionState)
+    {
+        PvaClientChannelPtr clientChannel(pvaClientChannel.lock());
+        if(!clientChannel) return;
+        clientChannel->channelStateChange(channel,connectionState);
+    }
 };
 
+PvaClientChannelPtr PvaClientChannel::create(
+   PvaClientPtr const &pvaClient,
+   string const & channelName,
+   string const & providerName)
+{
+    PvaClientChannelPtr channel(new PvaClientChannel(pvaClient,channelName,providerName));
+    channel->channelRequester = ChannelRequesterImplPtr(
+        new ChannelRequesterImpl(channel,pvaClient));
+    return channel;
+}
+
 
 PvaClientChannel::PvaClientChannel(
     PvaClientPtr const &pvaClient,
@@ -156,44 +188,81 @@ PvaClientChannel::PvaClientChannel(
   channelName(channelName),
   providerName(providerName),
   connectState(connectIdle),
-  isDestroyed(false),
   createRequest(CreateRequest::create()),
   pvaClientGetCache(new PvaClientGetCache()),
   pvaClientPutCache(new PvaClientPutCache())
-{}
+{
+    if(PvaClient::getDebug()) {
+        cout << "PvaClientChannel::PvaClientChannel channelName " << channelName << endl;
+    }
+}
 
 PvaClientChannel::~PvaClientChannel()
 {
-    destroy();
+    if(PvaClient::getDebug()) {
+        cout  << "PvaClientChannel::~PvaClientChannel() "
+             << " channelName " << channelName
+            << endl;
+    }
+    if(PvaClient::getDebug()) showCache();
 }
 
 void PvaClientChannel::channelCreated(const Status& status, Channel::shared_pointer const & channel)
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientChannel was destroyed");
-    if(status.isOK()) {
-        this->channel = channel;
-        return;
+    if(PvaClient::getDebug()) {
+        cout << "PvaClientChannel::channelCreated"
+           << " channelName " << channelName
+           << " connectState " << connectState
+           << " isConnected " << (channel->isConnected() ? "true" : "false")
+           << " status.isOK " << (status.isOK() ? "true" : "false")
+           << endl;
+    }
+    Lock xx(mutex);
+    if(connectState==connected) return;
+    if(connectState!=connectActive) {
+         string message("PvaClientChannel::channelCreated");
+         message += " channel " + channelName
+                 + " why was this called when connectState!=ConnectState.connectActive";
+         throw std::runtime_error(message);
+    }
+    if(!status.isOK()) {
+        string message("PvaClientChannel::channelCreated");
+            + " status " +  status.getMessage() + " why??";
+        throw std::runtime_error(message);
+    }
+    if(channel->isConnected()) {
+        connectState = connected; 
+        waitForConnect.signal();
     }
-    cout << "PvaClientChannel::channelCreated status " << status.getMessage() << " why??\n";
 }
 
 void PvaClientChannel::channelStateChange(
     Channel::shared_pointer const & channel,
     Channel::ConnectionState connectionState)
 {
+    if(PvaClient::getDebug()) {
+        cout << " PvaClientChannel::channelStateChange "
+        << " channelName " << channelName
+        << " " << Channel::ConnectionStateNames[connectionState]
+        << endl;
+    }
+    PvaClientChannelStateChangeRequesterPtr req(stateChangeRequester.lock());
+    if(req) {
+         bool value = (connectionState==Channel::CONNECTED ? true :  false);
+         req->channelStateChange(shared_from_this(),value);
+    }
+   
     Lock xx(mutex);
-    if(isDestroyed) return;
     bool waitingForConnect = false;
     if(connectState==connectActive) waitingForConnect = true;
     if(connectionState!=Channel::CONNECTED) {
          string mess(channelName +
              " connection state " + Channel::ConnectionStateNames[connectionState]);
-         message(mess,errorMessage);
-         channelConnectStatus = Status(Status::STATUSTYPE_ERROR,mess);
-         connectState = notConnected;
+             message(mess,errorMessage);
+             connectState = notConnected;
+         return;
     } else {
-         connectState = connected;
-         channelConnectStatus = Status::Ok;
+        connectState = connected;
     }
     if(waitingForConnect) waitForConnect.signal();
 }
@@ -201,7 +270,7 @@ void PvaClientChannel::channelStateChange(
 string PvaClientChannel::getRequesterName()
 {
     PvaClientPtr yyy = pvaClient.lock();
-    if(!yyy) throw std::runtime_error("PvaClient was destroyed");
+    if(!yyy) return string("PvaClientChannel::getRequesterName() PvaClient isDestroyed");
     return yyy->getRequesterName();
 }
 
@@ -209,82 +278,87 @@ void PvaClientChannel::message(
     string const & message,
     MessageType messageType)
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientChannel was destroyed");
     PvaClientPtr yyy = pvaClient.lock();
-    if(!yyy) throw std::runtime_error("PvaClient was destroyed");
+    if(!yyy) return;
     yyy->message(channelName + " " + message, messageType);
 }
 
-void PvaClientChannel::destroy()
-{
-    {
-        Lock xx(mutex);
-        if(isDestroyed) return;
-        isDestroyed = true;
-    }
-    if(channel) channel->destroy();
-    channel.reset();
-    pvaClientGetCache.reset();
-    pvaClientPutCache.reset();
-}
-
 string PvaClientChannel::getChannelName()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientChannel was destroyed");
     return channelName;
 }
 
 Channel::shared_pointer PvaClientChannel::getChannel()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientChannel was destroyed");
     return channel;
 }
 
+void PvaClientChannel::setStateChangeRequester(
+    PvaClientChannelStateChangeRequesterPtr const & stateChangeRequester)
+{
+    this->stateChangeRequester = stateChangeRequester;
+}
+
 void PvaClientChannel::connect(double timeout)
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientChannel was destroyed");
+    if(PvaClient::getDebug()) {
+        cout << "PvaClientChannel::connect"
+        << " channelName " << channelName << endl;
+    }
     issueConnect();
     Status status = waitConnect(timeout);
     if(status.isOK()) return;
-    string message = string("channel ") + getChannelName() 
+    if(PvaClient::getDebug()) cout << "PvaClientChannel::connect  waitConnect failed\n";
+    string message = string("channel ") + channelName 
                     + " PvaClientChannel::connect " + status.getMessage();
     throw std::runtime_error(message);
 }
 
 void PvaClientChannel::issueConnect()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientChannel was destroyed");
-    if(connectState!=connectIdle) {
-       throw std::runtime_error("pvaClientChannel already connected");
+    if(PvaClient::getDebug()) {
+        cout << "PvaClientChannel::issueConnect"
+        << " channelName " << channelName << endl;
+    }
+    {
+        Lock xx(mutex);
+        if(connectState==connected) return;
+        if(connectState!=connectIdle) {
+           throw std::runtime_error("pvaClientChannel already connected");
+        }
+        connectState = connectActive;
     }
-    channelRequester = ChannelRequester::shared_pointer(new ChannelRequesterImpl(this));
-
-    channelConnectStatus = Status(
-           Status::STATUSTYPE_ERROR,
-           getChannelName() + " createChannel failed");
-    connectState = connectActive;
     ChannelProviderRegistry::shared_pointer reg = getChannelProviderRegistry();
     ChannelProvider::shared_pointer provider = reg->getProvider(providerName);
     if(!provider) {
-        throw std::runtime_error(getChannelName() + " provider " + providerName + " not registered");
+        throw std::runtime_error(channelName + " provider " + providerName + " not registered");
     }
+    if(PvaClient::getDebug()) cout << "PvaClientChannel::issueConnect calling provider->createChannel\n";
     channel = provider->createChannel(channelName,channelRequester,ChannelProvider::PRIORITY_DEFAULT);
     if(!channel) {
-         throw std::runtime_error(getChannelName() + " channelCreate failed ");
+         throw std::runtime_error(channelName + " channelCreate failed ");
     }
 }
 
 Status PvaClientChannel::waitConnect(double timeout)
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientChannel was destroyed");
-    waitForConnect.wait(timeout);
-    return channelConnectStatus;
+    if(PvaClient::getDebug()) {
+        cout << "PvaClientChannel::waitConnect"
+        << " channelName " << channelName << endl;
+    }
+    {
+        Lock xx(mutex);
+        if(channel->isConnected()) return Status::Ok;
+    }
+    if(timeout>0.0) {
+        waitForConnect.wait(timeout);
+    } else {
+        waitForConnect.wait();
+    }
+    if(channel->isConnected()) return Status::Ok;
+    return Status(Status::STATUSTYPE_ERROR,channelName + " not connected");
 }
 
-PvaClientFieldPtr PvaClientChannel::createField()
-{
-    return createField("");
-}
 
 PvaClientFieldPtr PvaClientChannel::createField(string const & subField)
 {
@@ -292,16 +366,11 @@ PvaClientFieldPtr PvaClientChannel::createField(string const & subField)
     throw std::runtime_error("PvaClientChannel::createField not implemented");
 }
 
-PvaClientProcessPtr PvaClientChannel::createProcess()
-{
-    return createProcess("");
-}
-
 PvaClientProcessPtr PvaClientChannel::createProcess(string const & request)
 {
     PVStructurePtr pvRequest = createRequest->createRequest(request);
     if(!pvRequest) {
-        string message = string("channel ") + getChannelName() 
+        string message = string("channel ") + channelName 
             + " PvaClientChannel::createProcess invalid pvRequest: "
             + createRequest->getMessage();
         throw std::runtime_error(message);
@@ -317,7 +386,6 @@ PvaClientProcessPtr PvaClientChannel::createProcess(PVStructurePtr const &  pvRe
     return PvaClientProcess::create(yyy,channel,pvRequest);
 }
 
-PvaClientGetPtr PvaClientChannel::get() {return get("value,alarm,timeStamp");}
 
 PvaClientGetPtr PvaClientChannel::get(string const & request)
 {
@@ -329,16 +397,12 @@ PvaClientGetPtr PvaClientChannel::get(string const & request)
     return pvaClientGet;
 }
 
-PvaClientGetPtr PvaClientChannel::createGet()
-{
-    return PvaClientChannel::createGet("value,alarm,timeStamp");
-}
 
 PvaClientGetPtr PvaClientChannel::createGet(string const & request)
 {
     PVStructurePtr pvRequest = createRequest->createRequest(request);
     if(!pvRequest) {
-        string message = string("channel ") + getChannelName() 
+        string message = string("channel ") + channelName 
             + " PvaClientChannel::createGet invalid pvRequest: "
             + createRequest->getMessage();
         throw std::runtime_error(message);
@@ -354,7 +418,6 @@ PvaClientGetPtr PvaClientChannel::createGet(PVStructurePtr const &  pvRequest)
     return PvaClientGet::create(yyy,channel,pvRequest);
 }
 
-PvaClientPutPtr PvaClientChannel::put() {return put("value");}
 
 PvaClientPutPtr PvaClientChannel::put(string const & request)
 {
@@ -367,16 +430,12 @@ PvaClientPutPtr PvaClientChannel::put(string const & request)
     return pvaClientPut;
 }
 
-PvaClientPutPtr PvaClientChannel::createPut()
-{
-    return createPut("value");
-}
 
 PvaClientPutPtr PvaClientChannel::createPut(string const & request)
 {
     PVStructurePtr pvRequest = createRequest->createRequest(request);
     if(!pvRequest) {
-        string message = string("channel ") + getChannelName() 
+        string message = string("channel ") + channelName 
             + " PvaClientChannel::createPut invalid pvRequest: "
             + createRequest->getMessage();
         throw std::runtime_error(message);
@@ -392,16 +451,11 @@ PvaClientPutPtr PvaClientChannel::createPut(PVStructurePtr const & pvRequest)
     return PvaClientPut::create(yyy,channel,pvRequest);
 }
 
-PvaClientPutGetPtr PvaClientChannel::createPutGet()
-{
-    return createPutGet("putField(argument)getField(result)");
-}
-
 PvaClientPutGetPtr PvaClientChannel::createPutGet(string const & request)
 {
     PVStructurePtr pvRequest = createRequest->createRequest(request);
     if(!pvRequest) {
-        string message = string("channel ") + getChannelName() 
+        string message = string("channel ") + channelName 
             + " PvaClientChannel::createPutGet invalid pvRequest: "
             + createRequest->getMessage();
         throw std::runtime_error(message);
@@ -418,16 +472,12 @@ PvaClientPutGetPtr PvaClientChannel::createPutGet(PVStructurePtr const & pvReque
 }
 
 
-PvaClientArrayPtr PvaClientChannel::createArray()
-{
-    return createArray("value");
-}
 
 PvaClientArrayPtr PvaClientChannel::createArray(string const & request)
 {
     PVStructurePtr pvRequest = createRequest->createRequest(request);
     if(!pvRequest) {
-        string message = string("channel ") + getChannelName() 
+        string message = string("channel ") + channelName 
             + " PvaClientChannel::createArray invalid pvRequest: "
             + createRequest->getMessage();
         throw std::runtime_error(message);
@@ -442,8 +492,6 @@ PvaClientArrayPtr PvaClientChannel::createArray(PVStructurePtr const &  pvReques
 }
 
 
-PvaClientMonitorPtr PvaClientChannel::monitor() {return monitor("value,alarm,timeStamp");}
-
 PvaClientMonitorPtr PvaClientChannel::monitor(string const & request)
 {
     PvaClientMonitorPtr pvaClientMonitor = createMonitor(request);
@@ -454,7 +502,7 @@ PvaClientMonitorPtr PvaClientChannel::monitor(string const & request)
 
 PvaClientMonitorPtr PvaClientChannel::monitor(PvaClientMonitorRequesterPtr const & pvaClientMonitorRequester)
 {
-      return monitor("value,alarm,timeStamp",pvaClientMonitorRequester);
+      return monitor("field(value,alarm,timeStamp)",pvaClientMonitorRequester);
 }
 
 PvaClientMonitorPtr PvaClientChannel::monitor(string const & request,
@@ -467,16 +515,11 @@ PvaClientMonitorPtr PvaClientChannel::monitor(string const & request,
     return pvaClientMonitor;
 }
 
-PvaClientMonitorPtr PvaClientChannel::createMonitor()
-{
-    return createMonitor("value,alarm,timeStamp");
-}
-
 PvaClientMonitorPtr PvaClientChannel::createMonitor(string const & request)
 {
     PVStructurePtr pvRequest = createRequest->createRequest(request);
     if(!pvRequest) {
-        string message = string("channel ") + getChannelName() 
+        string message = string("channel ") + channelName 
             + " PvaClientChannel::createMonitor invalid pvRequest: "
             + createRequest->getMessage();
         throw std::runtime_error(message);
@@ -492,12 +535,52 @@ PvaClientMonitorPtr  PvaClientChannel::createMonitor(PVStructurePtr const &  pvR
     return PvaClientMonitor::create(yyy,channel,pvRequest);
 }
 
+PVStructurePtr PvaClientChannel::rpc(
+    PVStructurePtr const &  pvRequest,
+    PVStructurePtr const & pvArgument)
+{
+    
+    PvaClientRPCPtr rpc = createRPC(pvRequest);
+    return rpc->request(pvArgument);
+}
+
+PVStructurePtr PvaClientChannel::rpc(
+    PVStructurePtr const & pvArgument)
+{
+    PvaClientRPCPtr rpc = createRPC();
+    return rpc->request(pvArgument);
+}
+
+PvaClientRPCPtr PvaClientChannel::createRPC()
+{
+    if(connectState!=connected) connect(5.0);
+    PvaClientPtr yyy = pvaClient.lock();
+    if(!yyy) throw std::runtime_error("PvaClient was destroyed");
+    return PvaClientRPC::create(yyy,channel);
+}
+
+PvaClientRPCPtr PvaClientChannel::createRPC(PVStructurePtr const &  pvRequest)
+{
+    if(connectState!=connected) connect(5.0);
+    PvaClientPtr yyy = pvaClient.lock();
+    if(!yyy) throw std::runtime_error("PvaClient was destroyed");
+    return PvaClientRPC::create(yyy,channel,pvRequest);
+}
+
 void PvaClientChannel::showCache()
 {
-     cout << "    pvaClientGet" << endl;
-     pvaClientGetCache->showCache();
-     cout << "    pvaClientPut" << endl;
-     pvaClientPutCache->showCache();
+     if(pvaClientGetCache->cacheSize()>=1) {
+         cout << "    pvaClientGet cache" << endl;
+         pvaClientGetCache->showCache();
+     } else {
+         cout << "    pvaClientGet cache is empty\n";
+     }
+     if(pvaClientPutCache->cacheSize()>=1) {
+         cout << "    pvaClientPut cache" << endl;
+         pvaClientPutCache->showCache();
+     } else {
+        cout << "    pvaClientPut cache is empty\n";
+     }
 }
 
 size_t PvaClientChannel::cacheSize()
@@ -506,13 +589,5 @@ size_t PvaClientChannel::cacheSize()
 }
 
 
-PvaClientChannelPtr PvaClientChannel::create(
-   PvaClientPtr const &pvaClient,
-   string const & channelName,
-   string const & providerName)
-{
-    PvaClientChannelPtr channel(new PvaClientChannel(pvaClient,channelName,providerName));
-    return channel;
-}
 
 }}

src/pvaClientGet.cpp

@@ -8,9 +8,11 @@
  * @author mrk
  * @date 2015.02
  */
-#define epicsExportSharedSymbols
 
 #include <pv/event.h>
+
+#define epicsExportSharedSymbols
+
 #include <pv/pvaClient.h>
 
 using std::tr1::static_pointer_cast;
@@ -20,30 +22,67 @@ using namespace std;
 
 namespace epics { namespace pvaClient {
 
-
 class ChannelGetRequesterImpl : public ChannelGetRequester
 {
-    PvaClientGet * pvaClientGet;
+    PvaClientGet::weak_pointer pvaClientGet;
+    PvaClient::weak_pointer pvaClient;
 public:
-    ChannelGetRequesterImpl(PvaClientGet * pvaClientGet)
-    : pvaClientGet(pvaClientGet) {}
-    string getRequesterName()
-    {return pvaClientGet->getRequesterName();}
-    void message(string const & message,MessageType messageType)
-    {pvaClientGet->message(message,messageType);}
-    void channelGetConnect(
+    ChannelGetRequesterImpl(
+        PvaClientGetPtr const & pvaClientGet,
+        PvaClientPtr const &pvaClient)
+    : pvaClientGet(pvaClientGet),
+      pvaClient(pvaClient)
+    {}
+    virtual ~ChannelGetRequesterImpl() {
+        if(PvaClient::getDebug()) std::cout << "~ChannelGetRequesterImpl" << std::endl;
+    }
+
+    virtual std::string getRequesterName() {
+        PvaClientGetPtr clientGet(pvaClientGet.lock());
+        if(!clientGet) return string("clientGet is null");
+        return clientGet->getRequesterName();
+    }
+
+    virtual void message(std::string const & message, epics::pvData::MessageType messageType) {
+        PvaClientGetPtr clientGet(pvaClientGet.lock());
+        if(!clientGet) return;
+        clientGet->message(message,messageType);
+    }
+
+    virtual void channelGetConnect(
         const Status& status,
         ChannelGet::shared_pointer const & channelGet,
-        StructureConstPtr const & structure)
-    {pvaClientGet->channelGetConnect(status,channelGet,structure);}
-    void getDone(
+        Structure::const_shared_pointer const & structure)
+    {
+        PvaClientGetPtr clientGet(pvaClientGet.lock());
+        if(!clientGet) return;
+        clientGet->channelGetConnect(status,channelGet,structure);  
+    }
+
+    virtual void getDone(
         const Status& status,
         ChannelGet::shared_pointer const & channelGet,
         PVStructurePtr const & pvStructure,
-        BitSetPtr const & bitSet)
-    {pvaClientGet->getDone(status,channelGet,pvStructure,bitSet);}
+        BitSet::shared_pointer const & bitSet)
+    {
+        PvaClientGetPtr clientGet(pvaClientGet.lock());
+        if(!clientGet) return;
+        clientGet->getDone(status,channelGet,pvStructure,bitSet);
+    }
 };
 
+PvaClientGetPtr PvaClientGet::create(
+        PvaClientPtr const &pvaClient,
+        Channel::shared_pointer const & channel,
+        PVStructurePtr const &pvRequest)
+{
+    PvaClientGetPtr epv(new PvaClientGet(pvaClient,channel,pvRequest));
+    epv->channelGetRequester = ChannelGetRequesterImplPtr(
+        new ChannelGetRequesterImpl(epv,pvaClient));
+    return epv;
+}
+
+
 PvaClientGet::PvaClientGet(
         PvaClientPtr const &pvaClient,
         Channel::shared_pointer const & channel,
@@ -51,20 +90,31 @@ PvaClientGet::PvaClientGet(
 : pvaClient(pvaClient),
   channel(channel),
   pvRequest(pvRequest),
-  isDestroyed(false),
   connectState(connectIdle),
   getState(getIdle)
 {
+     if(PvaClient::getDebug()) {
+        cout << "PvaClientGet::PvaClientGet::PvaClientGet"
+           << " channelName " << channel->getChannelName()
+           << endl;
+    }
 }
 
 PvaClientGet::~PvaClientGet()
 {
-    destroy();
+    if(PvaClient::getDebug()) {
+        string channelName("disconnected");
+        Channel::shared_pointer chan(channel.lock());
+        if(chan) channelName = chan->getChannelName();
+         cout<< "PvaClientGet::~PvaClientGet"
+           << " channelName " << channelName
+           << endl;
+    }
+    if(channelGet) channelGet->destroy();
 }
 
 void PvaClientGet::checkGetState()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientGet was destroyed");
     if(connectState==connectIdle) connect();
     if(getState==getIdle) get();
 }
@@ -72,16 +122,15 @@ void PvaClientGet::checkGetState()
 // from ChannelGetRequester
 string PvaClientGet::getRequesterName()
 {
-     PvaClientPtr yyy = pvaClient.lock();
-     if(!yyy) throw std::runtime_error("pvaClient was destroyed");
-     return yyy->getRequesterName();
+    PvaClientPtr yyy = pvaClient.lock();
+    if(!yyy) return string("PvaClientGet::getRequesterName PvaClient isDestroyed");
+    return yyy->getRequesterName();
 }
 
 void PvaClientGet::message(string const & message,MessageType messageType)
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientGet was destroyed");
     PvaClientPtr yyy = pvaClient.lock();
-    if(!yyy) throw std::runtime_error("pvaClient was destroyed");
+    if(!yyy) return;
     yyy->message(message, messageType);
 }
 
@@ -90,13 +139,24 @@ void PvaClientGet::channelGetConnect(
     ChannelGet::shared_pointer const & channelGet,
     StructureConstPtr const & structure)
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientGet was destroyed");
-    channelGetConnectStatus = status;
-    this->channelGet = channelGet;
-    if(status.isOK()) {
-        pvaClientData = PvaClientGetData::create(structure);
-        pvaClientData->setMessagePrefix(channel->getChannelName());
+    if(PvaClient::getDebug()) {
+        string channelName("disconnected");
+        Channel::shared_pointer chan(channel.lock());
+        if(chan) channelName = chan->getChannelName();
+        cout << "PvaClientGet::channelGetConnect"
+           << " channelName " << channelName
+           << " status.isOK " << (status.isOK() ? "true" : "false")
+           << endl;
+    }
+    {
+        Lock xx(mutex);
+        channelGetConnectStatus = status;
         connectState = connected;
+        this->channelGet = channelGet;
+        if(status.isOK()) {
+            pvaClientData = PvaClientGetData::create(structure);
+            pvaClientData->setMessagePrefix(channelGet->getChannel()->getChannelName());
+        }
     }
     waitForConnect.signal();
     
@@ -108,82 +168,99 @@ void PvaClientGet::getDone(
     PVStructurePtr const & pvStructure,
     BitSetPtr const & bitSet)
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientGet was destroyed");
-    channelGetStatus = status;
-    if(status.isOK()) {
-        pvaClientData->setData(pvStructure,bitSet);
+    if(PvaClient::getDebug()) {
+        string channelName("disconnected");
+        Channel::shared_pointer chan(channel.lock());
+        if(chan) channelName = chan->getChannelName();
+        cout << "PvaClientGet::getDone"
+           << " channelName " << channelName
+           << " status.isOK " << (status.isOK() ? "true" : "false")
+           << endl;
+    }
+    {
+        Lock xx(mutex);
+        channelGetStatus = status;
+        if(status.isOK()) {
+            pvaClientData->setData(pvStructure,bitSet);
+        }
     }
     waitForGet.signal();
 }
 
-
-// from PvaClientGet
-void PvaClientGet::destroy()
-{
-    {
-        Lock xx(mutex);
-        if(isDestroyed) return;
-        isDestroyed = true;
-    }
-    if(channelGet) channelGet->destroy();
-    channelGet.reset();
-}
-
 void PvaClientGet::connect()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientGet was destroyed");
     issueConnect();
     Status status = waitConnect();
     if(status.isOK()) return;
-    string message = string("channel ") + channel->getChannelName() 
+    Channel::shared_pointer chan(channel.lock());
+    string channelName("disconnected");
+    if(chan) channelName = chan->getChannelName();
+    string message = string("channel ") + channelName 
          + " PvaClientGet::connect " + status.getMessage();
     throw std::runtime_error(message);
 }
 
 void PvaClientGet::issueConnect()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientGet was destroyed");
+    Channel::shared_pointer chan(channel.lock());
     if(connectState!=connectIdle) {
-        string message = string("channel ") + channel->getChannelName() 
+        string channelName("disconnected");
+        if(chan) channelName = chan->getChannelName();
+        string message = string("channel ") + channelName
             + " pvaClientGet already connected ";
         throw std::runtime_error(message);
     }
-    getRequester = ChannelGetRequester::shared_pointer(new ChannelGetRequesterImpl(this));
-    connectState = connectActive;
-    channelGet = channel->createChannelGet(getRequester,pvRequest);
+    if(chan) {
+        connectState = connectActive;
+        channelGet = chan->createChannelGet(channelGetRequester,pvRequest);
+        return;
+    }
+    throw std::runtime_error("PvaClientGet::issueConnect channel was destroyed");
 }
 
 Status PvaClientGet::waitConnect()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientGet was destroyed");
-    if(connectState==connected) return channelGetConnectStatus;
-    if(connectState!=connectActive) {
-        string message = string("channel ") + channel->getChannelName() 
-            + " pvaClientGet illegal connect state ";
-        throw std::runtime_error(message);
+    {
+        Lock xx(mutex);
+        if(connectState==connected) {
+             if(!channelGetConnectStatus.isOK()) connectState = connectIdle;
+             return channelGetConnectStatus;
+        }
+        if(connectState!=connectActive) {
+            Channel::shared_pointer chan(channel.lock());
+            string channelName("disconnected");
+            if(chan) channelName = chan->getChannelName();
+            string message = string("channel ") + channelName
+                + " PvaClientGet::waitConnect illegal connect state ";
+            throw std::runtime_error(message);
+        }
     }
     waitForConnect.wait();
-    connectState = channelGetConnectStatus.isOK() ? connected : connectIdle;
+    if(!channelGetConnectStatus.isOK()) connectState = connectIdle;
     return channelGetConnectStatus;
 }
 
 void PvaClientGet::get()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientGet was destroyed");
     issueGet();
     Status status = waitGet();
     if(status.isOK()) return;
-    string message = string("channel ") + channel->getChannelName() 
+    Channel::shared_pointer chan(channel.lock());
+    string channelName("disconnected");
+    if(chan) channelName = chan->getChannelName();
+    string message = string("channel ") + channelName
             + " PvaClientGet::get " + status.getMessage();
     throw std::runtime_error(message);
 }
 
 void PvaClientGet::issueGet()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientGet was destroyed");
     if(connectState==connectIdle) connect();
     if(getState!=getIdle) {
-        string message = string("channel ") + channel->getChannelName() 
+        Channel::shared_pointer chan(channel.lock());
+        string channelName("disconnected");
+        if(chan) channelName = chan->getChannelName();
+        string message = string("channel ") + channelName
             + " PvaClientGet::issueGet get aleady active ";
         throw std::runtime_error(message);
     }
@@ -193,17 +270,23 @@ void PvaClientGet::issueGet()
 
 Status PvaClientGet::waitGet()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientGet was destroyed");
-    if(getState!=getActive){
-        string message = string("channel ") + channel->getChannelName() 
-            + " PvaClientGet::waitGet llegal get state";
-        throw std::runtime_error(message);
+    {
+        Lock xx(mutex);
+        if(getState==getComplete) {
+            getState =getIdle;
+            return channelGetStatus;
+        }
+        if(getState!=getActive){
+            Channel::shared_pointer chan(channel.lock());
+            string channelName("disconnected");
+            if(chan) channelName = chan->getChannelName();
+            string message = string("channel ") + channelName 
+                + " PvaClientGet::waitGet llegal get state";
+            throw std::runtime_error(message);
+        }
     }
     waitForGet.wait();
     getState = getIdle;
-    if(channelGetStatus.isOK()) {
-        return Status::Ok;
-    }
     return channelGetStatus;
 }
 PvaClientGetDataPtr PvaClientGet::getData()
@@ -212,13 +295,5 @@ PvaClientGetDataPtr PvaClientGet::getData()
     return pvaClientData;
 }
 
-PvaClientGetPtr PvaClientGet::create(
-        PvaClientPtr const &pvaClient,
-        Channel::shared_pointer const & channel,
-        PVStructurePtr const &pvRequest)
-{
-    PvaClientGetPtr epv(new PvaClientGet(pvaClient,channel,pvRequest));
-    return epv;
-}
 
 }}

src/pvaClientGetData.cpp

@@ -8,15 +8,16 @@
  * @author mrk
  * @date 2015.02
  */
-#define epicsExportSharedSymbols
 
 #include <typeinfo>
-
 #include <sstream>
-#include <pv/pvaClient.h>
+
 #include <pv/createRequest.h>
 #include <pv/convert.h>
 
+#define epicsExportSharedSymbols
+
+#include <pv/pvaClient.h>
 
 using std::tr1::static_pointer_cast;
 using namespace epics::pvData;

src/pvaClientMonitor.cpp

@@ -8,44 +8,87 @@
  * @author mrk
  * @date 2015.03
  */
-#define epicsExportSharedSymbols
 
 #include <sstream>
 #include <pv/event.h>
-#include <pv/pvaClient.h>
 #include <pv/bitSetUtil.h>
 
+#define epicsExportSharedSymbols
+
+#include <pv/pvaClient.h>
+
 using std::tr1::static_pointer_cast;
+using std::tr1::dynamic_pointer_cast;
 using namespace epics::pvData;
 using namespace epics::pvAccess;
 using namespace std;
 
 namespace epics { namespace pvaClient {
 
-
-class ChannelMonitorRequester : public MonitorRequester
+class MonitorRequesterImpl : public MonitorRequester
 {
-    PvaClientMonitor * pvaClientMonitor;
+    PvaClientMonitor::weak_pointer pvaClientMonitor;
+    PvaClient::weak_pointer pvaClient;
 public:
-    ChannelMonitorRequester(PvaClientMonitor * pvaClientMonitor)
-    : pvaClientMonitor(pvaClientMonitor) {}
-    string getRequesterName()
-    {return pvaClientMonitor->getRequesterName();}
-    void message(string const & message,MessageType messageType)
-    {pvaClientMonitor->message(message,messageType);}
-    void monitorConnect(
+    MonitorRequesterImpl(
+        PvaClientMonitorPtr const & pvaClientMonitor,
+        PvaClientPtr const &pvaClient)
+    : pvaClientMonitor(pvaClientMonitor),
+      pvaClient(pvaClient)
+    {}
+    virtual ~MonitorRequesterImpl() {
+        if(PvaClient::getDebug()) std::cout << "~MonitorRequesterImpl" << std::endl;
+    }
+
+    virtual std::string getRequesterName() {
+        PvaClientMonitorPtr clientMonitor(pvaClientMonitor.lock());
+        if(!clientMonitor) return string("pvaClientMonitor is null");
+        return clientMonitor->getRequesterName();
+    }
+
+    virtual void message(std::string const & message, epics::pvData::MessageType messageType) {
+        PvaClientMonitorPtr clientMonitor(pvaClientMonitor.lock());
+        if(!clientMonitor) return;
+        clientMonitor->message(message,messageType);
+    }
+
+    virtual void monitorConnect(
         const Status& status,
         Monitor::shared_pointer const & monitor,
-        StructureConstPtr const & structure)
-    {pvaClientMonitor->monitorConnect(status,monitor,structure);}
-    void monitorEvent(MonitorPtr const & monitor)
+        Structure::const_shared_pointer const & structure)
     {
-         pvaClientMonitor->monitorEvent(monitor);
+        PvaClientMonitorPtr clientMonitor(pvaClientMonitor.lock());
+        if(!clientMonitor) return;
+        clientMonitor->monitorConnect(status,monitor,structure);  
+    }
+
+    virtual void unlisten(epics::pvData::MonitorPtr const & monitor)
+    {
+        PvaClientMonitorPtr clientMonitor(pvaClientMonitor.lock());
+        if(!clientMonitor) return;
+        clientMonitor->unlisten(monitor);  
+    }
+
+    virtual void monitorEvent(epics::pvData::MonitorPtr const & monitor)
+    {
+        PvaClientMonitorPtr clientMonitor(pvaClientMonitor.lock());
+        if(!clientMonitor) return;
+        clientMonitor->monitorEvent(monitor);  
     }
-    void unlisten(MonitorPtr const & monitor)
-    {pvaClientMonitor->unlisten();}
 };
 
+
+PvaClientMonitorPtr PvaClientMonitor::create(
+        PvaClientPtr const &pvaClient,
+        Channel::shared_pointer const & channel,
+        PVStructurePtr const &pvRequest)
+{
+    PvaClientMonitorPtr epv(new PvaClientMonitor(pvaClient,channel,pvRequest));
+    epv->monitorRequester = MonitorRequesterImplPtr(
+        new MonitorRequesterImpl(epv,pvaClient));
+    return epv;
+}
+
 PvaClientMonitor::PvaClientMonitor(
         PvaClientPtr const &pvaClient,
         Channel::shared_pointer const & channel,
@@ -53,38 +96,61 @@ PvaClientMonitor::PvaClientMonitor(
 : pvaClient(pvaClient),
   channel(channel),
   pvRequest(pvRequest),
-  isDestroyed(false),
+  isStarted(false),
   connectState(connectIdle),
   userPoll(false),
   userWait(false)
 {
+    if(PvaClient::getDebug()) {
+         cout<< "PvaClientMonitor::PvaClientMonitor()"
+             << " channelName " << channel->getChannelName() 
+             << endl;
+    }
 }
 
 PvaClientMonitor::~PvaClientMonitor()
 {
-    destroy();
+    if(PvaClient::getDebug()) cout<< "PvaClientMonitor::~PvaClientMonitor\n";
+    if(PvaClient::getDebug()) {
+        string channelName("disconnected");
+        Channel::shared_pointer chan(channel.lock());
+        if(chan) channelName = chan->getChannelName();
+        cout<< "PvaClientMonitor::~PvaClientMonitor"
+           << " channelName " << channelName
+           << endl;
+    }
+    if(monitor) {
+       if(isStarted) monitor->stop();
+       monitor->destroy();
+    }
 }
 
 void PvaClientMonitor::checkMonitorState()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientMonitor was destroyed");
+    if(PvaClient::getDebug()) {
+        string channelName("disconnected");
+        Channel::shared_pointer chan(channel.lock());
+        if(chan) channelName = chan->getChannelName();
+        cout << "PvaClientMonitor::checkMonitorState"
+           << " channelName " << channelName
+           << " connectState " << connectState
+           << endl;
+    }
     if(connectState==connectIdle) connect();
-    if(connectState==connected) start();
+    if(connectState==connected && !isStarted) start();
 }
 
-// from MonitorRequester
 string PvaClientMonitor::getRequesterName()
 {
      PvaClientPtr yyy = pvaClient.lock();
-     if(!yyy) throw std::runtime_error("pvaClient was destroyed");
+     if(!yyy) return string("PvaClientMonitor::getRequesterName() PvaClient isDestroyed");
      return yyy->getRequesterName();
 }
 
 void PvaClientMonitor::message(string const & message,MessageType messageType)
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientMonitor was destroyed");
     PvaClientPtr yyy = pvaClient.lock();
-    if(!yyy) throw std::runtime_error("pvaClient was destroyed");
+    if(!yyy) return;
     yyy->message(message, messageType);
 }
 
@@ -93,12 +159,37 @@ void PvaClientMonitor::monitorConnect(
     Monitor::shared_pointer const & monitor,
     StructureConstPtr const & structure)
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientMonitor was destroyed");
+    Channel::shared_pointer chan(channel.lock());
+    if(PvaClient::getDebug()) {
+        string channelName("disconnected");
+        Channel::shared_pointer chan(channel.lock());
+        if(chan) channelName = chan->getChannelName();
+        cout << "PvaClientMonitor::monitorConnect"
+           << " channelName " << channelName
+           << " status.isOK " << (status.isOK() ? "true" : "false")
+           << endl;
+    }
     connectStatus = status;
+    connectState = connected;
     this->monitor = monitor;
-    if(status.isOK()) {
+    if(isStarted) {
+        if(PvaClient::getDebug()) {
+            string channelName("disconnected");
+            Channel::shared_pointer chan(channel.lock());
+            if(chan) channelName = chan->getChannelName();
+            cout << "PvaClientMonitor::monitorConnect"
+               << " channelName " << channelName
+               << " is already started "
+               << endl;
+        }
+        return;
+    }
+    if(status.isOK() && chan) {
         pvaClientData = PvaClientMonitorData::create(structure);
-        pvaClientData->setMessagePrefix(channel->getChannelName());
+        pvaClientData->setMessagePrefix(chan->getChannelName());
+    }
+    if(PvaClient::getDebug()) {
+         cout << "PvaClientMonitor::monitorConnect calling waitForConnect.signal\n";
     }
     waitForConnect.signal();
     
@@ -106,95 +197,188 @@ void PvaClientMonitor::monitorConnect(
 
 void PvaClientMonitor::monitorEvent(MonitorPtr const & monitor)
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientMonitor was destroyed");
+    if(PvaClient::getDebug()) {
+        string channelName("disconnected");
+        Channel::shared_pointer chan(channel.lock());
+        if(chan) channelName = chan->getChannelName();
+        cout << "PvaClientMonitor::monitorEvent"
+           << " channelName " << channelName
+           << endl;
+    }    
     PvaClientMonitorRequesterPtr req = pvaClientMonitorRequester.lock();
-    if(req) req->event(getPtrSelf());
+    if(req) req->event(shared_from_this());
     if(userWait) waitForEvent.signal();
 }
 
-void PvaClientMonitor::unlisten()
+void PvaClientMonitor::unlisten(MonitorPtr const & monitor)
 {
-    destroy();
+    if(PvaClient::getDebug()) cout << "PvaClientMonitor::unlisten\n";
+    PvaClientMonitorRequesterPtr req = pvaClientMonitorRequester.lock();
+    if(req) {
+        req->unlisten();
+        return;
+    }
+    string channelName("disconnected");
+    Channel::shared_pointer chan(channel.lock());
+    if(chan) channelName = chan->getChannelName();
+    cerr << channelName + "pvaClientMonitor::unlisten called but no PvaClientMonitorRequester\n";
 }
 
-void PvaClientMonitor::destroy()
-{
-    {
-        Lock xx(mutex);
-        if(isDestroyed) return;
-        isDestroyed = true;
-    }
-    if(monitor) monitor->destroy();
-    monitor.reset();
-    monitorElement.reset();
-}
 
 void PvaClientMonitor::connect()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientMonitor was destroyed");
+    if(PvaClient::getDebug()) cout << "PvaClientMonitor::connect\n";
     issueConnect();
     Status status = waitConnect();
     if(status.isOK()) return;
-    string message = string("channel ") + channel->getChannelName() 
-         + " PvaClientMonitor::connect " + status.getMessage();
+    Channel::shared_pointer chan(channel.lock());
+    string channelName("disconnected");
+    if(chan) channelName = chan->getChannelName();
+    string message = string("channel ") 
+        + channelName
+        + " PvaClientMonitor::connect "
+        + status.getMessage();
     throw std::runtime_error(message);
 }
 
 void PvaClientMonitor::issueConnect()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientMonitor was destroyed");
+    if(PvaClient::getDebug()) cout << "PvaClientMonitor::issueConnect\n";
+    Channel::shared_pointer chan(channel.lock());
     if(connectState!=connectIdle) {
-        string message = string("channel ") + channel->getChannelName() 
+        string channelName("disconnected");
+        if(chan) channelName = chan->getChannelName();
+        string message = string("channel ")
+            + channelName 
             + " pvaClientMonitor already connected ";
         throw std::runtime_error(message);
     }
-    monitorRequester = ChannelMonitorRequester::shared_pointer(new ChannelMonitorRequester(this));
-    connectState = connectActive;
-    monitor = channel->createMonitor(monitorRequester,pvRequest);
+    if(chan) {
+        connectState = connectActive;
+        monitor = chan->createMonitor(monitorRequester,pvRequest);
+        return;
+    }
+    throw std::runtime_error("PvaClientMonitor::issueConnect() but channel disconnected");
 }
 
 Status PvaClientMonitor::waitConnect()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientMonitor was destroyed");
+    if(PvaClient::getDebug()) cout << "PvaClientMonitor::waitConnect\n";
+    if(connectState==connected) {
+         if(!connectStatus.isOK()) connectState = connectIdle;
+         return connectStatus;
+    }
     if(connectState!=connectActive) {
-        string message = string("channel ") + channel->getChannelName() 
-            + " pvaClientMonitor illegal connect state ";
+        Channel::shared_pointer chan(channel.lock());
+        string channelName("disconnected");
+        if(chan) channelName = chan->getChannelName();
+        string message = string("channel ")
+            + channelName
+            + " PvaClientMonitor::waitConnect illegal connect state ";
         throw std::runtime_error(message);
     }
+    if(PvaClient::getDebug()) {
+        cout << "PvaClientMonitor::waitConnect calling waitForConnect.wait\n";
+    }
     waitForConnect.wait();
     connectState = connectStatus.isOK() ? connected : connectIdle;
+    if(PvaClient::getDebug()) {
+        cout << "PvaClientMonitor::waitConnect"
+             << " connectStatus " << (connectStatus.isOK() ? "connected" : "not connected");
+    }
     return connectStatus;
 }
 
-void PvaClientMonitor::setRequester(PvaClientMonitorRequesterPtr const & pvaClientMonitorrRequester)
+void PvaClientMonitor::setRequester(PvaClientMonitorRequesterPtr const & pvaClientMonitorRequester)
 {
-    this->pvaClientMonitorRequester = pvaClientMonitorrRequester;
+    if(PvaClient::getDebug()) {
+        string channelName("disconnected");
+        Channel::shared_pointer chan(channel.lock());
+        if(chan) channelName = chan->getChannelName();
+        cout << "PvaClientMonitor::setRequester"
+           << " channelName " << channelName
+           << endl;
+    }
+    this->pvaClientMonitorRequester = pvaClientMonitorRequester;
 }
 
 void PvaClientMonitor::start()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientMonitor was destroyed");
-    if(connectState==monitorStarted) return;
+    if(PvaClient::getDebug()) {
+        string channelName("disconnected");
+        Channel::shared_pointer chan(channel.lock());
+        if(chan) channelName = chan->getChannelName();
+        cout << "PvaClientMonitor::start"
+           << " channelName " << channelName
+           << " connectState " << connectState
+           << endl;
+    }
+    if(isStarted) {
+        string channelName("disconnected");
+        Channel::shared_pointer chan(channel.lock());
+        if(chan) channelName = chan->getChannelName();
+        cerr << "PvaClientMonitor::start"
+           << " channelName " << channelName
+           << " why is this called twice "
+           << endl;
+        return;
+    }
     if(connectState==connectIdle) connect();
-    if(connectState!=connected) throw std::runtime_error("PvaClientMonitor::start illegal state");
-    connectState = monitorStarted;
+    if(connectState!=connected) {
+        Channel::shared_pointer chan(channel.lock());
+        string channelName("disconnected");
+        if(chan) channelName = chan->getChannelName();
+        string message = string("channel ") + channelName
+            + " PvaClientMonitor::start illegal state ";
+        throw std::runtime_error(message);
+    }
+    isStarted = true;
     monitor->start();
 }
 
 
 void PvaClientMonitor::stop()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientMonitor was destroyed");
-    if(connectState!=monitorStarted) return;
-    connectState = connected;
+    if(PvaClient::getDebug()) {
+        string channelName("disconnected");
+        Channel::shared_pointer chan(channel.lock());
+        if(chan) channelName = chan->getChannelName();
+        cout << "PvaClientMonitor::stop"
+           << " channelName " << channelName
+           << endl;
+    }
+    if(!isStarted) return;
+    isStarted = false;
     monitor->stop();
 }
 
 bool PvaClientMonitor::poll()
 {
+    if(PvaClient::getDebug()) {
+        string channelName("disconnected");
+        Channel::shared_pointer chan(channel.lock());
+        if(chan) channelName = chan->getChannelName();
+        cout << "PvaClientMonitor::poll"
+           << " channelName " << channelName
+           << endl;
+    }
     checkMonitorState();
-    if(connectState!=monitorStarted) throw std::runtime_error("PvaClientMonitor::poll illegal state");
-    if(userPoll) throw std::runtime_error("PvaClientMonitor::poll did not release last");
+    if(!isStarted) {
+        string channelName("disconnected");
+        Channel::shared_pointer chan(channel.lock());
+        if(chan) channelName = chan->getChannelName();
+        string message = string("channel ") + channelName
+            + " PvaClientMonitor::poll illegal state ";
+         throw std::runtime_error(message);
+    }
+    if(userPoll) {
+                string channelName("disconnected");
+        Channel::shared_pointer chan(channel.lock());
+        if(chan) channelName = chan->getChannelName();
+        string message = string("channel ") + channelName
+            + " PvaClientMonitor::poll did not release last";
+        throw std::runtime_error(message);
+    }
     monitorElement = monitor->poll();
     if(!monitorElement) return false;
     userPoll = true;
@@ -204,8 +388,22 @@ bool PvaClientMonitor::poll()
 
 bool PvaClientMonitor::waitEvent(double secondsToWait)
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientMonitor was destroyed");
-    if(connectState!=monitorStarted) throw std::runtime_error("PvaClientMonitor::waitEvent illegal state");
+    if(PvaClient::getDebug()) {
+        string channelName("disconnected");
+        Channel::shared_pointer chan(channel.lock());
+        if(chan) channelName = chan->getChannelName();
+        cout << "PvaClientMonitor::waitEvent"
+           << " channelName " << channelName
+           << endl;
+    }
+    if(!isStarted) {
+        Channel::shared_pointer chan(channel.lock());
+        string channelName("disconnected");
+        if(chan) channelName = chan->getChannelName();
+        string message = string("channel ") + channelName
+            + " PvaClientMonitor::waitEvent illegal state ";
+        throw std::runtime_error(message);
+    }
     if(poll()) return true;
     userWait = true;
     if(secondsToWait==0.0) {
@@ -219,26 +417,47 @@ bool PvaClientMonitor::waitEvent(double secondsToWait)
 
 void PvaClientMonitor::releaseEvent()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientMonitor was destroyed");
-    if(connectState!=monitorStarted) throw std::runtime_error("PvaClientMonitor::poll illegal state");
-    if(!userPoll) throw std::runtime_error("PvaClientMonitor::releaseEvent did not call poll");
+    if(PvaClient::getDebug()) {
+        string channelName("disconnected");
+        Channel::shared_pointer chan(channel.lock());
+        if(chan) channelName = chan->getChannelName();
+        cout << "PvaClientMonitor::releaseEvent"
+           << " channelName " << channelName
+           << endl;
+    }
+    if(!isStarted) {
+        Channel::shared_pointer chan(channel.lock());
+        string channelName("disconnected");
+        if(chan) channelName = chan->getChannelName();
+        string message = string("channel ") + channelName
+            + " PvaClientMonitor::releaseEvent monitor not started ";
+        throw std::runtime_error(message);
+    }
+    if(!userPoll) {
+        Channel::shared_pointer chan(channel.lock());
+        string channelName("disconnected");
+        if(chan) channelName = chan->getChannelName();
+        string message = string("channel ") + channelName
+            + " PvaClientMonitor::releaseEvent did not call poll";
+        throw std::runtime_error(message);
+    }
     userPoll = false;
     monitor->release(monitorElement);
 }
 
 PvaClientMonitorDataPtr PvaClientMonitor::getData()
 {
+    if(PvaClient::getDebug()) {
+        string channelName("disconnected");
+        Channel::shared_pointer chan(channel.lock());
+        if(chan) channelName = chan->getChannelName();
+        cout << "PvaClientMonitor::getData"
+           << " channelName " << channelName
+           << endl;
+    }
     checkMonitorState();
     return pvaClientData;
 }
 
-PvaClientMonitorPtr PvaClientMonitor::create(
-        PvaClientPtr const &pvaClient,
-        Channel::shared_pointer const & channel,
-        PVStructurePtr const &pvRequest)
-{
-    PvaClientMonitorPtr epv(new PvaClientMonitor(pvaClient,channel,pvRequest));
-    return epv;
-}
 
 }}

src/pvaClientMonitorData.cpp

@@ -8,15 +8,16 @@
  * @author mrk
  * @date 2015.02
  */
-#define epicsExportSharedSymbols
 
 #include <typeinfo>
-
 #include <sstream>
-#include <pv/pvaClient.h>
+
 #include <pv/createRequest.h>
 #include <pv/convert.h>
 
+#define epicsExportSharedSymbols
+
+#include <pv/pvaClient.h>
 
 using std::tr1::static_pointer_cast;
 using namespace epics::pvData;

src/pvaClientMultiChannel.cpp

@@ -8,11 +8,13 @@
  * @author mrk
  * @date 2015.02
  */
-#define epicsExportSharedSymbols
 
 #include <map>
 #include <pv/event.h>
 #include <pv/lock.h>
+
+#define epicsExportSharedSymbols
+
 #include <pv/pvaClientMultiChannel.h>
 
 
@@ -51,40 +53,28 @@ PvaClientMultiChannel::PvaClientMultiChannel(
   numConnected(0),
   pvaClientChannelArray(PvaClientChannelArray(numChannel,PvaClientChannelPtr())),
   isConnected(shared_vector<epics::pvData::boolean>(numChannel,false)),
-  createRequest(CreateRequest::create()),
-  isDestroyed(false)
+  createRequest(CreateRequest::create())
 {
+    if(PvaClient::getDebug()) cout<< "PvaClientMultiChannel::PvaClientMultiChannel()\n";
 }
 
 PvaClientMultiChannel::~PvaClientMultiChannel()
 {
-    destroy();
-}
-
-void PvaClientMultiChannel::destroy()
-{
-    {
-        Lock xx(mutex);
-        if(isDestroyed) return;
-        isDestroyed = true;
-    }
-    pvaClientChannelArray.clear();
+    if(PvaClient::getDebug()) cout<< "PvaClientMultiChannel::~PvaClientMultiChannel()\n";
 }
 
 void PvaClientMultiChannel::checkConnected()
 {
-    if(numConnected==0) connect(3.0);
+    if(numConnected==0) connect();
 }
 
 epics::pvData::shared_vector<const string> PvaClientMultiChannel::getChannelNames()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientMultiChannel was destroyed");
     return channelName;
 }
 
 Status PvaClientMultiChannel::connect(double timeout)
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientMultiChannel was destroyed");
     for(size_t i=0; i< numChannel; ++i) {
         pvaClientChannelArray[i] = pvaClient->createChannel(channelName[i],providerName);
         pvaClientChannelArray[i]->issueConnect();
@@ -113,13 +103,11 @@ Status PvaClientMultiChannel::connect(double timeout)
 
 bool PvaClientMultiChannel::allConnected()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientMultiChannel was destroyed");
     return (numConnected==numChannel) ? true : false;
 }
 
 bool PvaClientMultiChannel::connectionChange()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientMultiChannel was destroyed");
     for(size_t i=0; i<numChannel; ++i) {
          PvaClientChannelPtr pvaClientChannel = pvaClientChannelArray[i];
          Channel::shared_pointer channel = pvaClientChannel->getChannel();
@@ -132,7 +120,6 @@ bool PvaClientMultiChannel::connectionChange()
 
 epics::pvData::shared_vector<epics::pvData::boolean>  PvaClientMultiChannel::getIsConnected()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientMultiChannel was destroyed");
     for(size_t i=0; i<numChannel; ++i) {
          PvaClientChannelPtr pvaClientChannel = pvaClientChannelArray[i];
          if(!pvaClientChannel) {
@@ -148,13 +135,11 @@ epics::pvData::shared_vector<epics::pvData::boolean>  PvaClientMultiChannel::get
 
 PvaClientChannelArray PvaClientMultiChannel::getPvaClientChannelArray()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientMultiChannel was destroyed");
     return pvaClientChannelArray;
 }
 
 PvaClientPtr PvaClientMultiChannel::getPvaClient()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientMultiChannel was destroyed");
     return pvaClient;
 }
 
@@ -163,35 +148,30 @@ PvaClientPtr PvaClientMultiChannel::getPvaClient()
 PvaClientMultiGetDoublePtr PvaClientMultiChannel::createGet()
 {
     checkConnected();
-    return PvaClientMultiGetDouble::create(getPtrSelf(),pvaClientChannelArray);
+    return PvaClientMultiGetDouble::create(shared_from_this(),pvaClientChannelArray);
 }
 
 
 PvaClientMultiPutDoublePtr PvaClientMultiChannel::createPut()
 {
     checkConnected();
-    return PvaClientMultiPutDouble::create(getPtrSelf(),pvaClientChannelArray);
+    return PvaClientMultiPutDouble::create(shared_from_this(),pvaClientChannelArray);
 }
 
 
 PvaClientMultiMonitorDoublePtr PvaClientMultiChannel::createMonitor()
 {
     checkConnected();
-     return PvaClientMultiMonitorDouble::create(getPtrSelf(), pvaClientChannelArray);
+     return PvaClientMultiMonitorDouble::create(shared_from_this(), pvaClientChannelArray);
 }
 
 PvaClientNTMultiPutPtr PvaClientMultiChannel::createNTPut()
 {
     checkConnected();
-    return PvaClientNTMultiPut::create(getPtrSelf(), pvaClientChannelArray);
+    return PvaClientNTMultiPut::create(shared_from_this(), pvaClientChannelArray);
 }
 
 
-PvaClientNTMultiGetPtr PvaClientMultiChannel::createNTGet()
-{
-    return createNTGet("value,alarm,timeStamp");
-}
-
 PvaClientNTMultiGetPtr PvaClientMultiChannel::createNTGet(std::string const &request)
 {
     checkConnected();
@@ -201,13 +181,7 @@ PvaClientNTMultiGetPtr PvaClientMultiChannel::createNTGet(std::string const &req
              + createRequest->getMessage();
         throw std::runtime_error(message);
     }
-    return PvaClientNTMultiGet::create(getPtrSelf(), pvaClientChannelArray,pvRequest);
-}
-
-
-PvaClientNTMultiMonitorPtr PvaClientMultiChannel::createNTMonitor()
-{
-    return createNTMonitor("value,alarm,timeStamp");
+    return PvaClientNTMultiGet::create(shared_from_this(), pvaClientChannelArray,pvRequest);
 }
 
 PvaClientNTMultiMonitorPtr PvaClientMultiChannel::createNTMonitor(std::string const &request)
@@ -219,7 +193,7 @@ PvaClientNTMultiMonitorPtr PvaClientMultiChannel::createNTMonitor(std::string co
              + createRequest->getMessage();
         throw std::runtime_error(message);
     }
-    return PvaClientNTMultiMonitor::create(getPtrSelf(), pvaClientChannelArray,pvRequest);
+    return PvaClientNTMultiMonitor::create(shared_from_this(), pvaClientChannelArray,pvRequest);
 }
 
 

src/pvaClientMultiGetDouble.cpp

@@ -9,12 +9,13 @@
  * @date 2015.03
  */
 
-#define epicsExportSharedSymbols
-#include <pv/pvaClientMultiChannel.h>
-#include <pv/standardField.h>
 #include <pv/convert.h>
 #include <epicsMath.h>
 
+#define epicsExportSharedSymbols
+
+#include <pv/pvaClientMultiChannel.h>
+
 using std::tr1::static_pointer_cast;
 using namespace epics::pvData;
 using namespace epics::pvAccess;
@@ -23,11 +24,6 @@ using namespace std;
 
 namespace epics { namespace pvaClient { 
 
-static ConvertPtr convert = getConvert();
-static FieldCreatePtr fieldCreate = getFieldCreate();
-static PVDataCreatePtr pvDataCreate = getPVDataCreate();
-static StandardFieldPtr standardField = getStandardField();
-
 
 PvaClientMultiGetDoublePtr PvaClientMultiGetDouble::create(
     PvaClientMultiChannelPtr const &pvaMultiChannel,
@@ -46,24 +42,14 @@ PvaClientMultiGetDouble::PvaClientMultiGetDouble(
   nchannel(pvaClientChannelArray.size()),
   doubleValue(shared_vector<double>(nchannel)),
   pvaClientGet(std::vector<PvaClientGetPtr>(nchannel,PvaClientGetPtr())),
-  isGetConnected(false),
-  isDestroyed(false)
+  isGetConnected(false)
 {
+    if(PvaClient::getDebug()) cout<< "PvaClientMultiGetDouble::PvaClientMultiGetDouble()\n";
 }
 
 PvaClientMultiGetDouble::~PvaClientMultiGetDouble()
 {
-    destroy();
-}
-
-void PvaClientMultiGetDouble::destroy()
-{
-    {
-        Lock xx(mutex);
-        if(isDestroyed) return;
-        isDestroyed = true;
-    }
-    pvaClientChannelArray.clear();
+    if(PvaClient::getDebug()) cout<< "PvaClientMultiGetDouble::~PvaClientMultiGetDouble()\n";
 }
 
 void PvaClientMultiGetDouble::connect()
@@ -117,7 +103,7 @@ epics::pvData::shared_vector<double> PvaClientMultiGetDouble::get()
         if(isConnected[i])
         {
             PVStructurePtr pvStructure = pvaClientGet[i]->getData()->getPVStructure();
-            doubleValue[i] = convert->toDouble(pvStructure->getSubField<PVScalar>("value"));
+            doubleValue[i] = getConvert()->toDouble(pvStructure->getSubField<PVScalar>("value"));
         } else {
             doubleValue[i] = epicsNAN;
         }

src/pvaClientMultiMonitorDouble.cpp

@@ -9,13 +9,13 @@
  * @date 2015.03
  */
 
-#define epicsExportSharedSymbols
 #include <epicsThread.h>
-#include <pv/pvaClientMultiChannel.h>
-#include <pv/standardField.h>
-#include <pv/convert.h>
 #include <epicsMath.h>
 
+#define epicsExportSharedSymbols
+
+#include <pv/pvaClientMultiChannel.h>
+
 using std::tr1::static_pointer_cast;
 using namespace epics::pvData;
 using namespace epics::pvAccess;
@@ -24,11 +24,6 @@ using namespace std;
 
 namespace epics { namespace pvaClient { 
 
-static ConvertPtr convert = getConvert();
-static FieldCreatePtr fieldCreate = getFieldCreate();
-static PVDataCreatePtr pvDataCreate = getPVDataCreate();
-static StandardFieldPtr standardField = getStandardField();
-
 
 PvaClientMultiMonitorDoublePtr PvaClientMultiMonitorDouble::create(
     PvaClientMultiChannelPtr const &pvaMultiChannel,
@@ -47,24 +42,14 @@ PvaClientMultiMonitorDouble::PvaClientMultiMonitorDouble(
   nchannel(pvaClientChannelArray.size()),
   doubleValue(shared_vector<double>(nchannel,epicsNAN)),
   pvaClientMonitor(std::vector<PvaClientMonitorPtr>(nchannel,PvaClientMonitorPtr())),
-  isMonitorConnected(false),
-  isDestroyed(false)
+  isMonitorConnected(false)
 {
+     if(PvaClient::getDebug()) cout<< "PvaClientMultiMonitorDouble::PvaClientMultiMonitorDouble()\n";
 }
 
 PvaClientMultiMonitorDouble::~PvaClientMultiMonitorDouble()
 {
-    destroy();
-}
-
-void PvaClientMultiMonitorDouble::destroy()
-{
-    {
-        Lock xx(mutex);
-        if(isDestroyed) return;
-        isDestroyed = true;
-    }
-    pvaClientChannelArray.clear();
+    if(PvaClient::getDebug()) cout<< "PvaClientMultiMonitorDouble::~PvaClientMultiMonitorDouble()\n";
 }
 
 void PvaClientMultiMonitorDouble::connect()
@@ -99,7 +84,7 @@ bool PvaClientMultiMonitorDouble::poll()
 {
     if(!isMonitorConnected){
          connect();
-         epicsThreadSleep(.01);
+         epicsThreadSleep(.1);
     }
     bool result = false;
     shared_vector<epics::pvData::boolean> isConnected = pvaClientMultiChannel->getIsConnected();

src/pvaClientMultiPutDouble.cpp

@@ -9,12 +9,13 @@
  * @date 2015.03
  */
 
-#define epicsExportSharedSymbols
-#include <pv/pvaClientMultiChannel.h>
-#include <pv/standardField.h>
 #include <pv/convert.h>
 #include <epicsMath.h>
 
+#define epicsExportSharedSymbols
+
+#include <pv/pvaClientMultiChannel.h>
+
 using std::tr1::static_pointer_cast;
 using namespace epics::pvData;
 using namespace epics::pvAccess;
@@ -23,12 +24,6 @@ using namespace std;
 
 namespace epics { namespace pvaClient { 
 
-static ConvertPtr convert = getConvert();
-static FieldCreatePtr fieldCreate = getFieldCreate();
-static PVDataCreatePtr pvDataCreate = getPVDataCreate();
-static StandardFieldPtr standardField = getStandardField();
-static CreateRequest::shared_pointer  createRequest = CreateRequest::create();
-
 
 PvaClientMultiPutDoublePtr PvaClientMultiPutDouble::create(
     PvaClientMultiChannelPtr const &pvaMultiChannel,
@@ -46,27 +41,18 @@ PvaClientMultiPutDouble::PvaClientMultiPutDouble(
   pvaClientChannelArray(pvaClientChannelArray),
   nchannel(pvaClientChannelArray.size()),
   pvaClientPut(std::vector<PvaClientPutPtr>(nchannel,PvaClientPutPtr())),
-  isPutConnected(false),
-  isDestroyed(false)
+  isPutConnected(false)
 {
+    if(PvaClient::getDebug()) cout<< "PvaClientMultiPutDouble::PvaClientMultiPutDouble()\n";
 }
 
 
 
 PvaClientMultiPutDouble::~PvaClientMultiPutDouble()
 {
-    destroy();
+    if(PvaClient::getDebug()) cout<< "PvaClientMultiPutDouble::~PvaClientMultiPutDouble()\n";
 }
 
-void PvaClientMultiPutDouble::destroy()
-{
-    {
-        Lock xx(mutex);
-        if(isDestroyed) return;
-        isDestroyed = true;
-    }
-    pvaClientChannelArray.clear();
-}
 
 void PvaClientMultiPutDouble::connect()
 {
@@ -103,7 +89,7 @@ void PvaClientMultiPutDouble::put(epics::pvData::shared_vector<double> const &da
          if(isConnected[i]) {
                PVStructurePtr pvTop = pvaClientPut[i]->getData()->getPVStructure();
                PVScalarPtr pvValue = pvTop->getSubField<PVScalar>("value");
-               convert->fromDouble(pvValue,data[i]);
+               getConvert()->fromDouble(pvValue,data[i]);
                pvaClientPut[i]->issuePut();
          }
          if(isConnected[i]) {

src/pvaClientNTMultiData.cpp

@@ -9,10 +9,12 @@
  * @date 2015.03
  */
 
-#define epicsExportSharedSymbols
-#include <pv/pvaClientMultiChannel.h>
 #include <epicsMath.h>
 
+#define epicsExportSharedSymbols
+
+#include <pv/pvaClientMultiChannel.h>
+
 using std::tr1::static_pointer_cast;
 using namespace epics::pvData;
 using namespace epics::pvAccess;
@@ -21,9 +23,6 @@ using namespace std;
 
 namespace epics { namespace pvaClient { 
 
-static PVDataCreatePtr pvDataCreate = getPVDataCreate();
-
-
 PvaClientNTMultiDataPtr PvaClientNTMultiData::create(
     epics::pvData::UnionConstPtr const & u,
     PvaClientMultiChannelPtr const &pvaMultiChannel,
@@ -43,15 +42,16 @@ PvaClientNTMultiData::PvaClientNTMultiData(
   pvaClientChannelArray(pvaClientChannelArray),
   nchannel(pvaClientChannelArray.size()),
   gotAlarm(false),
-  gotTimeStamp(false),
-  isDestroyed(false)
+  gotTimeStamp(false)
 {
+    if(PvaClient::getDebug()) cout<< "PvaClientNTMultiData::PvaClientNTMultiData()\n";
     PVFieldPtr pvValue = pvRequest->getSubField("field.value");
     if(!pvValue) {
         throw std::runtime_error("pvRequest did not specify value");
     }
     topPVStructure.resize(nchannel);
     unionValue.resize(nchannel);
+    PVDataCreatePtr pvDataCreate = getPVDataCreate();
     for(size_t i=0; i< nchannel; ++i) {
          topPVStructure[i] = PVStructurePtr();
          unionValue[i] = pvDataCreate->createPVUnion(u);
@@ -86,18 +86,9 @@ PvaClientNTMultiData::PvaClientNTMultiData(
 
 PvaClientNTMultiData::~PvaClientNTMultiData()
 {
-    destroy();
+    if(PvaClient::getDebug()) cout<< "PvaClientNTMultiData::~PvaClientNTMultiData()\n";
 }
 
-void PvaClientNTMultiData::destroy()
-{
-    {
-        Lock xx(mutex);
-        if(isDestroyed) return;
-        isDestroyed = true;
-    }
-    pvaClientChannelArray.clear();
-}
 
 void PvaClientNTMultiData::setStructure(StructureConstPtr const & structure,size_t index)
 {
@@ -153,23 +144,22 @@ void PvaClientNTMultiData::endDeltaTime()
     {
         PVStructurePtr pvst = topPVStructure[i];
         if(!pvst) {
-              unionValue[i] = PVUnionPtr();
+            unionValue[i] = PVUnionPtr();
         } else {
-              unionValue[i]->set(pvst->getSubField("value"));
-        }
-        if(gotAlarm)
-        {
-              severity[i] = pvst->getSubField<PVInt>("alarm.severity")->get();
-              status[i] = pvst->getSubField<PVInt>("alarm.status")->get();
-              message[i] = pvst->getSubField<PVString>("alarm.message")->get();
-        }
-        if(gotTimeStamp)
-        {
-              secondsPastEpoch[i] = pvst->getSubField<PVLong>("timeStamp.secondsPastEpoch")->get();
-              nanoseconds[i] = pvst->getSubField<PVInt>("timeStamp.nanoseconds")->get();
-              userTag[i] = pvst->getSubField<PVInt>("timeStamp.userTag")->get();
-        }
-             
+            unionValue[i]->set(pvst->getSubField("value"));
+            if(gotAlarm)
+            {
+                severity[i] = pvst->getSubField<PVInt>("alarm.severity")->get();
+                status[i] = pvst->getSubField<PVInt>("alarm.status")->get();
+                message[i] = pvst->getSubField<PVString>("alarm.message")->get();
+            }
+            if(gotTimeStamp)
+            {
+                secondsPastEpoch[i] = pvst->getSubField<PVLong>("timeStamp.secondsPastEpoch")->get();
+                nanoseconds[i] = pvst->getSubField<PVInt>("timeStamp.nanoseconds")->get();
+                userTag[i] = pvst->getSubField<PVInt>("timeStamp.userTag")->get();
+            }
+        } 
     }
 }
 
@@ -181,7 +171,7 @@ TimeStamp PvaClientNTMultiData::getTimeStamp()
 
 NTMultiChannelPtr PvaClientNTMultiData::getNTMultiChannel()
 {
-    PVStructurePtr pvStructure = pvDataCreate->createPVStructure(ntMultiChannelStructure);
+    PVStructurePtr pvStructure = getPVDataCreate()->createPVStructure(ntMultiChannelStructure);
     NTMultiChannelPtr ntMultiChannel = NTMultiChannel::wrap(pvStructure);
     ntMultiChannel->getChannelName()->replace(pvaClientMultiChannel->getChannelNames());
     shared_vector<epics::pvData::PVUnionPtr> val(nchannel);

src/pvaClientNTMultiGet.cpp

@@ -9,12 +9,12 @@
  * @date 2015.03
  */
 
-#define epicsExportSharedSymbols
-#include <pv/pvaClientMultiChannel.h>
-#include <pv/standardField.h>
-#include <pv/convert.h>
 #include <epicsMath.h>
 
+#define epicsExportSharedSymbols
+
+#include <pv/pvaClientMultiChannel.h>
+
 using std::tr1::static_pointer_cast;
 using namespace epics::pvData;
 using namespace epics::pvAccess;
@@ -23,18 +23,13 @@ using namespace std;
 
 namespace epics { namespace pvaClient { 
 
-static ConvertPtr convert = getConvert();
-static FieldCreatePtr fieldCreate = getFieldCreate();
-static PVDataCreatePtr pvDataCreate = getPVDataCreate();
-static StandardFieldPtr standardField = getStandardField();
-
 
 PvaClientNTMultiGetPtr PvaClientNTMultiGet::create(
     PvaClientMultiChannelPtr const &pvaMultiChannel,
     PvaClientChannelArray const &pvaClientChannelArray,
     PVStructurePtr const &  pvRequest)
 {
-    UnionConstPtr u = fieldCreate->createVariantUnion();
+    UnionConstPtr u = getFieldCreate()->createVariantUnion();
     PvaClientNTMultiGetPtr pvaClientNTMultiGet(
          new PvaClientNTMultiGet(u,pvaMultiChannel,pvaClientChannelArray,pvRequest));
     return pvaClientNTMultiGet;
@@ -55,24 +50,14 @@ PvaClientNTMultiGet::PvaClientNTMultiGet(
            pvaClientMultiChannel,
            pvaClientChannelArray,
            pvRequest)),
-  isConnected(false),
-  isDestroyed(false)
+  isConnected(false)
 {
+    if(PvaClient::getDebug()) cout<< "PvaClientNTMultiGet::PvaClientNTMultiGet()\n";
 }
 
 PvaClientNTMultiGet::~PvaClientNTMultiGet()
 {
-    destroy();
-}
-
-void PvaClientNTMultiGet::destroy()
-{
-    {
-        Lock xx(mutex);
-        if(isDestroyed) return;
-        isDestroyed = true;
-    }
-    pvaClientChannelArray.clear();
+    if(PvaClient::getDebug()) cout<< "PvaClientNTMultiGet::~PvaClientNTMultiGet()\n";
 }
 
 void PvaClientNTMultiGet::connect()

src/pvaClientNTMultiMonitor.cpp

@@ -9,13 +9,15 @@
  * @date 2015.03
  */
 
-#define epicsExportSharedSymbols
 #include <epicsThread.h>
-#include <pv/pvaClientMultiChannel.h>
 #include <pv/standardField.h>
 #include <pv/convert.h>
 #include <epicsMath.h>
 
+#define epicsExportSharedSymbols
+
+#include <pv/pvaClientMultiChannel.h>
+
 using std::tr1::static_pointer_cast;
 using namespace epics::pvData;
 using namespace epics::pvAccess;
@@ -24,14 +26,12 @@ using namespace std;
 
 namespace epics { namespace pvaClient { 
 
-static FieldCreatePtr fieldCreate = getFieldCreate();
-
 PvaClientNTMultiMonitorPtr PvaClientNTMultiMonitor::create(
     PvaClientMultiChannelPtr const &pvaMultiChannel,
          PvaClientChannelArray const &pvaClientChannelArray,
          epics::pvData::PVStructurePtr const &  pvRequest)
 {
-    UnionConstPtr u = fieldCreate->createVariantUnion();
+    UnionConstPtr u = getFieldCreate()->createVariantUnion();
     PvaClientNTMultiMonitorPtr pvaClientNTMultiMonitor(
          new PvaClientNTMultiMonitor(u,pvaMultiChannel,pvaClientChannelArray,pvRequest));
     return pvaClientNTMultiMonitor;
@@ -52,25 +52,15 @@ PvaClientNTMultiMonitor::PvaClientNTMultiMonitor(
            pvaClientMultiChannel,
            pvaClientChannelArray,
            pvRequest)),
-  isConnected(false),
-  isDestroyed(false)
+  isConnected(false)
 {
+    if(PvaClient::getDebug()) cout<< "PvaClientNTMultiMonitor::PvaClientNTMultiMonitor()\n";
 }
 
 
 PvaClientNTMultiMonitor::~PvaClientNTMultiMonitor()
 {
-    destroy();
-}
-
-void PvaClientNTMultiMonitor::destroy()
-{
-    {
-        Lock xx(mutex);
-        if(isDestroyed) return;
-        isDestroyed = true;
-    }
-    pvaClientChannelArray.clear();
+    if(PvaClient::getDebug()) cout<< "PvaClientNTMultiMonitor::~PvaClientNTMultiMonitor()\n";
 }
 
 

src/pvaClientNTMultiPut.cpp

@@ -9,12 +9,14 @@
  * @date 2015.03
  */
 
-#define epicsExportSharedSymbols
-#include <pv/pvaClientMultiChannel.h>
 #include <pv/standardField.h>
 #include <pv/convert.h>
 #include <epicsMath.h>
 
+#define epicsExportSharedSymbols
+
+#include <pv/pvaClientMultiChannel.h>
+
 using std::tr1::static_pointer_cast;
 using namespace epics::pvData;
 using namespace epics::pvAccess;
@@ -23,10 +25,6 @@ using namespace std;
 
 namespace epics { namespace pvaClient { 
 
-static ConvertPtr convert = getConvert();
-static FieldCreatePtr fieldCreate = getFieldCreate();
-static PVDataCreatePtr pvDataCreate = getPVDataCreate();
-
 PvaClientNTMultiPutPtr PvaClientNTMultiPut::create(
     PvaClientMultiChannelPtr const &pvaMultiChannel,
     PvaClientChannelArray const &pvaClientChannelArray)
@@ -43,25 +41,15 @@ PvaClientNTMultiPut::PvaClientNTMultiPut(
   nchannel(pvaClientChannelArray.size()),
   unionValue(shared_vector<epics::pvData::PVUnionPtr>(nchannel,PVUnionPtr())),
   value(shared_vector<epics::pvData::PVFieldPtr>(nchannel,PVFieldPtr())),
-  isConnected(false),
-  isDestroyed(false)
+  isConnected(false)
 {
+     if(PvaClient::getDebug()) cout<< "PvaClientNTMultiPut::PvaClientNTMultiPut()\n";
 }
 
 
 PvaClientNTMultiPut::~PvaClientNTMultiPut()
 {
-    destroy();
-}
-
-void PvaClientNTMultiPut::destroy()
-{
-    {
-        Lock xx(mutex);
-        if(isDestroyed) return;
-        isDestroyed = true;
-    }
-    pvaClientChannelArray.clear();
+    if(PvaClient::getDebug()) cout<< "PvaClientNTMultiPut::~PvaClientNTMultiPut()\n";
 }
 
 void PvaClientNTMultiPut::connect()
@@ -101,6 +89,8 @@ void PvaClientNTMultiPut::connect()
                throw std::runtime_error(message);
          }
     }
+    FieldCreatePtr fieldCreate = getFieldCreate();
+    PVDataCreatePtr pvDataCreate = getPVDataCreate();
     for(size_t i=0; i<nchannel; ++i)
     {
          if(isConnected[i]) {

src/pvaClientProcess.cpp

@@ -8,9 +8,11 @@
  * @author mrk
  * @date 2015.02
  */
-#define epicsExportSharedSymbols
 
 #include <pv/event.h>
+
+#define epicsExportSharedSymbols
+
 #include <pv/pvaClient.h>
 
 using std::tr1::static_pointer_cast;
@@ -20,27 +22,64 @@ using namespace std;
 
 namespace epics { namespace pvaClient {
 
-
 class ChannelProcessRequesterImpl : public ChannelProcessRequester
 {
-    PvaClientProcess * pvaClientProcess;
+    PvaClientProcess::weak_pointer pvaClientProcess;
+    PvaClient::weak_pointer pvaClient;
 public:
-    ChannelProcessRequesterImpl(PvaClientProcess * pvaClientProcess)
-    : pvaClientProcess(pvaClientProcess) {}
-    string getRequesterName()
-    {return pvaClientProcess->getRequesterName();}
-    void message(string const & message,MessageType messageType)
-    {pvaClientProcess->message(message,messageType);}
-    void channelProcessConnect(
+    ChannelProcessRequesterImpl(
+        PvaClientProcessPtr const & pvaClientProcess,
+        PvaClientPtr const &pvaClient)
+    : pvaClientProcess(pvaClientProcess),
+      pvaClient(pvaClient)
+    {}
+    virtual ~ChannelProcessRequesterImpl() {
+        if(PvaClient::getDebug()) std::cout << "~ChannelProcessRequesterImpl" << std::endl;
+    }
+
+    virtual std::string getRequesterName() {
+        PvaClientProcessPtr clientProcess(pvaClientProcess.lock());
+        if(!clientProcess) return string("clientProcess is null");
+        return clientProcess->getRequesterName();
+    }
+
+    virtual void message(std::string const & message, epics::pvData::MessageType messageType) {
+        PvaClientProcessPtr clientProcess(pvaClientProcess.lock());
+        if(!clientProcess) return;
+        clientProcess->message(message,messageType);
+    }
+
+    virtual void channelProcessConnect(
         const Status& status,
         ChannelProcess::shared_pointer const & channelProcess)
-    {pvaClientProcess->channelProcessConnect(status,channelProcess);}
-    void processDone(
+    {
+        PvaClientProcessPtr clientProcess(pvaClientProcess.lock());
+        if(!clientProcess) return;
+        clientProcess->channelProcessConnect(status,channelProcess);  
+    }
+
+    virtual void processDone(
         const Status& status,
-        ChannelProcess::shared_pointer const & channelProcess)
-    {pvaClientProcess->processDone(status,channelProcess);}
+        ChannelProcess::shared_pointer const & ChannelProcess)
+    {
+        PvaClientProcessPtr clientProcess(pvaClientProcess.lock());
+        if(!clientProcess) return;
+        clientProcess->processDone(status,ChannelProcess);
+    }
 };
 
+PvaClientProcessPtr PvaClientProcess::create(
+        PvaClientPtr const &pvaClient,
+        Channel::shared_pointer const & channel,
+        PVStructurePtr const &pvRequest)
+{
+    PvaClientProcessPtr epv(new PvaClientProcess(pvaClient,channel,pvRequest));
+    epv->channelProcessRequester = ChannelProcessRequesterImplPtr(
+        new ChannelProcessRequesterImpl(epv,pvaClient));
+    return epv;
+}
+
+
 PvaClientProcess::PvaClientProcess(
         PvaClientPtr const &pvaClient,
         Channel::shared_pointer const & channel,
@@ -48,15 +87,16 @@ PvaClientProcess::PvaClientProcess(
 : pvaClient(pvaClient),
   channel(channel),
   pvRequest(pvRequest),
-  isDestroyed(false),
   connectState(connectIdle),
   processState(processIdle)
 {
+    if(PvaClient::getDebug()) cout<< "PvaClientProcess::PvaClientProcess()\n";
 }
 
 PvaClientProcess::~PvaClientProcess()
 {
-    destroy();
+    if(PvaClient::getDebug()) cout<< "PvaClientProcess::~PvaClientProcess()\n";
+    channelProcess->destroy();
 }
 
 // from ChannelProcessRequester
@@ -69,7 +109,6 @@ string PvaClientProcess::getRequesterName()
 
 void PvaClientProcess::message(string const & message,MessageType messageType)
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientProcess was destroyed");
     PvaClientPtr yyy = pvaClient.lock();
     if(!yyy) throw std::runtime_error("pvaClient was destroyed");
     yyy->message(message, messageType);
@@ -79,8 +118,8 @@ void PvaClientProcess::channelProcessConnect(
     const Status& status,
     ChannelProcess::shared_pointer const & channelProcess)
 {
-    if(isDestroyed) return;
     channelProcessConnectStatus = status;
+    connectState = connected;
     this->channelProcess = channelProcess;
     waitForConnect.signal();
     
@@ -90,27 +129,13 @@ void PvaClientProcess::processDone(
     const Status& status,
     ChannelProcess::shared_pointer const & channelProcess)
 {
-    if(isDestroyed) return;
     channelProcessStatus = status;
+    processState = processComplete;
     waitForProcess.signal();
 }
 
-
-// from PvaClientProcess
-void PvaClientProcess::destroy()
-{
-    {
-        Lock xx(mutex);
-        if(isDestroyed) return;
-        isDestroyed = true;
-    }
-    if(channelProcess) channelProcess->destroy();
-    channelProcess.reset();
-}
-
 void PvaClientProcess::connect()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientProcess was destroyed");
     issueConnect();
     Status status = waitConnect();
     if(status.isOK()) return;
@@ -121,33 +146,33 @@ void PvaClientProcess::connect()
 
 void PvaClientProcess::issueConnect()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientProcess was destroyed");
     if(connectState!=connectIdle) {
         string message = string("channel ") + channel->getChannelName()
             + " pvaClientProcess already connected ";
         throw std::runtime_error(message);
     }
-    processRequester = ChannelProcessRequester::shared_pointer(new ChannelProcessRequesterImpl(this));
     connectState = connectActive;
-    channelProcess = channel->createChannelProcess(processRequester,pvRequest);
+    channelProcess = channel->createChannelProcess(channelProcessRequester,pvRequest);
 }
 
 Status PvaClientProcess::waitConnect()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientProcess was destroyed");
+    if(connectState==connected) {
+         if(!channelProcessConnectStatus.isOK()) connectState = connectIdle;
+         return channelProcessConnectStatus;
+    }
     if(connectState!=connectActive) {
         string message = string("channel ") + channel->getChannelName()
             + " pvaClientProcess illegal connect state ";
         throw std::runtime_error(message);
     }
     waitForConnect.wait();
-    connectState = channelProcessConnectStatus.isOK() ? connected : connectIdle;
+    if(!channelProcessConnectStatus.isOK()) connectState = connectIdle;
     return channelProcessConnectStatus;
 }
 
 void PvaClientProcess::process()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientProcess was destroyed");
     issueProcess();
     Status status = waitProcess();
     if(status.isOK()) return;
@@ -158,7 +183,6 @@ void PvaClientProcess::process()
 
 void PvaClientProcess::issueProcess()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientProcess was destroyed");
     if(connectState==connectIdle) connect();
     if(processState!=processIdle) {
         string message = string("channel ") + channel->getChannelName()
@@ -171,7 +195,10 @@ void PvaClientProcess::issueProcess()
 
 Status PvaClientProcess::waitProcess()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientProcess was destroyed");
+    if(processState==processComplete) {
+        processState = processIdle;
+        return channelProcessStatus;
+    }
     if(processState!=processActive){
         string message = string("channel ") + channel->getChannelName()
             + " PvaClientProcess::waitProcess llegal process state";
@@ -182,13 +209,4 @@ Status PvaClientProcess::waitProcess()
     return channelProcessStatus;
 }
 
-PvaClientProcessPtr PvaClientProcess::create(
-        PvaClientPtr const &pvaClient,
-        Channel::shared_pointer const & channel,
-        PVStructurePtr const &pvRequest)
-{
-    PvaClientProcessPtr epv(new PvaClientProcess(pvaClient,channel,pvRequest));
-    return epv;
-}
-
 }}

src/pvaClientPut.cpp

@@ -8,9 +8,11 @@
  * @author mrk
  * @date 2015.02
  */
-#define epicsExportSharedSymbols
 
 #include <pv/event.h>
+
+#define epicsExportSharedSymbols
+
 #include <pv/pvaClient.h>
 
 using std::tr1::static_pointer_cast;
@@ -22,31 +24,75 @@ namespace epics { namespace pvaClient {
 
 class ChannelPutRequesterImpl : public ChannelPutRequester
 {
-    PvaClientPut * pvaClientPut;
+    PvaClientPut::weak_pointer pvaClientPut;
+    PvaClient::weak_pointer pvaClient;
 public:
-    ChannelPutRequesterImpl(PvaClientPut * pvaClientPut)
-    : pvaClientPut(pvaClientPut) {}
-    string getRequesterName()
-    {return pvaClientPut->getRequesterName();}
-    void message(string const & message,MessageType messageType)
-    {pvaClientPut->message(message,messageType);}
-    void channelPutConnect(
+    ChannelPutRequesterImpl(
+        PvaClientPutPtr const & pvaClientPut,
+        PvaClientPtr const &pvaClient)
+    : pvaClientPut(pvaClientPut),
+      pvaClient(pvaClient)
+    {}
+    virtual ~ChannelPutRequesterImpl() {
+        if(PvaClient::getDebug()) std::cout << "~ChannelPutRequesterImpl" << std::endl;
+    }
+
+    virtual std::string getRequesterName() {
+        PvaClientPutPtr clientPut(pvaClientPut.lock());
+        if(!clientPut) return string("clientPut is null");
+        return clientPut->getRequesterName();
+    }
+
+    virtual void message(std::string const & message, epics::pvData::MessageType messageType) {
+        PvaClientPutPtr clientPut(pvaClientPut.lock());
+        if(!clientPut) return;
+        clientPut->message(message,messageType);
+    }
+
+    virtual void channelPutConnect(
         const Status& status,
         ChannelPut::shared_pointer const & channelPut,
-        StructureConstPtr const & structure)
-    {pvaClientPut->channelPutConnect(status,channelPut,structure);}
-    void getDone(
+        Structure::const_shared_pointer const & structure)
+    {
+        PvaClientPutPtr clientPut(pvaClientPut.lock());
+        if(!clientPut) return;
+        clientPut->channelPutConnect(status,channelPut,structure);  
+    }
+
+    virtual void getDone(
         const Status& status,
         ChannelPut::shared_pointer const & channelPut,
         PVStructurePtr const & pvStructure,
-        BitSetPtr const & bitSet)
-    {pvaClientPut->getDone(status,channelPut,pvStructure,bitSet);}
-    void putDone(
+        BitSet::shared_pointer const & bitSet)
+    {
+        PvaClientPutPtr clientPut(pvaClientPut.lock());
+        if(!clientPut) return;
+        clientPut->getDone(status,channelPut,pvStructure,bitSet);
+    }
+
+        virtual void putDone(
         const Status& status,
         ChannelPut::shared_pointer const & channelPut)
-    {pvaClientPut->putDone(status,channelPut);}
+    {
+        PvaClientPutPtr clientPut(pvaClientPut.lock());
+        if(!clientPut) return;
+        clientPut->putDone(status,channelPut);
+    }
 };
 
+PvaClientPutPtr PvaClientPut::create(
+        PvaClientPtr const &pvaClient,
+        Channel::shared_pointer const & channel,
+        PVStructurePtr const &pvRequest)
+{
+    PvaClientPutPtr epv(new PvaClientPut(pvaClient,channel,pvRequest));
+    epv->channelPutRequester = ChannelPutRequesterImplPtr(
+        new ChannelPutRequesterImpl(epv,pvaClient));
+    return epv;
+}
+
+
+
 PvaClientPut::PvaClientPut(
         PvaClientPtr const &pvaClient,
         Channel::shared_pointer const & channel,
@@ -54,39 +100,48 @@ PvaClientPut::PvaClientPut(
 : pvaClient(pvaClient),
   channel(channel),
   pvRequest(pvRequest),
-  isDestroyed(false),
   connectState(connectIdle),
   putState(putIdle)
 {
+    if(PvaClient::getDebug()) {
+         cout<< "PvaClientPut::PvaClientPut"
+             << " channelName " << channel->getChannelName() 
+             << endl;
+    }
 }
 
 PvaClientPut::~PvaClientPut()
 {
-    destroy();
+    if(PvaClient::getDebug()) {
+        string channelName("disconnected");
+        Channel::shared_pointer chan(channel.lock());
+        if(chan) channelName = chan->getChannelName();
+        cout<< "PvaClientPut::~PvaClientPut"
+           << " channelName " << channelName
+           << endl;
+    }
+    if(channelPut) channelPut->destroy();
 }
 
 void PvaClientPut::checkPutState()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPut was destroyed");
     if(connectState==connectIdle){
           connect();
           get();
     }
 }
 
-// from ChannelPutRequester
 string PvaClientPut::getRequesterName()
 {
      PvaClientPtr yyy = pvaClient.lock();
-     if(!yyy) throw std::runtime_error("pvaClient was destroyed");
+     if(!yyy) return string("PvaClientPut::getRequesterName() PvaClient isDestroyed");
      return yyy->getRequesterName();
 }
 
 void PvaClientPut::message(string const & message,MessageType messageType)
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPut was destroyed");
     PvaClientPtr yyy = pvaClient.lock();
-    if(!yyy) throw std::runtime_error("pvaClient was destroyed");
+    if(!yyy) return;
     yyy->message(message, messageType);
 }
 
@@ -95,12 +150,23 @@ void PvaClientPut::channelPutConnect(
     ChannelPut::shared_pointer const & channelPut,
     StructureConstPtr const & structure)
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPut was destroyed");
-    channelPutConnectStatus = status;
-    this->channelPut = channelPut;
-    if(status.isOK()) {
-        pvaClientData = PvaClientPutData::create(structure);
-        pvaClientData->setMessagePrefix(channel->getChannelName());
+    if(PvaClient::getDebug()) {
+        string channelName("disconnected");
+        Channel::shared_pointer chan(channel.lock());
+        if(chan) channelName = chan->getChannelName();
+        cout << "PvaClientPut::channelPutConnect"
+           << " channelName " << channelName
+           << " status.isOK " << (status.isOK() ? "true" : "false")
+           << endl;
+    }
+    {
+        Lock xx(mutex);
+        channelPutConnectStatus = status;
+        this->channelPut = channelPut;
+        if(status.isOK()) {
+            pvaClientData = PvaClientPutData::create(structure);
+            pvaClientData->setMessagePrefix(channelPut->getChannel()->getChannelName());
+        }
     }
     waitForConnect.signal();
     
@@ -112,7 +178,15 @@ void PvaClientPut::getDone(
     PVStructurePtr const & pvStructure,
     BitSetPtr const & bitSet)
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPut was destroyed");
+    if(PvaClient::getDebug()) {
+        string channelName("disconnected");
+        Channel::shared_pointer chan(channel.lock());
+        if(chan) channelName = chan->getChannelName();
+        cout << "PvaClientPut::getDone"
+           << " channelName " << channelName
+           << " status.isOK " << (status.isOK() ? "true" : "false")
+           << endl;
+    }
     channelGetPutStatus = status;
     if(status.isOK()) {
         PVStructurePtr pvs = pvaClientData->getPVStructure();
@@ -128,92 +202,114 @@ void PvaClientPut::putDone(
     const Status& status,
     ChannelPut::shared_pointer const & channelPut)
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPut was destroyed");
+    if(PvaClient::getDebug()) {
+        string channelName("disconnected");
+        Channel::shared_pointer chan(channel.lock());
+        if(chan) channelName = chan->getChannelName();
+        cout << "PvaClientPut::putDone"
+           << " channelName " << channelName
+           << " status.isOK " << (status.isOK() ? "true" : "false")
+           << endl;
+    }
     channelGetPutStatus = status;
     waitForGetPut.signal();
 }
 
-
-// from PvaClientPut
-void PvaClientPut::destroy()
-{
-    {
-        Lock xx(mutex);
-        if(isDestroyed) return;
-        isDestroyed = true;
-    }
-    if(channelPut) channelPut->destroy();
-    channelPut.reset();
-}
-
 void PvaClientPut::connect()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPut was destroyed");
     issueConnect();
     Status status = waitConnect();
     if(status.isOK()) return;
-    string message = string("channel ") + channel->getChannelName()
-        + " PvaClientPut::connect " + status.getMessage();
+    Channel::shared_pointer chan(channel.lock());
+    string channelName("disconnected");
+    if(chan) channelName = chan->getChannelName();
+    string message = string("channel ") 
+        + channelName
+        + " PvaClientPut::connect "
+        + status.getMessage();
     throw std::runtime_error(message);
 }
 
 void PvaClientPut::issueConnect()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPut was destroyed");
+    Channel::shared_pointer chan(channel.lock());
     if(connectState!=connectIdle) {
-        string message = string("channel ") + channel->getChannelName()
+        string channelName("disconnected");
+        if(chan) channelName = chan->getChannelName();
+        string message = string("channel ") + channelName
             + " pvaClientPut already connected ";
         throw std::runtime_error(message);
     }
-    putRequester = ChannelPutRequester::shared_pointer(new ChannelPutRequesterImpl(this));
-    connectState = connectActive;
-    channelPut = channel->createChannelPut(putRequester,pvRequest);
+    if(chan) {
+        connectState = connectActive;
+        channelPut = chan->createChannelPut(channelPutRequester,pvRequest);
+        return;
+    }
+    throw std::runtime_error("PvaClientPut::issueConnect() but channel disconnected");
 }
 
 Status PvaClientPut::waitConnect()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPut was destroyed");
-    if(connectState!=connectActive) {
-        string message = string("channel ") + channel->getChannelName()
-            + " pvaClientPut illegal connect state ";
-        throw std::runtime_error(message);
+    {
+        Lock xx(mutex);
+        if(connectState==connected) {
+             if(!channelPutConnectStatus.isOK()) connectState = connectIdle;
+             return channelPutConnectStatus;
+        }
+        if(connectState!=connectActive) {
+            Channel::shared_pointer chan(channel.lock());
+            string channelName("disconnected");
+            if(chan) channelName = chan->getChannelName();
+            string message = string("channel ") + channelName
+                + " PvaClientPut::waitConnect illegal connect state ";
+            throw std::runtime_error(message);
+        }
     }
     waitForConnect.wait();
-    connectState = channelPutConnectStatus.isOK() ? connected : connectIdle;
+    if(!channelPutConnectStatus.isOK()) connectState = connectIdle;
     return channelPutConnectStatus;
 }
 
 void PvaClientPut::get()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPut was destroyed");
     issueGet();
     Status status = waitGet();
     if(status.isOK()) return;
-    string message = string("channel ") + channel->getChannelName()
-        + " PvaClientPut::get " + status.getMessage();
+    Channel::shared_pointer chan(channel.lock());
+    string channelName("disconnected");
+    if(chan) channelName = chan->getChannelName();
+    string message = string("channel ") 
+        + channelName
+        + " PvaClientPut::get "
+        + status.getMessage();
     throw std::runtime_error(message);
 }
 
 void PvaClientPut::issueGet()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPut was destroyed");
     if(connectState==connectIdle) connect();
     if(putState!=putIdle) {
-        string message = string("channel ") + channel->getChannelName()
+        Channel::shared_pointer chan(channel.lock());
+        string channelName("disconnected");
+        if(chan) channelName = chan->getChannelName();
+        string message = string("channel ")
+            + channelName
             +  "PvaClientPut::issueGet get or put aleady active ";
         throw std::runtime_error(message);
     }
     putState = getActive;
-    pvaClientData->getChangedBitSet()->clear();
     channelPut->get();
 }
 
 Status PvaClientPut::waitGet()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPut was destroyed");
     if(putState!=getActive){
-        string message = string("channel ") + channel->getChannelName()
-            +  " PvaClientPut::waitGet llegal put state";
+        Channel::shared_pointer chan(channel.lock());
+        string channelName("disconnected");
+        if(chan) channelName = chan->getChannelName();
+        string message = string("channel ")
+            + channelName
+            +  " PvaClientPut::waitGet illegal put state";
         throw std::runtime_error(message);
     }
     waitForGetPut.wait();
@@ -223,21 +319,28 @@ Status PvaClientPut::waitGet()
 
 void PvaClientPut::put()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPut was destroyed");
     issuePut();
     Status status = waitPut();
     if(status.isOK()) return;
-    string message = string("channel ") + channel->getChannelName()
-        + " PvaClientPut::put " + status.getMessage();
+    Channel::shared_pointer chan(channel.lock());
+    string channelName("disconnected");
+    if(chan) channelName = chan->getChannelName();
+    string message = string("channel ")
+        + channelName
+        + " PvaClientPut::put "
+        + status.getMessage();
     throw std::runtime_error(message);
 }
 
 void PvaClientPut::issuePut()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPut was destroyed");
     if(connectState==connectIdle) connect();
     if(putState!=putIdle) {
-         string message = string("channel ") + channel->getChannelName()
+         Channel::shared_pointer chan(channel.lock());
+         string channelName("disconnected");
+         if(chan) channelName = chan->getChannelName();
+         string message = string("channel ")
+            + channelName
             +  "PvaClientPut::issueGet get or put aleady active ";
          throw std::runtime_error(message);
     }
@@ -247,11 +350,14 @@ void PvaClientPut::issuePut()
 
 Status PvaClientPut::waitPut()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPut was destroyed");
     if(putState!=putActive){
-        string message = string("channel ") + channel->getChannelName()
-            +  " PvaClientPut::waitPut llegal put state";
-        throw std::runtime_error(message);
+         Channel::shared_pointer chan(channel.lock());
+         string channelName("disconnected");
+         if(chan) channelName = chan->getChannelName();
+         string message = string("channel ")
+            + channelName
+            +  " PvaClientPut::waitPut illegal put state";
+         throw std::runtime_error(message);
     }
     waitForGetPut.wait();
     putState = putIdle;
@@ -265,14 +371,5 @@ PvaClientPutDataPtr PvaClientPut::getData()
     return pvaClientData;
 }
 
-PvaClientPutPtr PvaClientPut::create(
-        PvaClientPtr const &pvaClient,
-        Channel::shared_pointer const & channel,
-        PVStructurePtr const &pvRequest)
-{
-    PvaClientPutPtr epv(new PvaClientPut(pvaClient,channel,pvRequest));
-    return epv;
-}
-
 
 }}

src/pvaClientPutData.cpp

@@ -8,15 +8,16 @@
  * @author mrk
  * @date 2015.02
  */
-#define epicsExportSharedSymbols
 
 #include <typeinfo>
-
 #include <sstream>
-#include <pv/pvaClient.h>
+
 #include <pv/createRequest.h>
 #include <pv/convert.h>
 
+#define epicsExportSharedSymbols
+
+#include <pv/pvaClient.h>
 
 using std::tr1::static_pointer_cast;
 using namespace epics::pvData;
@@ -27,15 +28,14 @@ namespace epics { namespace pvaClient {
 
 class PvaClientPostHandlerPvt: public PostHandler
 {
-    PvaClientPutData * easyData;
+    PvaClientPutData * putData;
     size_t fieldNumber;
 public:
-    PvaClientPostHandlerPvt(PvaClientPutData *easyData,size_t fieldNumber)
-    : easyData(easyData),fieldNumber(fieldNumber){}
-    void postPut() { easyData->postPut(fieldNumber);}
+    PvaClientPostHandlerPvt(PvaClientPutData *putData,size_t fieldNumber)
+    : putData(putData),fieldNumber(fieldNumber){}
+    void postPut() { putData->postPut(fieldNumber);}
 };
 
-
 typedef std::tr1::shared_ptr<PVArray> PVArrayPtr;
 static ConvertPtr convert = getConvert();
 static string noValue("no value field");

src/pvaClientPutGet.cpp

@@ -8,9 +8,10 @@
  * @author mrk
  * @date 2015.02
  */
+#include <pv/event.h>
+
 #define epicsExportSharedSymbols
 
-#include <pv/event.h>
 #include <pv/pvaClient.h>
 
 using std::tr1::static_pointer_cast;
@@ -22,48 +23,88 @@ namespace epics { namespace pvaClient {
 
 class ChannelPutGetRequesterImpl : public ChannelPutGetRequester
 {
-    PvaClientPutGet * pvaClientPutGet;
+    PvaClientPutGet::weak_pointer pvaClientPutGet;
+    PvaClient::weak_pointer pvaClient;
 public:
-    ChannelPutGetRequesterImpl(PvaClientPutGet * pvaClientPutGet)
-    : pvaClientPutGet(pvaClientPutGet) {}
-    string getRequesterName()
-    {return pvaClientPutGet->getRequesterName();}
-    void message(string const & message,MessageType messageType)
-    {pvaClientPutGet->message(message,messageType);}
-    void channelPutGetConnect(
-        const epics::pvData::Status& status,
-        epics::pvAccess::ChannelPutGet::shared_pointer const & channelPutGet,
-        epics::pvData::StructureConstPtr const & putStructure,
-        epics::pvData::StructureConstPtr const & getStructure)
-    {
-         pvaClientPutGet->channelPutGetConnect(status,channelPutGet,putStructure,getStructure);
+    ChannelPutGetRequesterImpl(
+        PvaClientPutGetPtr const & pvaClientPutGet,
+        PvaClientPtr const &pvaClient)
+    : pvaClientPutGet(pvaClientPutGet),
+      pvaClient(pvaClient)
+    {}
+    virtual ~ChannelPutGetRequesterImpl() {
+        if(PvaClient::getDebug()) std::cout << "~ChannelPutGetRequesterImpl" << std::endl;
     }
-    void putGetDone(
-        const epics::pvData::Status& status,
-        epics::pvAccess::ChannelPutGet::shared_pointer const & channelPutGet,
-        epics::pvData::PVStructurePtr const & getPVStructure,
-        epics::pvData::BitSetPtr const & getChangedBitSet)
-    {
-        pvaClientPutGet->putGetDone(status,channelPutGet,getPVStructure,getChangedBitSet);
+
+    virtual std::string getRequesterName() {
+        PvaClientPutGetPtr clientPutGet(pvaClientPutGet.lock());
+        if(!clientPutGet) return string("clientPutGet is null");
+        return clientPutGet->getRequesterName();
     }
-    void getPutDone(
-        const epics::pvData::Status& status,
-        epics::pvAccess::ChannelPutGet::shared_pointer const & channelPutGet,
-        epics::pvData::PVStructurePtr const & putPVStructure,
-        epics::pvData::BitSet::shared_pointer const & putBitSet)
-    {
-        pvaClientPutGet->getPutDone(status,channelPutGet,putPVStructure,putBitSet);
+
+    virtual void message(std::string const & message, epics::pvData::MessageType messageType) {
+        PvaClientPutGetPtr clientPutGet(pvaClientPutGet.lock());
+        if(!clientPutGet) return;
+        clientPutGet->message(message,messageType);
     }
-    void getGetDone(
-        const epics::pvData::Status& status,
-        epics::pvAccess::ChannelPutGet::shared_pointer const & channelPutGet,
-        epics::pvData::PVStructurePtr const & getPVStructure,
-        epics::pvData::BitSet::shared_pointer const & getChangedBitSet)
+
+    virtual void channelPutGetConnect(
+        const Status& status,
+        ChannelPutGet::shared_pointer const & channelPutGet,
+        Structure::const_shared_pointer const & putStructure,
+        Structure::const_shared_pointer const & getStructure)
     {
-        pvaClientPutGet->getGetDone(status,channelPutGet,getPVStructure,getChangedBitSet);
+        PvaClientPutGetPtr clientPutGet(pvaClientPutGet.lock());
+        if(!clientPutGet) return;
+        clientPutGet->channelPutGetConnect(status,channelPutGet,putStructure,getStructure);  
+    }
+
+    virtual void putGetDone(
+        const Status& status,
+        ChannelPutGet::shared_pointer const & channelPutGet,
+        PVStructurePtr const & getPVStructure,
+        BitSet::shared_pointer const & getBitSet)
+    {
+        PvaClientPutGetPtr clientPutGet(pvaClientPutGet.lock());
+        if(!clientPutGet) return;
+        clientPutGet->putGetDone(status,channelPutGet,getPVStructure,getBitSet);
+    }
+
+    virtual void getPutDone(
+        const Status& status,
+        ChannelPutGet::shared_pointer const & channelPutGet,
+        PVStructurePtr const & putPVStructure,
+        BitSet::shared_pointer const & putBitSet)
+    {
+        PvaClientPutGetPtr clientPutGet(pvaClientPutGet.lock());
+        if(!clientPutGet) return;
+        clientPutGet->getPutDone(status,channelPutGet,putPVStructure,putBitSet);
+    }
+
+
+    virtual void getGetDone(
+        const Status& status,
+        ChannelPutGet::shared_pointer const & channelPutGet,
+        PVStructurePtr const & getPVStructure,
+        BitSet::shared_pointer const & getBitSet)
+    {
+        PvaClientPutGetPtr clientPutGet(pvaClientPutGet.lock());
+        if(!clientPutGet) return;
+        clientPutGet->getGetDone(status,channelPutGet,getPVStructure,getBitSet);
     }
 };
 
+PvaClientPutGetPtr PvaClientPutGet::create(
+        PvaClientPtr const &pvaClient,
+        Channel::shared_pointer const & channel,
+        PVStructurePtr const &pvRequest)
+{
+    PvaClientPutGetPtr epv(new PvaClientPutGet(pvaClient,channel,pvRequest));
+    epv->channelPutGetRequester = ChannelPutGetRequesterImplPtr(
+        new ChannelPutGetRequesterImpl(epv,pvaClient));
+    return epv;
+}
+
 PvaClientPutGet::PvaClientPutGet(
         PvaClientPtr const &pvaClient,
         Channel::shared_pointer const & channel,
@@ -71,39 +112,48 @@ PvaClientPutGet::PvaClientPutGet(
 : pvaClient(pvaClient),
   channel(channel),
   pvRequest(pvRequest),
-  isDestroyed(false),
   connectState(connectIdle),
   putGetState(putGetIdle)
 {
+    if(PvaClient::getDebug()) {
+         cout<< "PvaClientPutGet::PvaClientPutGet"
+             << " channelName " << channel->getChannelName() 
+             << endl;
+    }
 }
 
 PvaClientPutGet::~PvaClientPutGet()
 {
-    destroy();
+    if(PvaClient::getDebug()) {
+        string channelName("disconnected");
+        Channel::shared_pointer chan(channel.lock());
+        if(chan) channelName = chan->getChannelName();
+        cout<< "PvaClientPutGet::~PvaClientPutGet"
+           << " channelName " << channelName
+           << endl;
+    }
+    channelPutGet->destroy();
 }
 
 void PvaClientPutGet::checkPutGetState()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPutGet was destroyed");
     if(connectState==connectIdle){
         connect();
         getPut();
     }
 }
 
-// from ChannelPutGetRequester
 string PvaClientPutGet::getRequesterName()
 {
      PvaClientPtr yyy = pvaClient.lock();
-     if(!yyy) throw std::runtime_error("pvaClient was destroyed");
+     if(!yyy) return string("PvaClientPutGet::getRequesterName() PvaClient isDestroyed");
      return yyy->getRequesterName();
 }
 
 void PvaClientPutGet::message(string const & message,MessageType messageType)
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPutGet was destroyed");
     PvaClientPtr yyy = pvaClient.lock();
-    if(!yyy) throw std::runtime_error("pvaClient was destroyed");
+    if(!yyy) return;
     yyy->message(message, messageType);
 }
 
@@ -113,14 +163,19 @@ void PvaClientPutGet::channelPutGetConnect(
     StructureConstPtr const & putStructure,
     StructureConstPtr const & getStructure)
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPutGet was destroyed");
+    if(PvaClient::getDebug()) {
+        cout << "PvaClientPutGet::channelPutGetConnect"
+           << " channelName " << channelPutGet->getChannel()->getChannelName()
+           << " status.isOK " << (status.isOK() ? "true" : "false")
+           << endl;
+    }
     channelPutGetConnectStatus = status;
     this->channelPutGet = channelPutGet;
     if(status.isOK()) {
         pvaClientPutData = PvaClientPutData::create(putStructure);
-        pvaClientPutData->setMessagePrefix(channel->getChannelName());
+        pvaClientPutData->setMessagePrefix(channelPutGet->getChannel()->getChannelName());
         pvaClientGetData = PvaClientGetData::create(getStructure);
-        pvaClientGetData->setMessagePrefix(channel->getChannelName());
+        pvaClientGetData->setMessagePrefix(channelPutGet->getChannel()->getChannelName());
     }
     waitForConnect.signal();
     
@@ -132,7 +187,15 @@ void PvaClientPutGet::putGetDone(
         PVStructurePtr const & getPVStructure,
         BitSetPtr const & getChangedBitSet)
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPutGet was destroyed");
+    if(PvaClient::getDebug()) {
+        string channelName("disconnected");
+        Channel::shared_pointer chan(channel.lock());
+        if(chan) channelName = chan->getChannelName();
+        cout << "PvaClientPutGet::putGetDone"
+           << " channelName " << channelName
+           << " status.isOK " << (status.isOK() ? "true" : "false")
+           << endl;
+    }
     channelPutGetStatus = status;
     if(status.isOK()) {
         pvaClientGetData->setData(getPVStructure,getChangedBitSet);
@@ -146,7 +209,15 @@ void PvaClientPutGet::getPutDone(
     PVStructurePtr const & putPVStructure,
     BitSetPtr const & putBitSet)
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPutGet was destroyed");
+    if(PvaClient::getDebug()) {
+        string channelName("disconnected");
+        Channel::shared_pointer chan(channel.lock());
+        if(chan) channelName = chan->getChannelName();
+        cout << "PvaClientPutGet::getPutDone"
+           << " channelName " << channelName
+           << " status.isOK " << (status.isOK() ? "true" : "false")
+           << endl;
+    }
     channelPutGetStatus = status;
     if(status.isOK()) {
         PVStructurePtr pvs = pvaClientPutData->getPVStructure();
@@ -164,7 +235,15 @@ void PvaClientPutGet::getGetDone(
         PVStructurePtr const & getPVStructure,
         BitSetPtr const & getChangedBitSet)
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPutGet was destroyed");
+    if(PvaClient::getDebug()) {
+        string channelName("disconnected");
+        Channel::shared_pointer chan(channel.lock());
+        if(chan) channelName = chan->getChannelName();
+        cout << "PvaClientPutGet::getGetDone"
+           << " channelName " << channelName
+           << " status.isOK " << (status.isOK() ? "true" : "false")
+           << endl;
+    }
     channelPutGetStatus = status;
     if(status.isOK()) {
         pvaClientGetData->setData(getPVStructure,getChangedBitSet);
@@ -172,51 +251,55 @@ void PvaClientPutGet::getGetDone(
     waitForPutGet.signal();
 }
 
-
-
-// from PvaClientPutGet
-void PvaClientPutGet::destroy()
-{
-    {
-        Lock xx(mutex);
-        if(isDestroyed) return;
-        isDestroyed = true;
-    }
-    if(channelPutGet) channelPutGet->destroy();
-    channelPutGet.reset();
-}
-
 void PvaClientPutGet::connect()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPutGet was destroyed");
     issueConnect();
     Status status = waitConnect();
     if(status.isOK()) return;
-    string message = string("channel ") + channel->getChannelName()
-        + " PvaClientPutGet::connect " + status.getMessage();
+    Channel::shared_pointer chan(channel.lock());
+    string channelName("disconnected");
+    if(chan) channelName = chan->getChannelName();
+    string message = string("channel ") 
+        + channelName
+        + " PvaClientPutGet::connect "
+        + status.getMessage();
     throw std::runtime_error(message);
 }
 
 void PvaClientPutGet::issueConnect()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPutGet was destroyed");
+    Channel::shared_pointer chan(channel.lock());
     if(connectState!=connectIdle) {
-        string message = string("channel ") + channel->getChannelName()
+        string channelName("disconnected");
+        if(chan) channelName = chan->getChannelName();
+        string message = string("channel ") + channelName
             + " pvaClientPutGet already connected ";
         throw std::runtime_error(message);
     }
-    putGetRequester = ChannelPutGetRequester::shared_pointer(new ChannelPutGetRequesterImpl(this));
-    connectState = connectActive;
-    channelPutGet = channel->createChannelPutGet(putGetRequester,pvRequest);
+    if(chan) {
+        connectState = connectActive;
+        channelPutGet = chan->createChannelPutGet(channelPutGetRequester,pvRequest);
+        return;
+    }
+    throw std::runtime_error("PvaClientPutGet::issueConnect() but channel disconnected");
 }
 
 Status PvaClientPutGet::waitConnect()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPutGet was destroyed");
-    if(connectState!=connectActive) {
-        string message = string("channel ") + channel->getChannelName()
-            + " pvaClientPutGet illegal connect state ";
-        throw std::runtime_error(message);
+    {
+         Lock xx(mutex);
+         if(connectState==connected) {
+             if(!channelPutGetConnectStatus.isOK()) connectState = connectIdle;
+             return channelPutGetConnectStatus;
+        }
+        if(connectState!=connectActive)  {
+            Channel::shared_pointer chan(channel.lock());
+            string channelName("disconnected");
+            if(chan) channelName = chan->getChannelName();
+            string message = string("channel ") + channelName
+                + " PvaClientPutGet::waitConnect illegal connect state ";
+            throw std::runtime_error(message);
+        }
     }
     waitForConnect.wait();
     connectState = channelPutGetConnectStatus.isOK() ? connected : connectIdle;
@@ -226,22 +309,28 @@ Status PvaClientPutGet::waitConnect()
 
 void PvaClientPutGet::putGet()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPutGet was destroyed");
     issuePutGet();
     Status status = waitPutGet();
     if(status.isOK()) return;
-    string message = string("channel ") + channel->getChannelName()
-        + " PvaClientPutGet::putGet " + status.getMessage();
+    Channel::shared_pointer chan(channel.lock());
+    string channelName("disconnected");
+    if(chan) channelName = chan->getChannelName();
+    string message = string("channel ") 
+        + channelName
+        + " PvaClientPut::putGet "
+        + status.getMessage();
     throw std::runtime_error(message);
 }
 
 void PvaClientPutGet::issuePutGet()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPutGet was destroyed");
     if(connectState==connectIdle) connect();
     if(putGetState!=putGetIdle) {
-        string message = string("channel ") + channel->getChannelName()
-            + " PvaClientPutGet::issueGet get or put aleady active ";
+        Channel::shared_pointer chan(channel.lock());
+        string channelName("disconnected");
+        if(chan) channelName = chan->getChannelName();
+        string message = string("channel ") + channelName
+            + " PvaClientPutGet::issuePutGet get or put aleady active ";
         throw std::runtime_error(message);
     }
     putGetState = putGetActive;
@@ -251,10 +340,12 @@ void PvaClientPutGet::issuePutGet()
 
 Status PvaClientPutGet::waitPutGet()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPutGet was destroyed");
     if(putGetState!=putGetActive){
-        string message = string("channel ") + channel->getChannelName()
-            + " PvaClientPutGet::waitPutGet llegal put state";
+        Channel::shared_pointer chan(channel.lock());
+        string channelName("disconnected");
+        if(chan) channelName = chan->getChannelName();
+        string message = string("channel ") + channelName
+            + " PvaClientPutGet::waitPutGet get or put aleady active ";
         throw std::runtime_error(message);
     }
     waitForPutGet.wait();
@@ -264,22 +355,28 @@ Status PvaClientPutGet::waitPutGet()
 
 void PvaClientPutGet::getGet()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPutGet was destroyed");
     issueGetGet();
     Status status = waitGetGet();
     if(status.isOK()) return;
-    string message = string("channel ") + channel->getChannelName()
-        + " PvaClientPutGet::getGet " + status.getMessage();
+    Channel::shared_pointer chan(channel.lock());
+    string channelName("disconnected");
+    if(chan) channelName = chan->getChannelName();
+    string message = string("channel ") 
+        + channelName
+        + " PvaClientPut::getGet "
+        + status.getMessage();
     throw std::runtime_error(message);
 }
 
 void PvaClientPutGet::issueGetGet()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPutGet was destroyed");
     if(connectState==connectIdle) connect();
     if(putGetState!=putGetIdle) {
-        string message = string("channel ") + channel->getChannelName()
-            + " PvaClientPutGet::issueGetGet aleady active ";
+        Channel::shared_pointer chan(channel.lock());
+        string channelName("disconnected");
+        if(chan) channelName = chan->getChannelName();
+        string message = string("channel ") + channelName
+            + " PvaClientPutGet::issueGetGet get or put aleady active ";
         throw std::runtime_error(message);
     }
     putGetState = putGetActive;
@@ -288,10 +385,12 @@ void PvaClientPutGet::issueGetGet()
 
 Status PvaClientPutGet::waitGetGet()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPutGet was destroyed");
     if(putGetState!=putGetActive){
-        string message = string("channel ") + channel->getChannelName()
-            + " PvaClientPutGet::waitGetGet illegal state";
+        Channel::shared_pointer chan(channel.lock());
+        string channelName("disconnected");
+        if(chan) channelName = chan->getChannelName();
+        string message = string("channel ") + channelName
+            + " PvaClientPutGet::waitGetGet get or put aleady active ";
         throw std::runtime_error(message);
     }
     waitForPutGet.wait();
@@ -301,22 +400,28 @@ Status PvaClientPutGet::waitGetGet()
 
 void PvaClientPutGet::getPut()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPutGet was destroyed");
     issueGetPut();
     Status status = waitGetPut();
     if(status.isOK()) return;
-    string message = string("channel ") + channel->getChannelName()
-        + " PvaClientPutGet::getPut " + status.getMessage();
+    Channel::shared_pointer chan(channel.lock());
+    string channelName("disconnected");
+    if(chan) channelName = chan->getChannelName();
+    string message = string("channel ") 
+        + channelName
+        + " PvaClientPut::getPut "
+        + status.getMessage();
     throw std::runtime_error(message);
 }
 
 void PvaClientPutGet::issueGetPut()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPutGet was destroyed");
     if(connectState==connectIdle) connect();
     if(putGetState!=putGetIdle) {
-        string message = string("channel ") + channel->getChannelName()
-            + " PvaClientPutGet::issueGetPut aleady active ";
+        Channel::shared_pointer chan(channel.lock());
+        string channelName("disconnected");
+        if(chan) channelName = chan->getChannelName();
+        string message = string("channel ") + channelName
+            + " PvaClientPutGet::issueGetPut get or put aleady active ";
         throw std::runtime_error(message);
     }
     putGetState = putGetActive;
@@ -325,10 +430,12 @@ void PvaClientPutGet::issueGetPut()
 
 Status PvaClientPutGet::waitGetPut()
 {
-    if(isDestroyed) throw std::runtime_error("pvaClientPutGet was destroyed");
     if(putGetState!=putGetActive){
-         string message = string("channel ") + channel->getChannelName()
-            + " PvaClientPutGet::waitGetPut illegal state";
+        Channel::shared_pointer chan(channel.lock());
+        string channelName("disconnected");
+        if(chan) channelName = chan->getChannelName();
+        string message = string("channel ") + channelName
+            + " PvaClientPutGet::waitGetPut get or put aleady active ";
         throw std::runtime_error(message);
     }
     waitForPutGet.wait();
@@ -348,14 +455,4 @@ PvaClientPutDataPtr PvaClientPutGet::getPutData()
     return pvaClientPutData;
 }
 
-PvaClientPutGetPtr PvaClientPutGet::create(
-        PvaClientPtr const &pvaClient,
-        Channel::shared_pointer const & channel,
-        PVStructurePtr const &pvRequest)
-{
-    PvaClientPutGetPtr epv(new PvaClientPutGet(pvaClient,channel,pvRequest));
-    return epv;
-}
-
-
 }}

src/pvaClientRPC.cpp

@@ -0,0 +1,344 @@
+/* pvaClientRPC.cpp */
+/**
+ * Copyright - See the COPYRIGHT that is included with this distribution.
+ * EPICS pvData is distributed subject to a Software License Agreement found
+ * in file LICENSE that is included with this distribution.
+ */
+/**
+ * @author mrk
+ * @date 2015.03
+ */
+
+#include <sstream>
+#include <pv/event.h>
+#include <pv/bitSetUtil.h>
+
+#define epicsExportSharedSymbols
+
+#include <pv/pvaClient.h>
+
+using std::tr1::static_pointer_cast;
+using std::tr1::dynamic_pointer_cast;
+using namespace epics::pvData;
+using namespace epics::pvAccess;
+using namespace std;
+
+namespace epics { namespace pvaClient {
+
+class RPCRequesterImpl : public ChannelRPCRequester
+{
+    PvaClientRPC::weak_pointer pvaClientRPC;
+    PvaClient::weak_pointer pvaClient;
+public:
+    RPCRequesterImpl(
+        PvaClientRPCPtr const & pvaClientRPC,
+        PvaClientPtr const &pvaClient)
+    : pvaClientRPC(pvaClientRPC),
+      pvaClient(pvaClient)
+    {}
+    virtual ~RPCRequesterImpl() {
+        if(PvaClient::getDebug()) std::cout << "~RPCRequesterImpl" << std::endl;
+    }
+
+    virtual std::string getRequesterName() {
+        PvaClientRPCPtr clientRPC(pvaClientRPC.lock());
+        if(!clientRPC) return string("pvaClientRPC is null");
+        return clientRPC->getRequesterName();
+    }
+
+    virtual void message(std::string const & message, epics::pvData::MessageType messageType) {
+        PvaClientRPCPtr clientRPC(pvaClientRPC.lock());
+        if(!clientRPC) return;
+        clientRPC->message(message,messageType);
+    }
+
+    virtual void channelRPCConnect(
+        const epics::pvData::Status& status,
+        ChannelRPC::shared_pointer const & channelRPC)
+    {
+        PvaClientRPCPtr clientRPC(pvaClientRPC.lock());
+        if(!clientRPC) return;
+        clientRPC->rpcConnect(status,channelRPC);
+    }
+
+    virtual void requestDone(
+        const Status& status,
+        ChannelRPC::shared_pointer const & channelRPC,
+        PVStructure::shared_pointer const & pvResponse)
+    {
+        PvaClientRPCPtr clientRPC(pvaClientRPC.lock());
+        if(!clientRPC) return;
+        clientRPC->requestDone(status,channelRPC,pvResponse);
+    }
+};
+
+PvaClientRPCPtr PvaClientRPC::create(
+        PvaClientPtr const &pvaClient,
+        Channel::shared_pointer const & channel)
+{
+     StructureConstPtr structure(getFieldCreate()->createStructure());
+     PVStructurePtr pvRequest(getPVDataCreate()->createPVStructure(structure));
+     return create(pvaClient,channel,pvRequest);
+}
+PvaClientRPCPtr PvaClientRPC::create(
+        PvaClientPtr const &pvaClient,
+        Channel::shared_pointer const & channel,
+        PVStructurePtr const &pvRequest)
+{
+    PvaClientRPCPtr epv(new PvaClientRPC(pvaClient,channel,pvRequest));
+    epv->rpcRequester = RPCRequesterImplPtr(
+        new RPCRequesterImpl(epv,pvaClient));
+    return epv;
+}
+
+PvaClientRPC::PvaClientRPC(
+        PvaClientPtr const &pvaClient,
+        Channel::shared_pointer const & channel,
+        PVStructurePtr const &pvRequest)
+: 
+  connectState(connectIdle),
+  pvaClient(pvaClient),
+  channel(channel),
+  pvRequest(pvRequest),
+  rpcState(rpcIdle),
+  responseTimeout(0.0)
+{
+    if(PvaClient::getDebug()) {
+         cout<< "PvaClientRPC::PvaClientRPC()"
+             << " channelName " << channel->getChannelName() 
+             << endl;
+    }
+}
+
+PvaClientRPC::~PvaClientRPC()
+{
+    if(PvaClient::getDebug()) {
+        string channelName("disconnected");
+        Channel::shared_pointer chan(channel.lock());
+        if(chan) channelName = chan->getChannelName();
+        cout<< "PvaClientRPC::~PvaClientRPC"
+           << " channelName " << channelName
+           << endl;
+    }
+}
+
+void PvaClientRPC::checkRPCState()
+{
+    if(PvaClient::getDebug()) {
+        string channelName("disconnected");
+        Channel::shared_pointer chan(channel.lock());
+        if(chan) channelName = chan->getChannelName();
+        cout << "PvaClientRPC::checkRPCState"
+           << " channelName " << channelName
+           << " connectState " << connectState
+           << endl;
+    }
+    if(connectState==connectIdle) connect();
+}
+
+string PvaClientRPC::getRequesterName()
+{
+     PvaClientPtr yyy = pvaClient.lock();
+     if(!yyy) return string("PvaClientRPC::getRequesterName() PvaClient isDestroyed");
+     return yyy->getRequesterName();
+}
+
+void PvaClientRPC::message(string const & message,MessageType messageType)
+{
+    PvaClientPtr yyy = pvaClient.lock();
+    if(!yyy) return;
+    yyy->message(message, messageType);
+}
+
+void PvaClientRPC::rpcConnect(
+    const Status& status,
+    ChannelRPC::shared_pointer const & channelRPC)
+{
+    Channel::shared_pointer chan(channel.lock());
+    if(PvaClient::getDebug()) {
+        string channelName("disconnected");
+        Channel::shared_pointer chan(channel.lock());
+        if(chan) channelName = chan->getChannelName();
+        cout << "PvaClientRPC::rpcConnect"
+           << " channelName " << channelName
+           << " status.isOK " << (status.isOK() ? "true" : "false")
+           << endl;
+    }
+    if(!chan) return;
+    connectStatus = status;
+    connectState = connected;
+    if(PvaClient::getDebug()) {
+         cout << "PvaClientRPC::rpcConnect calling waitForConnect.signal\n";
+    }
+    waitForConnect.signal();
+    
+}
+
+void PvaClientRPC::requestDone(
+        const Status& status,
+        ChannelRPC::shared_pointer const & channelRPC,
+        PVStructure::shared_pointer const & pvResponse)
+{
+    PvaClientRPCRequesterPtr req = pvaClientRPCRequester.lock();
+    {
+        Lock xx(mutex);
+        if(PvaClient::getDebug()) {
+             string channelName("disconnected");
+             Channel::shared_pointer chan(channel.lock());
+             if(chan) channelName = chan->getChannelName();
+             cout << "PvaClientRPC::requestDone"
+                  << " channelName " << channelName
+                  << endl;
+        }
+        if(rpcState!=rpcActive) {
+             string channelName("disconnected");
+             Channel::shared_pointer chan(channel.lock());
+             if(chan) channelName = chan->getChannelName();
+             string message = "channel "
+                 + channelName 
+                 +" PvaClientRPC::requestDone"
+                 + " but not active";
+             throw std::runtime_error(message);
+        }
+        if(req && (responseTimeout<=0.0)) {
+            rpcState = rpcIdle;
+        } else {
+            rpcState = rpcComplete;
+            if(!req) this->pvResponse = pvResponse;
+            waitForDone.signal();
+        }
+    }
+    if(req) {
+        req->requestDone(status,shared_from_this(),pvResponse);
+    }
+}
+
+void PvaClientRPC::connect()
+{
+    if(PvaClient::getDebug()) cout << "PvaClientRPC::connect\n";
+    issueConnect();
+    Status status = waitConnect();
+    if(status.isOK()) return;
+    Channel::shared_pointer chan(channel.lock());
+    string channelName("disconnected");
+    if(chan) channelName = chan->getChannelName();
+    string message = string("channel ") 
+        + channelName
+        + " PvaClientRPC::connect "
+        + status.getMessage();
+    throw std::runtime_error(message);
+}
+
+void PvaClientRPC::issueConnect()
+{
+    if(PvaClient::getDebug()) cout << "PvaClientRPC::issueConnect\n";
+    Channel::shared_pointer chan(channel.lock());
+    if(connectState!=connectIdle) {
+        string channelName("disconnected");
+        if(chan) channelName = chan->getChannelName();
+        string message = string("channel ")
+            + channelName 
+            + " pvaClientRPC already connected ";
+        throw std::runtime_error(message);
+    }
+    if(chan) {
+        connectState = connectActive;
+        channelRPC = chan->createChannelRPC(rpcRequester,pvRequest);
+        return;
+    }
+    throw std::runtime_error("PvaClientRPC::issueConnect() but channel disconnected");
+}
+
+Status PvaClientRPC::waitConnect()
+{
+    if(PvaClient::getDebug()) cout << "PvaClientRPC::waitConnect\n";
+    if(connectState==connected) {
+         if(!connectStatus.isOK()) connectState = connectIdle;
+         return connectStatus;
+    }
+    if(connectState!=connectActive) {
+        Channel::shared_pointer chan(channel.lock());
+        string channelName("disconnected");
+        if(chan) channelName = chan->getChannelName();
+        string message = string("channel ")
+            + channelName
+            + " PvaClientRPC::waitConnect illegal connect state ";
+        throw std::runtime_error(message);
+    }
+    if(PvaClient::getDebug()) {
+        cout << "PvaClientRPC::waitConnect calling waitForConnect.wait\n";
+    }
+    waitForConnect.wait();
+    connectState = connectStatus.isOK() ? connected : connectIdle;
+    if(PvaClient::getDebug()) {
+        cout << "PvaClientRPC::waitConnect"
+             << " connectStatus " << (connectStatus.isOK() ? "connected" : "not connected");
+    }
+    return connectStatus;
+}
+
+PVStructure::shared_pointer PvaClientRPC::request(PVStructure::shared_pointer const & pvArgument)
+{
+    checkRPCState();
+    {
+        Lock xx(mutex);
+        if(rpcState!=rpcIdle) {
+            Channel::shared_pointer chan(channel.lock());
+            string channelName("disconnected");
+            if(chan) channelName = chan->getChannelName();
+            string message = "channel "
+                + channelName
+                + " PvaClientRPC::request request aleady active ";
+            throw std::runtime_error(message);
+        }
+        rpcState = rpcActive;
+    }
+    channelRPC->request(pvArgument);
+    if(responseTimeout>0.0) {
+        waitForDone.wait(responseTimeout);
+    } else {
+        waitForDone.wait();
+    }
+    Lock xx(mutex);
+    if(rpcState!=rpcComplete) {
+        Channel::shared_pointer chan(channel.lock());
+            string channelName("disconnected");
+            if(chan) channelName = chan->getChannelName();
+        string message = "channel "
+            + channelName
+            + " PvaClientRPC::request request timeout ";
+        throw std::runtime_error(message);
+    }
+    rpcState = rpcIdle;
+    return pvResponse;
+}
+
+
+void PvaClientRPC::request(
+    PVStructure::shared_pointer const & pvArgument,
+    PvaClientRPCRequesterPtr const & pvaClientRPCRequester)
+{
+    checkRPCState();   
+    this->pvaClientRPCRequester = pvaClientRPCRequester;
+    if(responseTimeout<=0.0) {
+         {
+             Lock xx(mutex);
+             if(rpcState!=rpcIdle) {
+                 Channel::shared_pointer chan(channel.lock());
+                 string channelName("disconnected");
+                 if(chan) channelName = chan->getChannelName();
+                 string message = "channel "
+                    + channelName
+                    + " PvaClientRPC::request request aleady active ";
+                 throw std::runtime_error(message);
+            }
+            rpcState = rpcActive;
+        }
+        channelRPC->request(pvArgument);
+        return;
+    }
+    request(pvArgument);
+}
+
+
+}}