IBM
Contents Index Previous Next



The Print Dialogs in the SDL Suite and in the Organizer


To print, you select any of the submenus in the Print menu from the File menu. This will open a Print dialog. Since the print functions in the tools are not identical, the print dialogs look somewhat different depending on where they are invoked from. As you can see in Figure 77 and Figure 78, the differences are that the Organizer print dialog includes the Contents area, whereas the SDL Suite tool print dialogs include a Setup button.

The main differences between printing from the Organizer and an SDL Suite tool are:

Note:

Endpoints are not displayed in printed documents/diagrams, regardless of the value of the Show Link Endpoints option.

Figure 77 : The Organizer Print dialog

Figure 78 : An SDL Suite tool print dialog

Both dialogs contain the following areas and buttons:

The Organizer print dialog also contains the Contents area with setup buttons, and a Save button. A Setup button is also included in each the SDL Suite tool print dialog. The setup buttons in the Contents area of the Organizer print dialog are equivalent to the Setup button in an SDL Suite tool print dialog. The Save button is used to save print dialog settings in print selection files, for later use in the print dialog.

All dialog areas and buttons will be described in this chapter.

Contents Area in the Organizer Dialog

The Contents area is only available in the Organizer Print dialog. In the area, it is possible to control what information to print, through a number of toggle buttons and Setup buttons. Each of the toggles identify a group of documents that may be printed:

Note:

It is not possible to include TTCN documents in a global printout from the Organizer. See The Print TTCN Dialog in the Organizer for information on how to print TTCN documents from the Organizer.

Some toggle buttons may be turned on by default. This is determined by which document types that are present in the default scope of print.

Table of Contents

This option determines whether a table of contents should be generated or not. The table of contents consists of a textual list with information about what source diagrams and generated diagrams that are included in the printout, with references to physical page numbers. There is also a possibility to only include Organizer chapters in the table of contents, i.e. all other printed entities are suppressed in the table of contents.

The table of contents is either printed on the first pages that constitute the resulting printout, or after an initial text document acting as a title page.

Organizer View

This option determines whether a printout of the Organizer main window should be included or not in the generated output. Only the visible parts (i.e. expanded nodes) are included.

The resulting printout will match the Organizer's View Options, i.e. file names, directories, etc. will be shown if they are in the Organizer Main window.

Link Manager View

This option determines whether a printout of the Link Manager Window should be included or not in the generated output. Only the visible parts (i.e. expanded nodes) are included.

OM/HMSC/SC/MSC/Text Diagram,
SDL Interaction,
SDL Flowchart,
SDL Overview

These options determines whether the documents and diagrams that are visible in the Organizer should be included or not in the printout. The SDL Interaction diagrams are: system, system type, block, block type, substructure, package diagrams. The SDL Flow diagrams are: process, process type, service, service type, procedure, operator, macro diagrams.

Note:

Endpoint markers will not be included in printed diagrams.

Coverage Diagram

This option determines whether Transition Coverage and Symbol Coverage trees should be included or not in the generated output.

Cross Ref Diagram

This option determines whether Definitions and Uses should be included or not in the generated output.

The resulting output will show the graphical appearance as when displayed in the Index Viewer, with the exception that only SDL entities defined or used in SDL diagrams printed together with the index will be visible in the index.

Type Diagram

This option determines whether an SDL-92 Type list and SDL Type Inheritance and Redefinition list should be included in the generated output or not.

The resulting output will show the SDL-92 type lists for the SDL system currently in view in the Organizer. The lists will be produced by using the options defined in the List Options, Tree Options and Symbol Options of the Type Viewer.

Setup Buttons in the Contents Area

Furthermore, each group of documents that may be printed is supplied with setup buttons. When you click a setup button, a Print Setup dialog will be issued, see Print Setup Dialogs. In the dialog, it is possible to set additional options that affect the printout of the current group of documents.

Document Area

The Document area contains a number of settings that make it possible to specify the size of the paper to use, the print range and additional information to be printed on each individual page.

The Document options are:

Note:

When using a printing format other than One Postscript File or MSWPrint the only enabled options in the Document area are Black & white (not for Frame or Interleaf printing) and Print collapsed texts. For these formats the paper layout is determined by the special Print preferences starting with Frame*PaperFormat. However when using Word format the margins and layout are determined by the defaults given by the created Word document.

Paper format

The Paper format option menu specifies what paper format the print function will use. The paper formats are:

Margins

The Margins button provides access to the Paper Format Setup dialog where the print margins may be specified.

Figure 79 : The Paper Format Setup dialog

The print margins govern how much space is reserved around the area used when printing. Values are expressed in millimeters.

Image format (Windows Only)

For Word printing the Image format option menu specifies what image format the print function will use. The image formats are:

Header file

Footer file

This feature controls whether or not a header/footer should be printed on each page. The page header/footer is defined in a text file of its own, which you need to supply. For information about the contents and syntax of this file, see Footer and Header Files.

