Category Archives: Business Intelligence

SAS Framework Data Server

SASComparing my SAS 9.2 and 9.3 Enterprise Business Intelligence (EBI) environments, a notable difference between daemons started by the sas.servers script was identified.  In 9.2, we had a SAS Table Server daemon.  It was not available in our 9.1.3 EBI installation, and was released in the 9.2 version.  Apparently SAS removed it from the 9.3 architecture, but a new daemon, the SAS Framework Data Server, was introduced in its place.  There is scant documentation available on support.sas.com about utilizing or administering the Framework Data Server.

What is SAS Table Server?

from the SAS 9.2 Table Server Administrator’s Guide

The SAS Table Server is a data server that provides scalable, threaded, multi-user, and standards-based data access technology in order to process and seamlessly integrate data from multiple data sources. The server acts as a hub that provides clients with data by accessing, managing, and sharing SAS data as well as several third-party relational databases.

What is SAS Framework Data Server?

from the SAS 9.3 Intelligence Platform Middle-Tier Administration Guide

The SAS Framework Data Server is a database server that is the default location for middle-tier data such as alerts, comments, and workflows, as well as data for the SAS Content Server and SAS Service Parts Optimization. The server is provided as an alternative to using a third-party DBMS. The server cannot be used as a general-purpose data store.

SAS ODS: {thispage} and {lastpage} and PDF Output

saslogo

When developing new reports, we typically give the end users a choice of output formats to choose from.  The SAS Output Delivery System (ODS) provides a versatile framework to transform the results of SAS procedures into consistent, high quality reports in formats that are widely used by information consumers: HTML (HyperText Markup Language), PDF (Portable Document Format), RTF (Rich Text Format), Microsoft Excel, and others.  The majority of our reports (run as stored processes surfaced in the SAS Information Delivery Portal) contain tabular output, which is generally displayed to a user in HTML format with the option to download that data as a Microsoft Excel spreadsheet.

Some reports are designed to be formatted as a document, and include large amounts of ODS text, tables, and graphs.  We generally use ODS functions such as {thispage}, {pageof}, or {lastpage} to display the page number or number of pages in the document.  When using RTF as our ODS destination, the creation of a Microsoft Word document could not be easier.  We did run into one issue when using the PDF output destination, however.  Due to the configuration of printer drivers on our computer systems, the page numbers were not showing up in our documents, because SAS was unable to determine a default page size and margins.  We contacted SAS Technical Support and they pointed us to SAS Problem Note 31703 as a possible fix.  Tech Support solved our problem – we added the –uprint and –uprintmenuswitch options to our autoexec.sas configuration file and restarted our object spawners and our PDF documents included page numbers!

Want to know more about the SAS Output Delivery System?  Go to the Base SAS ODS Focus Area or download the Output Delivery System Tip Sheet.

Locating the Log Files for the SAS 9.3 Middle Tier

SASI have been doing some maintenance recently on one of our SAS EBI installations and needed to review the logs generated by the middle tier.  At some point any BI administrator will have to do this, so here are the default locations, directly from SAS:

The log files for the SAS 9.3 middle tier are located in the following directories:

Application Servers

Red Hat JBoss

  • /JBoss-home-directory/server/SAS-JBoss-server/log/server.log
  • /JBoss-home-directory/server/SAS-JBoss-server/log/boot.log

Oracle WebLogic

  • If WebLogic is started as a service, a UNIX daemon, or a batch process, the location is
    /WebLogic-home-directory/user_projects/domains/domain/servers/managed-server/logs/server.log.
  • If WebLogic is started using the Node Manager, the location is
    /WebLogic-home-directory/user_projects/domains/domain/servers/managed-server/logs/server.out.

IBM WebSphere

  • /WebSphere-home-directory/AppServer/logs/server/SystemOut.log
  • /WebSphere-home-directory/AppServer/logs/server/SystemErr.log

WebDAV Server

  • SAS Content Server:
    /SAS-configuration-directory;/Lev1/Web/Logs/SASContentServer9.3.log

