|
PRAGMA PROGRAM REFERENCE MANUAL
|
Index
|
All Operation
|
|
Expand All ADDENDUM
|
EXTERNAL ECHO
|
XE
|
Standard Target Noun
|
Noun
|
Target =
|
Used with the verbs that perform file operations (external and regular). It contains the status message of the most recent file operation. This status message tells you whether or not the file operation completed properly. Both EXTERNAL ECHO and FILE STATUS are set after file operations, and either may be checked. EXTERNAL ECHO contains text which may be different for each country, being dependent on the file status messages selected in PRAGMA.DES.
|
DISPLAY the value EXTERNAL ECHO
|
SEE ALSO: FILE STATUS / IPC STATUS
|
The noun EXTERNAL ECHO (XE) will contain a message after all file operations (except those using mock internal emulation; mockflag = 1).
Both FILE STATUS and EXTERNAL ECHO are set after file operations, and either may be checked.
FILE STATUS, since it contains numeric values, is language independent; whereas EXTERNAL ECHO contains text which is different for each country.
If EXTERNAL ECHO is used, the verb is dependent upon the file status messages selected in PRAGMA.DES. That means that for instance, when you check with an IF statement if the EXTERNAL ECHO is equal to "record not found", your program will not work if in PRAGMA.DES instead of "record not found" you have "scheda non trovata".
The following are the possible messages of EXTERNAL ECHO in the standard American version of PRAGMA:
OK record not found duplicate reference conflict file is locked queue is empty queue is locked prepare to stop NO SUCH FILE REFERENCE TOO LONG MORE NOUNS IN LOCAL FILE FEWER NOUNS IN LOCAL FILE NO SUCH QUEUE NO RESPONSE RECEIVED EXTERNAL DISC IS FULL TRANSMISSION ERROR INTERNAL LOGIC ERROR UNKNOWN EXTERNAL ECHO?
Be aware that the messages are case sensitive. The old fashioned way of spelling DISC is a leftover from the old days.
OK
The communication between PRAGMA and the filemanager was successful. The majority of your communications will result in this message. If EXTERNAL ECHO does not contain an "OK", then something special will usually need to be done to handle or correct the situation.
record not found
A file record with the requested reference was not found.
duplicate reference
The filemanager tried to save a record and found that a record with an identical reference already exists in the specified file. The record was not saved.
A workstation attempted to lock a record more than once.
conflict
A workstation tried to retrieve a file record that was controlled at the time by another workstation.
file is locked
The specified Fileserver file has been locked out of use by the Fileserver console operator.
queue is empty
The specified Fileserver message queue is empty.
queue is locked
The specified Fileserver message queue has been locked out of use by the Fileserver console operator.
prepare to stop
The Fileserver console operator has selected the PREPARE TO STOP function to advise the workstations that the Fileserver will be shutting down.
NO SUCH FILE
The filemanager tried to use a file that was defined in the VOCAB but not in the operating system or at the Fileserver.
REFERENCE TOO LONG
You tried to use a reference longer than 32,767 characters. The record being accessed is bigger than the RECORD SIZE stated in PRAGMA.DES. A reference longer than 255 bytes is being used with Btrieve.
MORE NOUNS IN LOCAL FILE
The number of nouns used in your workstation file definition is more than the number of values per record in the Fileserver file or more than the number of values per message in the Fileserver queue.
FEWER NOUNS IN LOCAL FILE
The number of nouns used in your workstation file definition is less than the number of values per record in the Fileserver file or less than the number of values per message in the Fileserver queue.
NO SUCH QUEUE
You tried to use a message queue that is defined as a file at your workstation, but is not defined as a message queue at the Fileserver.
NO RESPONSE RECEIVED
If you are using Btrieve, Btrieve itself has not been loaded. An incorrect selection of file manager has been made in PRAGMA.DES. The PRAGMA Fileserver does not respond to your workstation after several seconds of requests.
EXTERNAL DISC IS FULL
You tried to store a record or message when there was no more free space on the hard disk.
TRANSMISSION ERROR
A workstation cannot receive a correct transmission from the Fileserver.
INTERNAL LOGIC ERROR
The filemanager attempted to access a file unsuccessfully.
If you are using Btrieve as filemanager and the result of a file operation is "INTERNAL LOGIC ERROR" for the EXTERNAL ECHO, the FILE STATUS will contain the Btrieve error number. This is to help to trace Btrieve errors.
UNKNOWN EXTERNAL ECHO?
The workstation logic and the Fileserver logic are not fully compatible.
Two more external echoes mentioned in some PRAGMA 3 manuals must also be mentioned.
RESET FAILS
It is an obsolete message that was only used by TINA.
unsafe save
When you attempt to do a SAVE THIS, PRAGMA 3 checks to see if the record you are saving is locked to you. The FILESERVER does not care. PRAGMA 3 goes ahead and performs the SAVE THIS in either case. If the FILESERVER answers with an "OK" and the record was not locked to you, PRAGMA 3 changes this to "unsafe save", to warn you of a potentially bad situation. PRAGMA 4 does not worry about this and you just get the "OK".
|
|
|
CustomWare® is a registered trademark of CustomWare Designs, Inc. All rights reserved.
CustomWare® is a registered servicemark of CustomWare Designs, Inc. All rights reserved.
All images and designs on this web site are copyrighted© 2021.
v
t
|
|