Note:

Header or footer files are only supported in PostScript Output (not EPS) or MSWPrint Output (Windows only).

Page markers

An SDL/OM page or an MSC diagram may require multiple physical pages when printed. If you want to print an SDL/MSC/OM document and the document is physically spread over more than one physical page, the Page markers toggle button facilitates the reassembling of the paper sheets into the original page.

Figure 80 : The page numbering

Physical page numbering follows a "first right, then down" fashion.

Note:

The physical page breaks are indicated with dashed lines in the diagram editors. A page number is inserted at the lower right corner of each page in the editor.

Page markers and all other options where page numbers are used are only supported in PostScript Output (not EPS) or MSWPrint Output (Windows only).

It is possible to print an individual page number on each printed page. This is done by using a header file. Read more about header files in Footer and Header Files.

First page no

When you order multiple print jobs, you may want to restart the page numbering on each printout with a number different from 1, which is the default value.

If you want to change the number of the first page, you should type the number in the First page no: field.

Print from/to

It is possible to exclude a number of pages form a printout. To specify the print range, you type the page numbers in the Print from and Print to fields. Make sure that the toggle button is on, your settings will have no effect otherwise.

When the toggle button is off, all physical pages that constitute the printout will be generated.

Note:

The print range must be in accordance with the page numbering; i.e. the offset specified in the First page no should be added.

The physical page breaks are indicated with dashed lines in the diagram editors. These page breaks are valid only if the printing scale is not changed.

Black & white

If this option is selected, all symbols and lines will be printed with a black border on a white background. If this option is not selected, symbols and lines will be printed with the color they have on screen. As default, this option is off.

For FrameMaker or Interleaf printing this option is always on and disabled as the printing will always be in black and white.

Print collapsed texts

Text symbols, comment symbols and text extension symbols can be collapsed. When they are collapsed, it is not possible to see the complete text these symbols contain in the diagram. Instead, it is possible to print the complete text as a separate text page after the diagram. This option decides if such a text page should be printed or not. As default, this option is on.

Print chapter pages

(Organizer only.) Decides if text connected to chapter symbols in the Organizer should be printed or not. As default, this option is on.

Forward references

(Organizer only.) Decides if forward paper page references should be printed or not. Paper page references makes the printout easier to read. You can get paper page references for the following relations:

Note:

The three last relations will only be printed if there exists an index/cross reference file in the Organizer view with up-to-date information about the SDL system. You can get an index for a correct SDL system by pressing the Generate Index Organizer quick button before bringing up the print dialog

As default, forward paper page references are printed.

There is a preference, Print*MaxPageReferences, that decides the maximum number of page references in one place. The default value is 20. A value of 0 is the same as "no limit".

Backward references

Similar to forward references, but produces paper page references that allows the reader of the printout to follow the flow backwards instead.

Destination Area

The Destination area contains print options that affect the output format and the destination of the resulting output. It is for example possible to send a printout to a printer or to look at the results in a pre-viewer.

The options are:

Format

This feature controls what output format will be generated when printing. You select the output format in an option menu. The output formats supported are:

Note:

To have this print option function properly, the SDL Suite and FrameMaker must run on the same computer.

Temporary files are stored on the directory designated by the environment variable TMPDIR. You have to set up the variable as a complete path specification such as setenv TMPDIR /tmp
To specify TMPDIR such as setenv TMPDIR . is not sufficient.

See also Importing into FrameMaker (UNIX only) for how this option functions when multiple instances of FrameMaker are running on your computer.

To file / Map file

If this radio button is turned on, the output will be a file. The name of this radio button depends on the format specified in the Format option menu. If the format selected will generate one output file - i.e. the format name ends with Per Page - the name will be Map file. Otherwise it will be To file.

A map file contains a translation scheme of all files generated (containing information about SDL diagram / page and the corresponding printout file). The naming algorithm of the generated files will ensure a fixed mapping between a diagram and the generated files between two subsequent Print jobs. However, if the input to the Print function is changed (its size!), this is not necessarily true.

See Map File if you want detailed information on the syntax of a map file.

Execute

If this radio button is on, the output file will be used as input to an OS command. An example of this is to load a printer with a PostScript file. It may also be used to send the resulting PostScript code to a PostScript previewer. For instance, if type a previewer command in the field - ghostview for example - you may preview the PostScript file.

The command lpr (or any other related) will send the printout to a printer.

The default command is specified in the Preference Manager. In the Windows version, the command lpr is available, which functions much like the corresponding UNIX print spool command.

Setup

When you click the Setup button (only available in an SDL Suite tool Print dialog), a Print Setup dialog will be issued. In the dialog, it is possible to set additional options. The additional options differ between the the SDL Suite tools. See Print Setup Dialogs for more information.

1

EPS stands for Encapsulated PostScript

2

MIF stands for Maker Interchange Format.

3

IAF stands for Interleaf ASCII Format.


http://www.ibm.com/rational
Contents Index Previous Next