Merge pull request #376 from BCDA-APS/357-examples

apsbss: example beam line-specific shell scripts

docs/source/applications/apsbss.rst

@@ -436,6 +436,21 @@ Start caQtDM with this command: ``caQtDM -macro "P=9id:bss:" apsbss.ui &``
 
 Start MEDM with this command: ``medm -x -macro "P=9id:bss:" apsbss.ui &``
 
+Here's an example starter script for caQtDM from APS 9-ID-C (USAXS):
+
+.. code-block:: bash
+
+    #!/bin/bash
+
+    BLUESKY_ROOT=/APSshare/anaconda3/Bluesky
+    APSTOOLS_PKG=${BLUESKY_ROOT}/lib/python3.7/site-packages/apstools
+    GUI_SCREEN=${APSTOOLS_PKG}/beamtime/apsbss.ui
+    CAQTDM=/APSshare/bin/caQtDM
+
+    source ${BLUESKY_ROOT}/bin/activate
+    ${CAQTDM} -macro P=9idc:bss: ${GUI_SCREEN} &
+
+
 IOC Management
 ++++++++++++++
 

docs/source/applications/apsbss_ioc.rst

@@ -165,4 +165,26 @@ from EPICS base, use the supplied IOC management shell script
 .. note:: The ``softIoc`` application is run within a ``screen``
     session so that it remains running even if you close the
     console session.  Confirm that you have the ``screen`` application
-    first before trying to start the IOC.
+    first before trying to start the IOC.
+
+
+Here's an example starter script for the IOC from APS 9-ID-C (USAXS):
+
+.. code-block:: bash
+
+    #!/bin/bash
+
+    PROCESS_NAME=ioc9idcbss
+    IOC_PREFIX=9idc:bss:
+
+    # need shell script and EPICS database file
+    BLUESKY=/APSshare/anaconda3/Bluesky
+    APSTOOLS=${BLUESKY}/lib/python3.7/site-packages/apstools
+
+    source ${BLUESKY}/bin/activate base
+
+    # need EPICS base/bin/softIoc from this path
+    export PATH=${PATH}:/APSshare/epics/base-7.0.3/bin/${EPICS_HOST_ARCH}
+
+    cd "${APSTOOLS}"/beamtime
+    ./apsbss_ioc.sh  "${@}"  "${PROCESS_NAME}" "${IOC_PREFIX}"