FLAGS

1

When flag 1 is set, the runtime applies European conventions to alpha variables during formatted transfers of decimal values. Specifically, the use of commas and periods are reversed (commas are used as decimal points, and periods are used as separators). For example,

alpha = 123456   ,"Z,ZZZ.XX"

normally assigns the value 1,234.56 to alpha. But when flag 1 is set, the European conventions are used, the assignment statement is coded as

alpha = 123456   ,"Z.ZZZ,XX"

and alpha has a value of 1.234,56.

When flag 1 is reset, the runtime applies American conventions to alpha variables. Commas are used as separators, and periods are used as decimal points.

If you are using xfServerPlus and you set flag 1, you need to set it in each routine. (xfServerPlus resets flag 1 after every call so that data passed across the wire is formatted properly.)

We recommend you use the LOCALIZE subroutine instead of flag 1. (See LOCALIZE.) The LOCALIZE subroutine overrides this flag.

2

When flag 2 is set, the runtime processes case-sensitive terminal input. When the flag is reset, the runtime translates all lowercase input to uppercase before processing it.

3

Setting flag 3 protects the runtime against accidentally replacing an existing file with a new file. Normally, the runtime does not check for duplicate filenames, and OPENing a file in output mode or using the RENAM or ISAMC subroutines can overwrite an existing file. When flag 3 is set, the runtime checks that the file about to be created does not already exist. If it does, a “Cannot supersede existing file” error ($ERR_REPLAC) is generated. When flag 3 is reset, the runtime won’t check for duplicate filenames.

Flag 3 works differently on OpenVMS with RENAM, OPEN, and COPY. To generate an $ERR_REPLAC error, you must also specify the output filename’s version number in the RENAM, OPEN, or COPY statement. System option #35 will cause this error to be generated in RENAM if any version of the target file exists.

4

Flag 4 is only useful with display terminals. When typing terminal input, the user can delete the most recently typed character by entering an ASCII delete code (using the Del, Delete, or Rubout key, depending on the keyboard). The FLAGS subroutine uses the current terminal setting for the default ASCII delete code.

When flag 4 is set, typing a DEL code sends a backspace, a paint character, and another backspace to the screen. The most recent character is replaced with the paint character, and the cursor is left in the deleted character’s position. The default paint character is a blank, but you can redefine it using the PAINT subroutine. Use the %PAINT intrinsic function to determine the decimal character code for the current paint character. Pressing Ctrl+U clears and repaints the current line and positions the cursor at its leftmost character position. Ctrl+R is ignored.

When flag 4 is reset, the characters are echoed back in the order in which they are deleted (the reverse of the order in which they were input), with the first deleted character preceded by backslash and the last deleted character followed by a backslash. For example, if the user enters ABDCEFG, presses the Rubout key three times, and then enters 123, the sequence appears on the screen as follows:

ABCDEFG\GFE\123

and the input is ABCD123.

This method of handling character deletions is inappropriate for most CRT applications.

When the user presses Ctrl+U to delete a line, the two-character ^U sequence is transmitted to the terminal, followed by a carriage return and a line feed. The cursor is thus positioned at the beginning of the next line to accept further input.

When the user presses Ctrl+R, a ^R is echoed at the terminal, followed by a carriage return, a line feed, and the currently accumulated input line.

5

Setting flag 5 prevents input received from any channels opened to terminal-type devices from being echoed back to the primary terminal. This flag is useful when the input is confidential, like a password. When flag 5 is reset, the characters that the user types are echoed on the screen.

6

Flag 6 is ignored on all systems except OpenVMS. It changes a file open for output to have no record attributes and disables carriage control on O mode files (except stream files). These files cannot be TYPEd or PRINTed.

7

Flag 7 suppresses the program termination message that is displayed at the terminal running the program when the STOP statement returns control to the monitor. When flag 7 is reset, the program termination message is displayed after the STOP statement is issued. If the program terminates abnormally, the appropriate error message is displayed regardless of the value of this flag.

8

Setting flag 8 ignores interrupt character(s) (Ctrl+C on Windows, the stty setting for interrupt on Unix, and Ctrl+C and Ctrl+Y on OpenVMS) typed at the terminal. When flag 8 is reset, interrupt characters perform their normal functions.

On OpenVMS, we recommend using the SETCTL subroutine instead. (See SETCTL.)

9

Setting flag 9 permits terminal input for a READS statement without an explicit terminator. A field entry is terminated implicitly when the field is filled, but a user can still terminate input with a terminator character before the field is full. (In other words, flag 9 causes READS to terminate the same way GETS does.) When flag 9 is reset, the READS statement ignores any nonterminating character that the user types once the field is full and echoes an ASCII bell character to warn the user.

10

When flag 10 is set, the terminator character won’t be echoed on the screen during terminal input. When flag 10 is reset, the terminator character is echoed on the screen.