XRELATE
XREL
ATE item-1 item-2
executes a RELATE command whose parameters are held in a character variable.
arguments
item-1 Character item containing the RELATE parameters
item-2 Numeric item to receive the returned error code:-
0 = RELATE successful
1 = RELATE not successful
notes
n
If XREL is used in a program, then an INFO template of the same description must be included, as a non-executing statement, for the program to compile and execute correctly.
example
FO $CHR1,80
FO $CHR11,32
FO $CHR15,16
FO $NUM40,1,I
SEL FILE-A
REM
non-executing RELATE so that program will compile
IF 1 NE 1
RELATE FILE-B-DUMMY BY ITEM
ENDIF
$CHR11 = ‘FILE-B’
$CHR15 = ‘ORDERED’
$CHR1 = ‘RELATE ’,$CHR11,‘ BY ITEM ’,$CHR15
XRELATE $CHR1 $NUM40
IF $NUM40 NE 0
DIS ‘RELATE failed’
GOTO END
ENDIF
INFO Reference Manual Commands 569
XRELATE error messages see also
INVALID SOURCE ITEM item-1 must be type C
ITEM NAME OR LITERAL MUST BE SPECIFIED item-1 or item-2 has been omitted
ILLEGAL RELATIONSHIP NUMBER
RELATE
570 Commands INFO Reference Manual
