read work file Documentation

[anik]

Hello

in the" NATURAL HELP UTILITY" in the editor, the screen for work file help is…
READ WORK FILE WORK-FILE-NUMBER ONCE

RECORD OPERAND1                         
AND SELECT OFFSET N        OPERAND2 ... 
           FILLER NX  ...               
                                        
GIVING LENGTH OPERAND3                  
                                        
AT END OF FILE                          
   STATEMENT ...                        
END-ENDFILE                             
STATEMENT...                            

END-WORK

its Confusing because if you specify “once” you dont need the “end-work”
furthermore in the Documentation - http://techcommunity.softwareag.com/ecosystem/documentation/natural/nat426mf/sm/readwork.htm

shouldn’t the - END-WORK be in Brackets? for the same reason

Thanks

[Matthias1 (Matthias)]

@anik

shouldn’t the - END-WORK be in Brackets? for the same reason

IMHO: Should be.

But your linked documentation also reads:

ONCE Option:
ONCE is used to indicate that only one record is to be read. No processing loop is initiated (and therefore the loop-closing keyword END-WORK or LOOP must not be specified). If ONCE is specified, the AT END OF FILE clause should also be used.

If a READ WORK FILE statement specified with the ONCE option is controlled by a user-initiated processing loop, an end-of-file condition may be detected on the work file before the loop ends. All fields read from the work file still contain the values from the last record read. The work file is then repositioned to the first record which will be read upon the next execution of READ WORK FILE ONCE.

… so, everything is documented.