SAS Component Language Dictionary

CBT

Runs a CBT entry

Category:

Modular Programming and Object Oriented

Syntax
Details
Examples
	Example 1: Displaying a Particular CBT Frame
	Example 2: Calling a CBT Entry
See Also

Syntax

CALL CBT(entry<,frame><,frame-name>);

entry

is the name of a CBT entry. Specify a CBT entry in the current catalog with entry. Specify an entry in the current catalog with entry.type. Specify a CBT entry in a different catalog with libref.catalog.entry. Specify a different type of entry in a different catalog with libref.cat-name.entry.type.

frame

is the number of the frame in the CBT entry to be displayed initially.

Type: Numeric

frame-name

is the name assigned to the frame in the CBT to be displayed initially. If this argument is specified, the value of frame is ignored.

Type: Character

Details

The CBT routine opens a CBT entry window. You can optionally specify the name or number of the CBT frame to display initially. For information about CBT entries, see the SAS documentation for SAS/AF software. You can use CBT entries to link detailed instructional information with an application so that the information is readily available.

The following restrictions apply for users of a CBT entry that is called from an SCL program:

The SAVE command is not recognized.
=X returns the user to the calling program.
QCANCEL returns the user to the calling program.
QEND returns the user to the calling program.

Examples

Example 1: Displaying a Particular CBT Frame

Display the second frame of the entry EXAMPLE.CBT:

call cbt('example',2);

Display the frame named ABC of the entry EXAMPLE.CBT:

call cbt('example',1,'abc');

Example 2: Calling a CBT Entry

Suppose an application requires users to be familiar with a particular set of terminology. You use the following program to call a CBT course (in this example, TERMINAL.CBT) that teaches the appropriate information. The following example runs the CBT entry if a user issues the command TEACH. Then, when the user exits the CBT course, it returns control to the SCL statement that follows the call to TERMINAL.CBT.

control always;
if (upcase(word(1))='TEACH') then
   do;
      call nextcmd();
      call cbt('terminal');
   end;