Rename DEBUG variable and add to RTD

- Rename DEBUG to DEBUG_SCHEDULER.
- Add note that it's PBS only and that it sets debug=true.
- Add switch to documentation.

Refs #619

docs/source/configure.rst

@@ -9,6 +9,8 @@ The global-workflow configs contain switches that change how the system runs. Ma
 +================+==================================+===============+=============+===================================================+
 | APP            | Model application                | ATM           | YES         | See case block in config.base for options         |
 +----------------+----------------------------------+---------------+-------------+---------------------------------------------------+
+| DEBUG_SCHEDULER| Debug option for PBS scheduler   | NO            | YES         | Sets debug=true for additional logging            |
++----------------+----------------------------------+---------------+-------------+---------------------------------------------------+
 | DOIAU          | Enable 4DIAU for control         | YES           | NO          | Turned off for cold-start first half cycle        |
 |                | with 3 increments                |               |             |                                                   |
 +----------------+----------------------------------+---------------+-------------+---------------------------------------------------+

parm/config/gefs/config.base

@@ -75,7 +75,7 @@ export NMV="/bin/mv"
 export NLN="/bin/ln -sf"
 export VERBOSE="YES"
 export KEEPDATA="NO"
-export DEBUG="NO" # Only works on WCOSS2
+export DEBUG_SCHEDULER="NO" # PBS only; sets debug=true
 export CHGRP_RSTPROD="@CHGRP_RSTPROD@"
 export CHGRP_CMD="@CHGRP_CMD@"
 export NCDUMP="${NETCDF:-${netcdf_c_ROOT:-}}/bin/ncdump"

parm/config/gfs/config.base

@@ -86,7 +86,7 @@ export NMV="/bin/mv"
 export NLN="/bin/ln -sf"
 export VERBOSE="YES"
 export KEEPDATA="NO"
-export DEBUG="NO" # Only works on WCOSS2
+export DEBUG_SCHEDULER="NO" # PBS only; sets debug=true
 export CHGRP_RSTPROD="@CHGRP_RSTPROD@"
 export CHGRP_CMD="@CHGRP_CMD@"
 export NCDUMP="${NETCDF:-${netcdf_c_ROOT:-}}/bin/ncdump"