RAISE function

Syntax

RAISE (expression)

Description

Use the RAISE function to return a value equal to expression, except that system delimiters in expression are converted to the next higher-level delimiter: value marks are changed to field marks, subordinate value marks are changed to value marks, and so on. If expression evaluates to the null value, null is returned.

The conversions are:

Table 1. Conversions Using the RAISE Functions
IM	CHAR(255)	to	IM	CHAR(255)
FM	CHAR(254)	to	IM	CHAR(255)
VM	CHAR(253)	to	FM	CHAR(254)
SM	CHAR(252)	to	VM	CHAR(253)
TM	CHAR(251)	to	SM	CHAR(252)
	CHAR(250)	to		CHAR(251)
	CHAR(249)	to		CHAR(250)
	CHAR(248)	to		CHAR(249)

PIOPEN Flavor

In PIOPEN flavor, the delimiters that can be raised are CHAR(255) through CHAR(252). All other characters are left unchanged. You can obtain PIOPEN flavor for the RAISE function by:

Compiling your program in a PIOPEN flavor account
Specifying the $OPTIONS INFO.MARKS statement

Examples

In the following examples an item mark is shown by I, a field mark is shown by F, a value mark is shown by V, and a subordinate value mark is shown by S.

The following example sets A to DDIEEI123I777:

A= RAISE('DD':FM'EE':FM:123:FM:777)

The next example sets B to 1I2F3I4V5:

B= RAISE(1:IM:2:VM:3:FM:4:SM:5)

The next example sets C to 999S888:

C= RAISE(999:TM:888)