User manual

Chapter 13: ESS for SAS 73
open an interactive PROC INSIGHT session on the SAS dataset near
point
C-F10 C-F10 toggle-listing
toggle ESS[SAS] for ‘.lst’ files; useful for toggling read-only
SUBMIT, PROGRAM, LOG and OUTPUT need no further explanation since they mimic the SAS
Display Manager commands and related function key definitions. However, six other keys
have been provided for convenience and are described below.
‘shell’ switches you to the ‘*shell*’ buffer where you can interact with your operating
system. This is especially helpful if you would like to kill a SAS batch job. You can specify a
different buffer name to associate with a SAS batch job (besides ‘*shell*’) with the buffer-
local variable ess-sas-shell-buffer. This allows you to have multiple buffers running
SAS batch jobs on multiple local/remote computers that may rely on different methods
specified by the buffer-local variable ess-sas-submit-method.
F2 performs the ‘refresh’ operation on the current buffer. ‘refresh’ compares the
buffer’s last modified date/time with the file’s last modified date/time and replaces the
buffer with the file if the file is newer. This is the same operation that is automatically
performed when LOG, OUTPUT, ‘filetype-1’ or F11 are pressed.
‘filetype-1’ switches you to a file with the same file name as your ‘.sas’ file, but with
a different extension (‘.txt’ by default) and performs ‘refresh’. You can over-ride the
default extension; for example in your ‘~/.emacs’ or ‘~/.xemacs/init.el’ file:
(setq ess-sas-suffix-1 "csv") ; for example
F9 will prompt you for the name of a permanent SAS dataset near point to be opened
for viewing by PROC FSEDIT. You can control the SAS batch command-line with ess-
sas-data-view-submit-options. For controlling the SAS batch commands, you have the
global variables ess-sas-data-view-libname and ess-sas-data-view-fsview-command
as well as the buffer-local variable ess-sas-data-view-fsview-statement. If you have
your SAS LIBNAME defined in ‘~/autoexec.sas’, then the defaults for these variables should
be sufficient.
Similarly, C-F9 will prompt you for the name of a permanent SAS dataset near point
to be opened for viewing by PROC INSIGHT. You can control the SAS batch command-line
with ess-sas-data-view-submit-options. For controlling the SAS batch commands, you
have the global variables ess-sas-data-view-libname and ess-sas-data-view-insight-
command as well as the buffer-local variable ess-sas-data-view-insight-statement.
F10 toggles ESS[SAS] mode for ‘.log’ files which is off by default (technically, it is
SAS-log-mode, but it looks the same). The syntax highlighting can be helpful in certain
debugging situations, but large ‘.log’ files may take a long time to highlight.
F11 is the same as ‘filetype-1’ except it is ‘.dat’ by default.
F12 will prompt you for the name of a GSASFILE near the point in ‘.log’ to be opened
for viewing either with emacs or with an external viewer. Depending on your version of
emacs and the operating system you are using, emacs may support ‘.gif’ and ‘.jpg’ files
internally. You may need to change the following variables for your own situation. ess-sas-
graph-view-suffix-regexp is a regular expression of supported file types defined via file
name extensions. ess-sas-graph-view-viewer-default is the default external viewer for
your platform. ess-sas-graph-view-viewer-alist is an alist of exceptions to the default;
i.e. file types and their associated viewers which will be used rather than the default viewer.