SAS Web Applications

  • SAS Admin:
    /SAS-configuration-directory/Lev1/Web/Logs/SASAdmin9.3.log
  • SAS BI Dashboard:
    /SAS-configuration-directory/Lev1/Web/Logs/SASBIDashboard4.3.log
    /SAS-configuration-directory/Lev1/Web/Logs/SASBIDashboardEventGen4.3.log
  • SAS BI Portlets:
    /SAS-configuration-directory/Lev1/Web/Logs/SASBIPortlets4.3.log
    /SAS-configuration-directory/Lev1/Web/Logs/SASJSR18RemotePortlets4.3.log
  • SAS BI Web Services:
    /SAS-configuration-directory/Lev1/Web/Logs/SASBIWebServicesforJava9.3.log
  • SAS Information Delivery Portal:
    /SAS-configuration-directory/Lev1/Web/Logs/SASPortal4.3.log
  • SAS Logon Manager:
    /SAS-configuration-directory/Lev1/Web/Logs/SASLogon9.3.log
  • SAS Package Viewer:
    /SAS-configuration-directory/Lev1/Web/Logs/SASPackageViewer4.3.log
  • SAS Preferences:
    /SAS-configuration-directory/Lev1/Web/Logs/SASPreferences9.3.log
  • SAS Remote Services:
    /SAS-configuration-directory/Lev1/Web/Logs/RemoteServices.log
  • SAS Shared Apps:
    /SAS-configuration-directory/Lev1/Web/Logs/SASSharedApps9.3.log
  • SAS Stored Processes Web Application:
    /SAS-configuration-directory/Lev1/Web/Logs/SASStoredProcess9.3.log
  • SAS Web Report Studio:
    /SAS-configuration-directory/Lev1/Web/Logs/SASWebReportStudio4.3.log
    Note: Beginning with the second maintenance release for SAS 9.3 (TS1M2), the log is named SASWebReportStudio.log
  • SAS Web Infrastructure Platform Client Access:
    /SAS-configuration-directory/Lev1/Web/Logs/SASWIPClientAccess9.3.log
  • SAS Web Infrastructure Platform Services:
    /SAS-configuration-directory/Lev1/Web/Logs/SASWIPServices9.3.log
  • SAS Web Infrastructure Platform SOAP Services:
    /SAS-configuration-directory/Lev1/Web/Logs/SASWIPSoapServices9.3.log
  • SAS Workflow Services:
    /SAS-configuration-directory/Lev1/Web/Logs/SASWorkflowServices9.3.log

In my case, I was looking for my Websphere application server logs.  And as I should have suspected, my System Admin did not have the application servers or the log directories installed in the typical locations, so I had to do a little hunting.

Disable the Option to Store Credentials in SAS Enterprise Guide Profiles

from SAS® 9.2 Intelligence Platform Desktop Application Administration Guide at support.sas.com:

When you create a connection profile, the Connection Profile Wizard provides, by default, a check box named Save user ID and password in this profile. If a user selects this check box, then the user’s ID and password are stored in the user’s connection profile on the local file system. Saving the ID and password in the profile allows users to reconnect in the future without entering these values again.

Follow these steps to remove the Save user ID and password in this profile check box from the Connection Profile Wizard and require the manual entry of credentials:

  1. On the host of the SAS Metadata Server, open in a text editor the file omaconfig.xml.
  2. Change the value of the option SASSEC_LOCAL_PW_SAVE from 1 (or Y or T) to 0 (or N or F).
  3. Save and close the file.
  4. Restart the SAS Metadata Server as directed in the SAS Intelligence Platform: System Administration Guide.

After you change the setting for this option and restart the metadata server, each client uses the previous setting for its first connection. The client then discovers the revised setting and conforms to that revised setting for subsequent connections.

If you change the setting to disallow saved credentials, and credentials are already present in a user’s connection profile, those credentials must be manually removed.

Enterprise Guide 4.1 Die Date

saslogofrom support.sas.com:

The original SAS Enterprise Guide 4.1 expiration date is December 1st  of this year. SAS Enterprise Guide 4.1 customers who have not applied the SAS Enterprise Guide hot fix 41EG09wn or later will be affected. The workaround is to download and apply the latest hot fix:

