HP 3000 Manuals

Procedure Division [ COBOL/HP-UX Language Reference for the Series 700 and 800 ] MPE/iX 5.0 Documentation


COBOL/HP-UX Language Reference for the Series 700 and 800

Procedure Division 

The Position-Specification Phrase 

Function 

The position-specification phrase specifies the screen position in the
ACCEPT, DISPLAY and EXHIBIT statements described in this appendix.  You
must set the MS system directive when you submit your source code to your
COBOL system if it contains this phrase.

General Format 

[]
Syntax Rule The comma shown in the above format is mandatory. The ACCEPT Statement The following format of the ACCEPT statement is supported: General Format ACCEPT [position-spec] identifier [WITH-phrase] General Rules 1. The ACCEPT operation treats a group item as an elementary item, if you set the MS system directive when you submit your source code to your COBOL system: it accepts the item itself and not its subordinate elementary items. 2. If the screen position at which the first operand is to appear is not specified, the default is the current cursor position, if you set the MS system directive when you submit your source code to your COBOL system. 3. Rules 1 and 2 above also apply to Format 2 of the ACCEPT statement as described in the main body of this manual. 4. The WITH phrase options and their equivalents are: AUTO/AUTO-SKIP BACKGROUND-COLOR BELL/BEEP BLINK REVERSE-VIDEO RIGHT-JUSTIFY SECURE/NO-ECHO SIZE SPACE-FILL TRAILING-SIGN UNDERLINE UPDATE ZERO-FILL These options also apply to Format 2 of the ACCEPT statement as documented in the main body of this manual. The options listed below differ from standard COBOL, as follows: a. UPDATE. If the UPDATE option is not specified, a data item for data entry is displayed initially as spaces, if you set the MS directive when you submit your source code to your COBOL system. (If the MS directive is not set, the display of initial data is a configuration option.) If the UPDATE option is specified, initial data of the data item for data entry is displayed. b. PROMPT. This option need not be specified to display prompt characters, if you set the MS directive when you submit your source code to your COBOL system. c. LENGTH-CHECK. If this option is specified, it causes an implicit EMPTY-CHECK option, so that the operator must enter something. You set the MS directive when you submit your source code to your COBOL system, if you have specified this option. d. FOREGROUND-COLOR and BACKGROUND-COLOR. Integer-1 in these clauses specifies the foreground color and background color of the screen item respectively, and can be defined by a value from 0 to 15, as follows: 0 black 8 grey 1 blue 9 light blue 2 green 10 light green 3 cyan 11 light cyan 4 red 12 light red 5 magenta 13 light magenta 6 brown 14 yellow 7 white 15 high intensity white On a color screen, if the foreground color option specifies an integer whose value is from 8 to 15, this is equivalent to specifying an integer from 0 to 7 and specifying the HIGHLIGHT option. On a monochrome screen, this is equivalent to simply specifying the HIGHLIGHT option. On a color screen, if the background color option specifies an integer whose value is from 8 to 15, this is equivalent to specifying an integer from 0 to 7 and specifying the BLINK clause. On a monochrome screen, this is equivalent to simply specifying the BLINK option. The DISPLAY Statement General Format The following format of the DISPLAY statement is supported:
[]
General Rules 1. The DISPLAY operation treats a group item as an elementary item, if you set the MS system directive when you submit your source code to your COBOL system: it displays the item itself and not its subordinate elementary items. 2. If the screen position at which the first operand is to appear is not specified, the default is the current cursor position, if you set the MS system directive when you submit your source code to your COBOL system. 3. Rules 1 and 2 above also apply to Format 2 of the DISPLAY statement documented in the main body of this manual. 4. If ERASE is specified, the screen is cleared from the current cursor position onwards. The following two rules are additional rules which apply to Format 2 of the DISPLAY statement documented in the main body of this manual. 5. The WITH phrase options and their synonyms are: BACKGROUND-COLOR BELL/BEEP BLANK BLINK FOREGROUND-COLOR HIGHLIGHT REVERSE-VIDEO SIZE UNDERLINE 6. FOREGROUND-COLOR and BACKGROUND-COLOR. Integer-1 in these clauses specifies the foreground color and background color of the screen item respectively, and can be defined by a value from 0 to 15, as follows: 0 black 8 grey 1 blue 9 light blue 2 green 10 light green 3 cyan 11 light cyan 4 red 12 light red 5 magenta 13 light magenta 6 brown 14 yellow 7 white 15 high intensity white On a color screen, if the foreground color option specifies an integer whose value is from 8 to 15, this is equivalent to specifying an integer from 0 to 7 and specifying the HIGHLIGHT clause. On a monochrome screen, this is equivalent to simply specifying the HIGHLIGHT option. On a color screen, if the background color option specifies an integer whose value is from 8 to 15, this is equivalent to specifying an integer from 0 to 7 and specifying the BLINK clause. On a monochrome screen, this is equivalent to simply specifying the BLINK option. The EXHIBIT Statement An EXHIBIT statement with neither the CHANGED nor the NAMED option behaves as if the NAMED option were specified. General Format The following format of the EXHIBIT statement is supported:
[]
Syntax Rule Mnemonic-name should be associated with sysout, syslist, syslst, syspunch, syspch, console or printer. General Rule ERASE clears the screen from the current cursor position onwards.


MPE/iX 5.0 Documentation