Sasshiato Crash Guide

SASSHIATO© Crash Guide

Sasshiato is designed to replace rp_gentable macro and to work “silently” without having

to change existing programs. Only if post-processing is used, the calls to rp_gentable

should be replaced with calls to __sasshiato macro.

Sasshiato uses a configuration file to define the format of the report (font size, font face,

paper size, margins, position of headers and footers, and many more formatting aspects).

If you reporting standards change with respect to formatting, you will only need to

change the configuration file.

Configuration file can be also set up to read titles/footers from the central dataset. This is

not set up in evaluation version.

Unsupported features

• Page numbers can only be placed in system headers ( system headers can be either

placed in header area or as part of the RTF table)

• If SRTF (simple RTF) format is used, the page numbers can only be placed in

system headers and system headers must be placed in header area of the page (see

If this happens, re-run Sasshiato with debug=101 option. Sasshiato will encode

restricted ascii characters and you should be able to generate the report. Because

of performance impact, this option is not turned on by default. Note that Sasshiato

will encode only ascii characters recognized by SAS. Please see “Character

restrictions/Printing special characters” for additional restrictions.

• Sasshiato will not work on the RCD generated with previous versions of CDAR.

Feature unsupported in the evaluation version

• Bookmarks

appear without wrapping. This is a limitation of evaluation version

• Some alignments do not work properly in evaluation version (e.g. display of

NAE, or overall p-values). This is because CDAR was “hacked” to work with

courier font and the alignments were implemented in rp_gentable. Changing this

to work properly with Sasshiato was not practical for evaluation purpose but of

course can be done during final integration

• I have done my best to connect all the “switches” between CDAR and Sasshiato,

but I might have missed something. If you see anything amiss please contact me

• Evaluation version does not fully support spanned variables is output (wholerow

parameter of rp_define). It requires a bit more “surgery” into CDAR.

Instructions for Use

Sasshiato has been incorporated into CDAR code (on evaluation basis) and replaces

rp_gentable. In general, you should not need to modify your existing programs. If you

use %rp_gentable after post-processing, you will need to replace it with the call to

Sasshiato (%__sasshiato(dataset=<RCD dataset>)

If you encounter problems, I urge you to re-run your program with debug=101 parameter.

This parameter can be passed ro RPX_execute or RPX_Genlist, or directly to __sasshiato

macro. When debog=101, the xmal document will be saved in the output folder. This xml

default values. In general, you should not need to specify any of the parameters except

DATASET (required) and possibly DEBUG (to help me diagnose issues if any) and

APPEND/APPENDABLE (to combine two or more RCDs into one report, see section

below)

dataset=

name of the RCD dataset

savexml=N,

whether XML document should be permanently saved. If debug>0, savexmal is

append=,

appendable=,

whether the output is not page-stamped awaiting additional documents to be

appended

colspacing=,

default spacing between columns. By default it is 12 (pt). It is not recommended

to set colspacing to less than 4

addlines=,

esc_char= ,

Escape character used to indicate tabs and line breaks. Default is “/”

rtf_linesplit=,

ADVANCE USE ONLY. BEYOND THE SCOPE OF EVALUATION

stretch=,

space-delimited list of tokens (each having value of Y or N) indicating whether

stretching of a column is allowed.

The default (1) is approximately the width of a letter “A”.

Character restrictions/Printing special characters

The following characters/strings are restricted since they have special meaning to

Sasshiato:

The string “~{super” is restricted to indicate superscript.

The following characters are restricted and must be encoded (see below):

• \

Each of the restricted characters can be printed by encoding it as explained below.

To encode the restricted character, replace it with the following construct:

/#<number><space>, where <number> is the ascii decimal encoding of the character.

To print special symbols, encode them using the following construct:

/s#<number><space>, where <number> is the ascii decimal encoding of the symbol

character.

The easiest way to find the ascii decimal encoding number is to open Word, click on

Insert Symbol (change to normal font (e.g. Times New Roman) or Symbol font, as

needed) and click on a symbol. A box will show the ascii decimal number of the symbol.

in RPX_EXECUTE). When Sasshiato is fully integrated into CDAR, these parameters

For the first part of the report, run your program with

CREATETABLE=n and then run __sasshiato with APPEND=N and APPENDABLE=Y

(this will produce report with “_PAGE_” instead of page numbers)

If you have more than 2 “parts”, run the program for the other ones (except the last one)

with CREATETABLE=n and then run __sasshiato with APPEND=Y and

APPENDABLE=Y Make sure that output file name is the same as in the previous step.

For the last part, run the program for the other ones (except the last one) with

footnotes for different parts of the report, unless you replace them in the RCD file passed

to Sasshiato.

Note also that this process is not yet optimized for performance. Future Sasshiato

version(s) will try to address the performance issue.

Use of Background Images

Sasshiato supports background images (“watermarks”) when the pagination is requested.

Supported values for column widths

N - no wrapping,

NH - no wrapping including header,

LW - longest word,

LWH - longest word with header included,

<number> - fixed number in points, 1in=72 points

<number>in - fixed number in inches

<number>cm - fixed number in cm

of __sasshiato macro is also blank, all the columns are assumed to be allowed to stretch.

(this is implemented in CDAR and can be changed if desired)