http://ftp.sas.com/techsup/download/hotfix/ent_guide41.html

SAS Enterprise Guide die dates and extensions are documented in the SAS Note 33359:

http://support.sas.com/kb/33/359.html

Hot Fix Release A53007 for Enterprise Guide 4.22 Released

saslogoSAS released Hot Fix A53007 for Enterprise Guide 4.22 on June 29, 2010.  This Hot Fix applies to 32-bit and 64-bit versions of Microsoft Windows.  The Hot Fix address two issues, including:

  • Issue 38357 – SAS stored process might fail to run when the language is set to Norwegian
  • Issue 40130 – Errors might occur running a project after migration in SAS Enterprise Guide

You can obtain more details at the SAS Enterprise Guide 4.22 Hot Fix Downloads page at http://ftp.sas.com/techsup/download/hotfix/HF2/A53.html#A53007.

An Issue Creating a Format in SAS Enterprise Guide 4.2 after Installation of Hot Fix A53005

saslogo

I had been using SAS Enterprise Guide 4.22 for months without any crashes, but in May I installed the SAS Hot Fix A53005 primarily because it was available.  After installation of the Hot Fix, whenever I attempted to run the Create Format task, even in a brand new project, I received the following error:

SAS Enterprise Guide has encountered a problem.  We recommend that you save your work and restart SAS Enterprise Guide.

I submitted a ticket to SAS Tech Support, and for SAS, it took a relatively long time to get resolved.  Tech Support had to forward the issue on to the Development Team, who determined that the hot fix (and A53003 before it) relied on a patched version of the Microsoft Visual C++ runtime.  The patched version of the runtime was used because it fixed a security hole in ATL (Active Template Library).

Tech Support sent me the link for the Microsoft Visual C++ 2005 Service Pack 1 Redistributable Package ATL Security Update (http://www.microsoft.com/downloads/details.aspx?familyid=766a6af7-ec73-40ff-b072-9112bab119c2&displaylang=en), and when I applied the update to my system, the Create Format task worked fine.

Report Events in the SAS Key User Action Log

saslogofrom the SAS 9.2 Intelligence Platform Web Application Administration Guide,
Third Edition, located at:

http://support.sas.com/documentation/cdl/en/biwaag/63536/PDF/default/biwaag.pdf

The information in the Key User Action Log can be imported into SAS data sets and presented in reports. To report the data, follow these steps:

  1. Import the WebReportStudio_KeyActions.log data into a SAS data set. Here are the main steps:
    1. Assign a libref to an XML file that contains log data, and specify the XML engine.  In the following example, MyFile.xml is a copy of a Key User Action Log file:
      libname myxml xml ’C:\My Files\XML\MyFile.xml’;
    2. Use the SAS data sets procedure to import the XML file into a SAS data set.
      Here is an example:
      proc data sets library=myxml;
      This code creates a data set named EVENT in the MYXML library.
      For more information, see SAS online Help and documentation.
  2. In SAS Information Map Studio, create an information map based on the data set that you created in the preceding step. For the information map, you might want to provide the ability to filter based on the event code (<code> tag), the user name (<user> tag), the report name (<report> tag), or the date (<date> tag). For information about using SAS Information Map Studio, see the product Help.
  3. 3 In SAS Web Report Studio, define a report based on the information map that you created in the previous step. You can define the report to be refreshed manually, and then schedule the report to run at regular intervals.

Undo an Action in Microsoft Excel with the SAS Add-In for Microsoft Office Installed

SAS Even though we have Maintenance Release 2 installed on our SAS clients, we will still get undo problems in Excel.  Here is one more step that needs to be performed:

The issue described in SAS Note 36601: Cannot undo changes in Microsoft Excel when the SAS® Add-In for Microsoft Office is installed can be fixed by applying the second maintenance release for SAS 9.2 (TS2M2).

However, after you apply the maintenance release, you must also select the option Always Prompt for Data Source. This option can be found under SAS –> Options on the Tasks page. See Usage Note 37701: Additional SAS® Add-In for Microsoft Office configuration is required to restore functionality of the Undo button in Microsoft Excel.