UniBasic Commands Reference - Rocket Software
UniBasic Commands Reference - Rocket Software UniBasic Commands Reference - Rocket Software
READNEXTTUPLE Syntax READNEXTTUPLE dyn.array.var FROM file.name.expr {THEN statements [END] | ELSE statements [END]} Description The UniBasic READNEXTTUPLE command assigns the next entire record to a variable. The record ID is obtained from an active select list that was created by a UniData SQL SELECT statement during the current work session. READNEXTTUPLE creates a dynamic array delimited by attribute marks (@AM). The attribute marks are entered by the UniData SQL SELECT statement. Tip: Do not use the UniData SQL UNNEST command in the SQL statement that creates the ID list. UniData might not return the entire record with attribute marks, value marks, and/or subvalue marks if you use UNNEST. 1-632 UniBasic Commands Reference
Parameters The following table describes each parameter of the syntax. Parameter Description dyn.array.var Specifies the dynamic array to contain the record. FROM file.name.expr Specifies the file from which to read the next record ID. file.name.expr must have been created during the current session by: An EXECUTESQL statement with a TO clause in the UniBasic program. A UniData SQL statement executed at the ECL prompt before the program was run. THEN statements END THEN executes if the read is successful. END is required to terminate multiline THEN statements. ELSE statements END ELSE executes if the read is not successful, the record does not exist, or the last record has been read. END is required to terminate multiline ELSE statements. READNEXTTUPLE Parameters READNEXTTUPLE 1-633
- Page 624 and 625: PROCREAD Syntax PROCREAD var {THEN
- Page 626 and 627: The following globally cataloged pr
- Page 628 and 629: PROCWRITE Syntax PROCWRITE expr Des
- Page 630 and 631: PROMPT Syntax PROMPT str.expr Descr
- Page 632 and 633: protocolLogging Syntax protocolLogg
- Page 634 and 635: PWR Syntax PWR(num.expr1, num.expr2
- Page 636 and 637: Related Command UniBasic SQUOTE 1-5
- Page 638 and 639: READ Syntax READ dyn.array.var FROM
- Page 640 and 641: Example In the following example, t
- Page 642 and 643: Parameters The following table desc
- Page 644 and 645: READBCKL Syntax READBCKL dyn.array.
- Page 646 and 647: STATUS Function Return Values After
- Page 648 and 649: READBCKU Syntax READBCKU dyn.array.
- Page 650 and 651: STATUS Function Return Values After
- Page 652 and 653: READFWD Syntax READFWD dyn.array.va
- Page 654 and 655: Example In the following example, t
- Page 656 and 657: Parameters The following table desc
- Page 658 and 659: Related Commands UniBasic READBCK,
- Page 660 and 661: Parameters The following table desc
- Page 662 and 663: Related Commands UniBasic READBCK,
- Page 664 and 665: Parameters The following table desc
- Page 666 and 667: UniData DEFAULT.LOCKED.ACTION - For
- Page 668 and 669: Parameters The following table desc
- Page 670 and 671: READNEXT Syntax READNEXT id.var [,
- Page 672 and 673: Parameter Description Examples In t
- Page 676 and 677: Example In the following example, t
- Page 678 and 679: READSEQ Syntax READSEQ var FROM seq
- Page 680 and 681: eadSocket Syntax readSocket(socket_
- Page 682 and 683: READT Syntax READT [UNIT (mu.expr)]
- Page 684 and 685: Example In the following example, t
- Page 686 and 687: Parameters The following table desc
- Page 688 and 689: Related Commands UniBasic CLOSE, DE
- Page 690 and 691: Parameter Description Examples In t
- Page 692 and 693: READVL Syntax READVL var FROM [file
- Page 694 and 695: Example In the following example, R
- Page 696 and 697: Parameters The following table desc
- Page 698 and 699: READXBCK Syntax READXBCK dyn.array.
- Page 700 and 701: READXFWD Syntax READXFWD dyn.array.
- Page 702 and 703: ReadXMLData Syntax ReadXMLData(xml_
- Page 704 and 705: RECORDLOCKED Syntax RECORDLOCKED (f
- Page 706 and 707: STATUS Function Return Values After
- Page 708 and 709: Parameter Description Examples In t
- Page 710 and 711: RECORDLOCKU Syntax RECORDLOCKU [fil
- Page 712 and 713: RELEASE Syntax RELEASE [file.var [,
- Page 714 and 715: ReleaseXML Syntax ReleaseXML(XMLhan
- Page 716 and 717: Example In the following example, c
- Page 718 and 719: Parameter Description The SETTING c
- Page 720 and 721: In some implementations, the values
- Page 722 and 723: REMOVE Syntax REMOVE(dyn.array.var,
Parameters<br />
The following table describes each parameter of the syntax.<br />
Parameter Description<br />
dyn.array.var Specifies the dynamic array to contain the record.<br />
FROM file.name.expr Specifies the file from which to read the next record ID.<br />
file.name.expr must have been created during the current session<br />
by:<br />
An EXECUTESQL statement with a TO clause in the <strong>UniBasic</strong><br />
program.<br />
A UniData SQL statement executed at the ECL prompt before<br />
the program was run.<br />
THEN statements END THEN executes if the read is successful. END is required to<br />
terminate multiline THEN statements.<br />
ELSE statements END ELSE executes if the read is not successful, the record does not<br />
exist, or the last record has been read. END is required to<br />
terminate multiline ELSE statements.<br />
READNEXTTUPLE Parameters<br />
READNEXTTUPLE 1-633