General
Application areas: | Requesting and accessing lists and tables; see "Requesting and accessing lists and tables" |
Macro type: | Type O; see "O-type macros" |
This macro description applies to VTSU V13.3A
Macro description
The VTCSET macro generates symbolic names which can be used to insert logical control characters in line mode output messages and to locate line mode inputs.
Macro format and description of operands
VTCSET |
prefix |
prefix
Specifies a string (up to 5 characters) to be prefixed to the symbolic names.
In the following descriptions, “&P.” is used as a prefix in place of the string which precedes the symbolic names.
1. Logical record control characters
&P.NL
Logical end of line (new line)
Effect on output:
Special display formats on the terminal are reset to the standard display format (normal, standard color, unprotected in line mode, protected in extended line mode). The character set is not reset. If the message is output in extended line mode, the remainder of the line is blanked and protected.
The defined logical end-of-line character is output (except in extended line mode).
The next line is set to standard status: normal, low intensity, standard color, standard character set, unprotected in line mode, protected in extended line mode. The standard character set is character set 0 for 9763 Data Display Terminals and character set 1 for other display terminals and printers.Status is not set to standard if operating mode 2 and HOM=YES were specified for the terminal.
If continuing the output would cause data overflow at the terminal, the defined overflow check is executed (except in extended line mode).
The cursor is positioned at the start of the next line.
In the case of field-oriented display and structured output (standard) a start of field is generated.
&P.NP
Logical end of page (new page)
Effect on output:
Special terminal display formats are reset to the standard display format (normal, standard character set, standard color, unprotected in line mode, protected in extended line mode with UPDATE=NO, unprotected in extended line mode with UPDATE=YES). The screen format is reset to 24x80. The standard character set is character set 0 for 9763 Data Display Terminals and character set 1 for other display terminals and printers.
The defined logical end-of-line character is output.
Hardcopy output is initiated (if HCOPY=YES).
The defined overflow control action is executed.
A new page is created (on display terminals the screen is cleared and the screen format 24x80 set, on printers a page feed is performed). If page feeds were already initiated in the same message by means of ASF (automatic sheet feed), then the last ASF used replaces NP.
The cursor is positioned at start of line.
In the case of field-oriented display and structured output (standard) a start of field is generated.
&P.CL
Logical end of record (current line)
Effect on output (printers and teleprinters only):
Special display formats on the terminal are reset (to normal, standard character set, unprotected). The standard character set is character set 1 for the devices concerned).
The defined logical end-of-line character is output.
The cursor is set to the start of the current line.
&P.VPAddd
(data display terminals only, see "VTCSET - Define logical control characters" for printers) Position on first unprotected field of a line (vertical position absolute) (binary or three-digit decimal value)
Effect on output:
Absolute line positioning on the first unprotected field in line ddd of the data display terminal. Can be combined with HPA for simultaneous positioning on the absolute column.
Note
If ddd is zero or larger than 255, the substitute character (SUB) is inserted instead of VPA and ddd is output.
If ddd is less than or equal to 255 but greater than the maximum number of lines, NL is executed instead of VPA.
&P.HPA ddd
(data display terminals only, see "VTCSET - Define logical control characters" for printers) Position on column (horizontal position absolute) (three-digit decimal value)
HPA is processed in extended line mode only and only when specified immediately after a valid VPA. HPA specifies the absolute column in a line defined by the preceding VPA. If the preceding VPA control character was invalid or if HPA is not specified immediately after VPA, HPA ddd is ignored. HPA on a 3270 terminal positions on the start of the next unprotected field.
Effect on output:
Absolute column positioning in the line defined by the preceding VPA.
Note
If ddd is zero or larger than 255, the substitute character (SUB) is inserted instead of HPA and ddd is output.
If ddd is less than or equal to 255 but greater than the maximum number of columns, HPA ddd is ignored and only the VPA function is executed.
2. Logical display control characters
&P.EM1
Emphasized layout 1
Effect on output:
Subsequent text characters are “emphasized” (highlighted) on the terminal as appropriate to the device type used (see table on "VTCSET - Define logical control characters").
Emphasized layout is reset by:
the logical record control characters (NL, NP, HPA, VPA)
the display control characters (EM2, EM3, EM4, DAR, DIS, NOR)
the field control characters (EPA, SPA, NUM, CHS, COL, FLD)
&P.EM2
Emphasized layout 2
Effect on output:
Subsequent text characters are “emphasized” on the terminal as appropriate to the device type used (see table on "VTCSET - Define logical control characters").
Emphasized layout is reset by:
the logical record control characters (NL, NP, HPA, VPA)
the display control characters (EM1, EM3, EM4, DAR, DIS, NOR)
the field control characters (EPA, SPA, NUM, CHS, COL, FLD)
&P.EM3
Emphasized layout 3
Effect on output:
Subsequent text characters are “emphasized” on the terminal (see table on "VTCSET - Define logical control characters").
Emphasized layout is reset by:
the logical record control characters (NL, NP, HPA, VPA)
the display control characters (EM1, EM2, EM4, DAR, DIS, NOR)
the field control characters (EPA, SPA, NUM, CHS, COL, FLD)
&P.EM4
Emphasized layout 4
Effect on output:
Subsequent text characters are “emphasized” on the terminal (see table on "VTCSET - Define logical control characters").
Emphasized layout is reset by:
the logical record control characters (NL, NP, HPA, VPA)
the display control characters (EM1, EM2, EM3, DAR, DIS, NOR)
the field control characters (EPA, SPA, NUM, CHS, COL, FLD)
&P.NORNormal layout
Effect on output:
Subsequent text characters are displayed normally on the terminal (i.e. emphasized layout is reset).
&P.SO
Shift out into character set extension in accordance with the table on "VTCSET - Define logical control characters".
Effect on output on certain terminals only (see table on "VTCSET - Define logical control characters"):
Subsequent text characters are displayed on the terminal in the device-specific character set according to the table on "VTCSET - Define logical control characters".
Meaning for input:
Subsequent text characters were entered using the terminal-specific character set.
&P.SI
Shift into basic character set in accordance with the table on "VTCSET - Define logical control characters".
Effect on output:
Subsequent text characters are displayed on the terminal in the basic character set.
Meaning for input:
Subsequent text characters belong to the basic character set.
&P.DARDark layout
Support for this operand is continued only for the sake of compatibility. Instead of &P.DAR, you should use the operands &P.EXT DIS and &P.EXT FLD.
Depending on the value of the DARPRINTABLE parameter, DAR is either a field or a logical display control character.
Effect on output:
The value of DARPRINTABLE is N' (default).
In the case of field-oriented display and structured output, DAR generates a start of field. Subsequent text characters are blanked and cannot be printed. The field is omitted from hardcopy.
DAR is reset by the logical record control characters (NL, NP, HPA, VPA) or the field control characters (EPA, NUM, CHS, COL and FLD).
The value of DARPRINTABLE is 'Y'.
Subsequent text characters are blanked. No start of field is generated.
DAR is reset by:
the logical record control characters (NL, NP, HPA, VPA)
the display control characters (EM1, EM2, EM4, NOR)
the field control characters (EPA, SPA, NUM, CHS, COL, FLD)
&P.EXT DIS x
(data display terminals only) Set display attributes
Effect on output:
Subsequent text characters are highlighted on the terminal as appropriate to the device type used. Inverse video mode is ignored on 8110, 815x, 816x, 974x, 975x Data Display Terminals and 3270 terminals. On the 9763 Color Terminal, the attributes flashing, underscore, low intensity and combinations thereof are mapped to colors, depending on SIDATA.
x is a hexadecimal value that can be selected by means of the following equates:
&P.FL | flashing |
&P.UND | underscore / italic (see EM2) |
&P.BLK | invisible |
&P.RIN | reduced intensity |
&P.INV | inverse video |
&P.RS | the attributes FL, UND, BLK, RIN and INV are reset. Note that RS does not |
x is either the value of one of these equates or the sum of a combination of equates.
e.g. &P.EXT DIS &P.UND+&P.FL text subsequent text is underscored and flashing
Any attribute not supported by the display terminal is ignored.
The highlight is reset by:
the logical record control characters (NL, NP, HPA, VPA)
the display control characters (EM1, EM2, EM3, EM4, DAR, DIS, NOR)
the field control characters (EPA, SPA, NUM, CHS, COL, FLD)
3. Logical field control characters
&P.SPA
Start protected area
Effect on output (data display terminals only):
In the case of field-oriented display and structured output, SPA generates a start of field. Subsequent text characters are displayed at reduced intensity on the monitor of the data display terminal and are protected, i.e. they cannot be overwritten and returned to the data processing unit.
SPA is reset by the logical record control characters (NL, NP, HPA, VPA) or the field control characters (EPA, NUM, CHS, COL and FLD).
Note
This function has a significant impact on the display attributes of certain terminals (newline on 8152 DDT, hardcopy function on 816x, 975x and 976x terminals). It should therefore be used with extreme caution.
&P.EPA
End protected area
Effect on output:
In the case of field-oriented display and structured output, EPA generates a start of field. Subsequent text characters are output to the terminal unprotected and displayed at high intensity.
EPA is reset by the logical record control characters (NL, NP, HPA, VPA) or by the field control characters (EPA, NUM, CHS, COL and FLD).
&P.NUMNumeric area
Effect on output:
In the case of field-oriented display and structured output, NUM generates a start of field. Subsequent text characters are output to the terminal unprotected and displayed at high intensity.
You can enter only numeric data (digits, . * / + - ) in this field.
NUM is reset by the logical record control characters (NL, NP, HPA, VPA) or by the field control characters (EPA, SPA, CHS, COL and FLD).
&P.CHS dd Loadable character set
CHS is effective only on terminals of type 9763.
Effect on output:
In the case of field-oriented display and structured output, CHS generates a start of field and a loadable character set from the repertory available to the data terminal is selected for this field. dd is a two-digit decimal in the range 00-07 and designates the desired loadable character set. You can use the TSTAT macro to query the loadable characters sets available.
Example
If dd is 00, you address loadable character set 0 which has the symbolic name STACS0T in DCSTA (see MONCS).
Only characters from the selected character set can be entered in the generated field.
CHS is reset by:
the logical record control characters (NL, NP, HPA, VPA)
the display control characters (EM1, EM2, EM3, EM4, DAR, NOR, DIS)
the field control characters (EPA, SPA, NUM, COL, FLD)
Note
The user must ensure that the character sets of the data display terminal that are to be addressed logically via the control character CHS are loaded with the correct character sets.
CHS is not supported in the system line.
The character sets can be loaded physically in physical mode or with EXT TRA in line mode. Character sets can be created with the software product ICE.
&P.COL dd Choice of colors
COL is effective only on color terminals of type 9763.
Effect on output:
In the case of field-oriented display and structured output, COL generates a start of field (even on monochrome screens). If the terminal is a 9763 color DDT, COL can be used to select a color from those available for this field. dd is a two-digit decimal in the range 00-07 designating the desired color.
00 | default | 01 | blue | 02 | red |
03 | magenta | 04 | green | 05 | cyan |
06 | yellow | 07 | white |
Note that COL is not supported in the system line.
COL (color selected) is reset by:
the logical record control characters (NL, NP, HPA, VPA)
the display control characters (EM1, EM2, EM3, EM4, DAR, NOR, DIS)
the field control characters (EPA, SPA, NUM, CHS, FLD)
&P.EXT DIM ll ccc Physical screen dimension
EXT DIM is effective only on terminals of type 9763, and only if specified immediately after NP.
Effect on output:
EXT DIM can be used to select the screen format on display terminals of type 9763. The standard format is 24 x 80. Additional formats are 32 x 80, 43 x 80 and 27 x 132. The possible screen formats can be queried with TSTAT.
The number of lines ll is specified in two bytes. The number of columns ccc is specified in 3 bytes.
When the device is switched on, and during connection setup, the standard (default) format is reset automatically. The screen format is reset to the standard format by NP, at end of program, and when the screen is cleared by the system.
If a program is interrupted (K2, BKPT) in LINE mode, the screen format is not reset to the standard format.
CHS is not supported in the system line.
&P.EXT FLD x
(data display terminals only) Set field characteristics
Effect on output:
In the case of field-oriented display and structured output, a start of field is generated and certain characteristics are assigned to this new field. By default, this field is not printable. If emphasized display preceded this operand, it is set to reduced intensity for a protected field and to bright for all other fields.
x is a hexadecimal value selected by means of the following equates:
&P.PNS | protected field not sendable |
&P.PRS | protected field sendable (automatic input) |
&P.NUF | numeric field |
&P.MOD | premodified field (only in extended line mode) |
&P.MAR | markable field |
&P.PRT | printable field |
&P.INP | unprotected input field not numeric, not markable, not printable |
&P.ASK | protected field with automatic tabulator (3270 terminals only) |
x is either the value of one of these equates or the sum of a combination of equates.
e.g. &P.EXT DIS &P.UND+&P.FL text The field is numeric and markable
If a combination of field characteristics is defined, the output attribute 'reduced intensity' is retained. You must use the DIS control character to request other display attributes. Note that the field characteristics must always precede the output attributes.
FLD is reset by the logical record control characters (NL, NP, HPA, VPA) or by the field control characters (EPA, SPA, NUM, CHS, COL and FLD).
FLD is not supported in the system line.
Note that a markable field is of significance to the application only if the VTSUCB parameter READ=MODIFIED is used.
If the characteristics protected, not sendable and markable are assigned to a field, they correspond to the FHS attribute PROTECTION=DETECTABLE (protected selection field). If a field of this type is marked in read mode, the user receives only the field coordinates VPA and HPA and not the contents of the field. If you press the MAR key again, you can cancel 'marked' as an attribute of this field.
4. Logical local control characters
&P.LOC ctl
Set local attributes
LOC is effective only on data display terminals of type 9763.
Effect on input and output:
The attribute which is addressed with the control character ctl immediately following LOC is only created locally. ctl can be: EM1-EM4, NOR, DAR, DIS, CHS and COL.
A local attribute is valid for all subsequent characters up to the next start of field, if not explicitly reset before this. The attribute is reset using LOX (see "VTCSET - Define logical control characters"). Local attributes are character-specific. When the character disappears, so also does the local attribute; any character that is inserted does not bear the local attribute, whilst the characters moved to the right retain their local attribute.
The following substitute representation is used on data display terminals other than type 9763 and for printers:
The local display attributes LOC EM1- LOC EM4, LOC NOR, LOC DIS and LOC DAR are replaced by the corresponding display attributes
EM1-EM4, NOR, DIS and DAR. There is no substitution for local character set attributes (LOC CHS) and color attributes (LOC COL).
In the case of LOC DAR, the subsequent text characters, which are not visible on the screen, can be printed. The value of DARPRINTABLE defines whether characters substituted for invisible text characters can be printed.
Local attributes can only be entered if the LOCIN=YES option is set in the VTSUCB. Otherwise they are deleted from the input message. Local attributes not supported logically by VTSU are always deleted from the input message.
Note
The logical display control characters EM1-EM4 and NOR, which are located after LOC and followed by EM1-EM4, NOR and DAR, are only effective once the local attribute has been reset (using LOX NOR or LOX LOX). These display control characters also have an effect on characters which are overwritten or inserted.
&P.LOX ctl
Reset local attributes
Effect on input and output:
Local attributes are reset with LOX.
ctl specifies which local attributes are reset.ctl can be:
NOR (local EM1, EM2, EM3, EM4, DIS, NOR or DAR is reset)
CHS (local loadable character set is reset)
COL (choice of color is reset)
LOX (all local attributes are reset).
LOX resets the local attribute to the last valid non-local value.
The following substitute representation is used on data display terminals other than type 9763 and for printers:
LOX NOR and LOX LOX reset the attribute to the last display attribute which was not generated by a substitute layout. There is no substitute representation for local character set attributes (LOX CHS) and local color attributes (LOX COL).
Local attributes can only be received if the LOCIN=YES option is set in the VTSUCB. Otherwise they are deleted from the input message. Local attributes not logically supported by VTSU are always deleted from the input message.
Note
In the case of EXTEND=NO, a logical display control character specified as the last character (EM1, EM2, EM3, EM4, DIS, DAR or NUM) acts on the subsequent input field. This provides a means of imposing the dark, numeric or emphasized attributes on a normal line mode input. If the output is followed not by an input but by another output, the control character has no effect.
To specify a number of characteristics for a field, enter them in the following sequence: &P.CHS dd &P.COL dd &P.EXT &P.FLD xx &P.EXT &P.DIS xx. The logical display control characters must always follow the logical control characters for the field characteristics. Note that if you use the control character &P.COL, and the terminal
supports color, the other display attributes are ignored. Physical sequences are still generated correctly. Same logical buffers are used for color and monochrome screen of type 9763.
If the two logical control characters VPA and HPA are combined, the physical sequences generated differ depending on the positions of the control characters in the buffer.
If the control characters are at the start of the message, the cursor is positioned on the requested coordinates and a start of field with standard attributes is generated.
If the control characters are at the end of the message the cursor is positioned on the requested coordinates and special display formats of the data display terminal are reset to the standard display (normal, standard color, protected). The standard character set is retained.
If the control characters are within the message, the cursor is positioned on the requested coordinates and a start of field with standard attributes is generated. Special display formats of the data display terminal are reset to the standard display (normal, standard color, unprotected in line mode, protected in extended line mode). The standard character set is retained.
Hardcopy support differs in line mode and extended line mode. In extended line mode, a hardcopy of the entire screen is produced. In line mode, a hardcopy is created only of the last field generated by a preceding control character.
Fields generated with the EXT FLD control character must be defined as printable fields.
5. Logical control characters for printer support
Use of the logical control characters for printer support is only effective with EXTEND=NO.
&P.PLD
Partial line down (line subscripted)
Effect on output:
The printer moves half a line up and the subsequent text is printed half a line lower. This is reset by PLU, at the logical end of the line or at end of message.
&P.PLU
Partial line up (line superscripted)
Effect on output:
The printer moves half a line down and the subsequent text is printed half a line higher. This is reset by PLD, at the logical end of line or at end of message.
&P.VMI d
Vertical motion index (line spacing)
VMI is permitted only at the logical start of a page.
Effect on output:
Specifies the line spacing:
d=1: normal spacing (1/6 inch).
d=2: condensed spacing (1/8 inch).
d=3: half-line spacing (1/12 inch).
Is reset by MLN at end of message. The number of lines per page is adjusted to match the new line spacing.
&P.HMI d
Horizontal motion index (character pitch)
HMI is permitted only at the logical start of a line. Any left margin that has been set with LM is reset.
Effect on output:
Specifies the character pitch:
d=1: normal pitch (1/10 inch).
d=2: condensed font A (character pitch 1/12 inch).
d=3: condensed font B (character pitch 1/15 - 1/17 inch).
Reset by MLL and at end of message. The number of characters per line is automatically adjusted.
&P.NLQ
Near letter quality start
Effect on output:
On printers with near-letter quality capability, this feature is turned on by NLQ; otherwise NLQ is ignored. NLQ is reset at the end of the message.
&P.NLX
Near letter quality exit
Effect on output:
The output control character NLX turns off the near-letter quality feature.
&P.LM ddd Left margin
Effect on output:
Sets a left margin. The first character of all subsequent lines is printed in the column specified by ddd.
LM is only permissible at the logical start of line and at the start of a message if there is no CAP at this point. It is reset by HMI, MLL and at the end of the message.
When the left margin is set, several successive backspaces (BS) are permitted. This enables the cursor to be positioned to the left of the left margin.
&P.PTS
Proportional type start
Effect on output:
A visually more pleasing printed result is achieved by individual character spacing.
PTS is effective until the end of the message or PTX.
Column counting is disabled and is not started again until an NL, NP, ASF, VPA or HPA following a PTX is received.
&P.PTX
Proportional type exit
Effect on output:
Deactivates proportional type.
&P.MLL ddd
Maximum line length
Effect on output:
ddd defines the new maximum number of characters per line. Also, the character spacing is set to 1/10 inch, and any left margin is reset. MLL only works at logical start of page and for printers. The defined maximum line length remains effective for the entire duration of the connection unless redefined.
&P.MLN ddd
Maximum line number
Effect on output:
ddd defines the new maximum number of lines per page. It also sets the line spacing to 1/6 inch. MLN only works at logical start of page and for printers. The defined maximum number of lines remains effective for the entire duration of the connection unless redefined.
&P.VPA ddd
Vertical position absolute (three-digit decimal)
Effect on output:
The output text starts in the line designated by ddd.
&P.HPA ddd
Horizontal position absolute (three-digit decimal)
Effect on output:
Subsequent characters in the current line are output starting at the column designated by ddd.
&P.ASF d
Automatic sheet feeding (sheet insertion / ejection control) d= decimal number
Effect on output:
For d=0 at the end of the message a sheet ejection is triggered.When a form feed attachment is used: switchover to tractor.
For d=1,2,3 the sheet ejection is combined with a sheet feed from the feed tray designated by d.
For d=9 sheet insertion takes place from the form feed attachment (9013 Printer only).
&P.CAP
Continue actual position (no positioning to the start of the next line at the beginning of a message)
Effect on output:
Printing starts at the current position of the printer carriage. No resetting of logical control characters at end of message or start of message. Additionally, multiple PLUs and PLDs are allowed. However, only one PLU or PLD is reset at logical end of line.
To ensure that there is a defined initial state, the printer must be positioned to the start of a line with NL, NP or VPA when CAP is used for the first time within an output sequence. CAP is permitted only as the first character in a message. Overwriting may occur when CAP is used for the first time or after a reset sequence (e.g. HMI reset) if the cursor is not explicitly positioned on the start of a new line.
6. Logical control characters with special functions
&P.DEL
Delete
Effect on output:
The character is removed from the output text and is not transmitted to the terminal.
&P.BS
Backspace (only display terminals with APL capability, and printers)
Effect on output:
The next text character is superimposed on the preceding character (to form a compound character not contained in the character set).
A multiple BS is only allowed when a left margin has been set previously with LM.
Meaning for input:
The next text character and the preceding one are treated as a single unit.
Note
For the 9022 Printer, BS (backspace) following SO (shift out into character set extension) is ignored.
&P.SUBSubstitute
Effect on output:
This logical control character and all other EBCDIC control characters (code < X'40') which are not logical control characters are represented on the terminal by the valid substitute character (macro TCHNG SUB=OUTIN).
Effect on input:
The valid substitute character has been detected in the terminal input and replaced (only if requested via the macro TCHNG SUB=OUTIN, see the “TIAM” manual [16 (Related publications)]).
&P.ESCEscape
Effect on output:
Generates the control character ESC (EBCDIC code X'27'). This is transferred together with the next character in unchanged form. This permits the use, in line mode, of terminal device functions that are not logically supported (see descriptions of the respective terminals).
Note
This control character causes the column and line counts by VTSU to be suppressed (no overflow control).
Column counts are resumed by the control characters NL, NP or VPA, line counts (overflow control) are resumed by the control character NP or VPA.
&P.DC4
Treated like ESC by VTSU
Effect on output:
Generates the control character DC4 (EBCDIC code X'3C'). This is transferred together with the following character to the terminal. This permits the use, in line mode, of terminal device functions that are not logically supported (cf. descriptions of the respective terminals).
The effect on column and line counting is as described in the note on the ESC control character.
&P.HT
Horizontal tabulation
Effect on output:
Generates the control character HT (EBCDIC code X'05'), which is passed unchanged to the terminal (cf. descriptions of the respective terminals).
The effect on column and line counting is as described in the note on the ESC control character.
&P.VT
Vertical tabulation
Effect on output:
Generates the control character VT (EBCDIC code X'0B'), which is passed unchanged to the terminal (cf. descriptions of the respective terminals).
The effect on column and line counting is as described in the note on the ESC control character.
&P.EXT TRA d ll Transparent output
Effect on output:
EXT TRA allows the user to transfer control character sequences unchanged (transparently) to data display terminals and printers.
With d, the user can select the devices to which the transparent character sequence is to be transferred:
d = X'00'
The control character sequence is transferred for all device types.
d = device type supplied in TSTAT:
The control character sequence is transferred only for the specified device type.
With ll, the user specifies the length of the transparent control character sequence. ll is specified in two bytes in either decimal (00-99) or binary form (X'0000'-X'7FFF'). The first five bytes (EXT TRA d ll) are not counted as part of the length specification. If the length is greater than the maximum device buffer, EXT is converted to SUB.
Note
If you use the logical control character EXT TRA you can specify any physical control character.
If you use EXT TRA in order to modify positioning, correct overflow control is no longer guaranteed.
&P.EXT RPT dd
The subsequent displayable or NULL character is repeated dd times (repeat symbol)
Effect on output:
EXT RPT enables you to reduce the size of your buffer in the case of multiple repeats of a character.
dd is the number of times you want the subsequent character repeated. dd is specified in two bytes, either in decimal (00-99) or in binary notation (X'0000'-X'7FFF').
Notes on the logical control characters
If a control character is illegal for a particular output device or in its current position, it is ignored together with any associated number following it, or it is replaced (see description of the individual control characters).
If a logical control character that expects a number to follow it is in fact followed by bytes that do not form a legal number (no number or an impossible number), the control character is replaced by SUB and the subsequent characters are treated as text.
If the number following the logical control character is only illegal in special cases (e.g. too large for the current line length), it is processed according to the procedure described under a).
The control characters ASF, VPA and HPA have the effect of a logical end of line and act on the preceding control characters in the same way as NL (reset character set 2 etc.).
Effect of logical display control characters on data display terminals
Terminal | Effect of logical display control characters | |||||
NOR | EM1 | EM2 | EM3 | EM4 | DAR | |
8110 | - 2 | - | - | - | - | - |
8150 | - | - | - | - | - | |
8151 | still | flashing | flashing | flashing | flashing | - |
8152 | roman | italics | italics | italics | italics | - |
8160 | low int. | low int. | low int. | high int. | high int. | blanked |
8160 | high int. | high int. | high int. | low int. | low int. | blanked |
9748 | low int. | low int. | low int. | high int. | high int. | blanked |
9748 | high int. | high int. | high int. | low int. | low int. | blanked |
9752 | yellow | yellow | white | green | red | blanked |
9755 | low int. | low int. | low int. | high int. | high int. | blanked |
9755 | high int. | high int. | high int. | low int. | low int. | blanked |
9763 and 9759 | low int. | low int. | low int. | high int. | high int. | blanked |
9763 and 9759 | high int. | high int. | high int. | low int. | low int. | blanked |
9763 | yellow | cyan | white | green | red | blanked |
9763 | green | red | red | yellow | white | blanked |
3270 OM 1 | low int | high int. | high int. | high int. | high int. | blanked |
3270 OM 2 | high int. | low int. | low int. | low int. | low int. | blanked |
3279 OM 1 | green | red | red | red | red | blue |
3279 OM 2 | green | white | white | white | white | green |
8121 | normal | italics | italics | italics | italics | - |
9001 | normal | underscored | underscored | underscored | underscored | - |
9002 | normal | italics | underscored | italics | italics | - |
9003 | normal | italics | red | italics | red and | - |
9004 | normal | shadow | underscored | fett | bold and | - |
9013 | normal | underscored | underscored | bold | bold and | - |
9012 | normal | underscored | underscored | bold | bold and | - |
9011-18/19 | normal | italics 4 | underscored | bold | bold and | - |
9001-31 / 8931 | normal | italics 4 | underscored | bold | bold and | - |
9021 | normal | italics | underscored | bold | bold and | - |
9022 | normal | shadow | underscored | bold | bold and | - |
1TTY: PT80, T100, T1000
2-: control character is ignored
3BA: Betriebsart
4Only for connection to a 9763 DDT or a BAM controller, otherwise underscored or no effect
Effect of logical display control characters on data display terminals
Terminal | Effect of logical display control characters | ||||
SO | SI | SPA | EPA | NUM | |
8110 | - 2 | - | - | - | - |
8150 | - | - | protected | unprotected | - |
8151 | - | - | protected | unprotected | - |
8152 | APL | first | protected | unprotected | - |
8160 | - | - | protected | unprotected | unprotected |
8162 | second | first | protected | unprotected | unprotected |
9748 | - | - | protected | unprotected | unprotected |
9752 | - | - | protected | unprotected | unprotected |
9755 | - | - | protected | unprotected | unprotected |
9763 / 9759 | - | - | protected | unprotected | unprotected |
9763 | - | - | protected | unprotected | unprotected |
3270 | - | - | protected | unprotected | unprotected |
3279 OM 1 4 | - | - | white | red | red |
3279 OM 2 | - | - | white | white | white |
812x | - | - | - | - | |
9001 | - | - | - | - | - |
9002 5 | second | first | - | - | - |
9003 | second | first | - | - | - |
9004 | second | first | - | - | - |
9013 5 | character set | basic character | - | - | - |
9012 | character set | basic | - | - | - |
9011-18/19 | second | first | - | - | - |
9001-31/ | - | - | - | - | - |
9021 | secondary font | primary font | - | - | - |
9022 | character set | basic | - | - | - |
1TTY: PT80, T100, T1000
2-: control character is ignored
3entries must be numeric
4OM: operating mode
5depending on printer type (see relevant printer manual)
6right half of ISO 8-bit code table; practical for e.g. teletex character set
7left half of ISO 8-bit code table
8right half of ISO 8-bit code table; practical for e.g. teletex character set
9left half of ISO 8-bit code table
Applicability of the logical control characters to individual printers and data display terminals
Type | PLD | LM | PTS | VPA | HPA | ASF | MLL | MLN | BS | CAP | ESC | HT | VT |
9004 | X | X | X | X | X | X | X | X | X | X | X | X | X |
9001 | X | - | - | - | - | - | X | X | - | X | X | X | X |
9003 | - | - | - | - | - | - | X | X | X | X | X | X | X |
9002 | - | - | - | X | X | - | X | X | X | X | X | X | X |
9013 | X | X | X | X | X | X | X | X | X | X | X | X | X |
9012 | X | X | X | X | X | X | X | X | X | X | X | X | X |
9011 | X | - | X | - | X | X | X | X | X | X | X | X | X |
9001-31/ | X | - | X | - | X | - | X | X | X | X | X | X | X |
9022 | X | X | X | X | X | X | X | X | X | X | X | X | X |
9021 | X | - | X | X | X | X | X | X | X | X | X | X | X |
812x | - | - | - | - | - | - | X | X | X | X | X | - | - |
816x | - | - | - | X | * | - | - | - | - | - | X | X | X |
976x | - | - | - | X | * | - | - | - | - | - | X | X | X |
3270 | - | - | - | X | * | - | - | - | - | - | X | X | X |
3279 | - | - | - | X | * | - | - | - | - | - | X | X | X |
Meaning:
X | function is initiated |
- | logical control character is suppressed |
* | if preceded by a legal VPA, the logical control character is suppressed |
Note
The 9022 Printer ignores proportional type unless the current font supports proportional spacing.
Proportional type is impractical with the 9013 Printer unless a suitable character set is selected.
When used on the 9013 and 9002 Printers, the control character VPAddd causes the execution of a number of line feeds defined by ddd.
When used on the 9002 Printer, the control character HPAddd either adds the number of blanks defined by ddd or defines the column as of which the subsequent characters are to be output. You can select either of these two options. The insertion of blanks is the default.
Applicability of logical control characters for output
Terminal | CHS | LOC | EXT | EXT | NLQ | EXT | EXT | COL | EXT |
9763 | X | X | X | X | - | X | X | X | X |
975x | - | 1 | - | X | - | X | X | - | X |
9001 | - | 1 | - | X | - | - | - | - | X |
9012 | - | 1 | - | X | - | - | - | - | X |
9011-18/19 | - | 1 | - | X | X | - | - | - | X |
9001-31/ | - | 1 | - | X | X | - | - | - | X |
9022 | - | 1 | - | X | - | - | - | - | X |
9021 | - | 1 | - | X | - | - | - | - | X |
1substitution takes place (see LOC and LOX control characters)
Meaning:
X | function is initiated |
- | logical control character is suppressed |
Note
On 9763 Data Display Terminals, only the screen formats supplied with TSTAT are supported for the logical control character EXT DIM.
Effect of output attributes
Terminal | FL | UND | BLK | RIN | INV |
8110 | - 1 | - | - | - | - |
815x | - | - | - | - | - |
8160 | flashing | italics | blanked | low intensity | - |
9750 | flashing | underscored / | blanked | low intensity | - |
9755 | flashing | underscored / | blanked | low intensity | - |
9758 | flashing | underscored | blanked | low intensity | inverse |
9763 | flashing | underscored | blanked | low intensity | inverse |
3270 | - | - | blanked and not | low intensity | - |
1-: control character is ignored
2set by jumper or ROM
3selectable by SIDATA
Effect of field attributes
Terminal | PNS | PRS | NUF | MOD | MAR | PRT | ASK |
8110 | - 1 | - | - | - | - | - | - |
815x | - | - | - | - | - | - | - |
8160 | protected | protected | numeric | p | markable | printable | - |
9750 | protected | protected | numeric | p | markable | printable | - |
9755 | protected | protected | numeric | p | markable | printable | - |
9758 | protected | protected | numeric | p | markable | printable | - |
9763 | protected | protected | numeric | p | markable | printable | - |
3270 | protected | - | numeric | p | selectable 2 | printable 3 | protected |
1-: control character is ignored
2the first character in the field is a destination character
3on a 3270 terminal, a non-printable field is automatically blanked
Character spacing and line spacing for the individual printers (in inches)
Printer | HMI1 | HMI2 | HMI3 | VMI1 | VMI2 | VMI3 |
9004 | 1/10 | 1/12 | 1/15 | 1/6 | 1/8 | 1/12 |
9001 | 1/10 | 1/12 | 1/17 | 1/6 | 1/8 | 1/12 |
9003 | 1/10 | 1/12 | 1/15 | 1/6 | 1/8 | 1/12 |
9002 | 1/10 | 1/10 | 1/10 | 1/6 | 1/6 | 1/6 |
9013 | 1/10 | 1/12 | 1/15 | 1/6 | 1/8 | 1/12 |
9012 | 1/10 | 1/12 | 1/12 | 1/6 | 1/8 | 1/12 |
9011 | 1/10 | 1/12 | 1/15 | 1/6 | 1/8 | 1/12 |
900131/8931 | 1/10 | 1/12 | 1/15 | 1/6 | 1/8 | 1/12 |
9022 | 1/10 | 1/12 | 1/15 | 1/6 | 1/8 | 1/12 |
9021 | 1/10 | 1/12 | 1/15 | 1/6 | 1/8 | 1/12 |
812x | 1/10 | 1/10 | 1/10 | 1/6 | 1/6 | 1/6 |
Note
On the 9011-31/8931 Printer, bold (EM3, EM4) is not executed after HM13.
On the 9021 Printer, HM13 is executed with 1/15“ only when a suitable font has been selected; otherwise the next smallest character spacing is used.
Effect of reset at connect time on logically supported functions
Printer | HMI | VMI | PTS | SO | CHS | ASF | EM1-4 | NLQ | CR |
9001 | 1/10 | S | - | - | ZV1 | - | R | - | S |
9004 | S | S | R | R | - | ASF1 | R | - | - |
9013 | S | S | R | R | S | ASFn, | R | - | S |
9012 | M | M | M | R | M | ASFn, | R | M | M |
9011 | M | M | M | R | M | Tract | EM1: M | M | M |
9001-31/8931 | S | S | R | - | ZV1 | - | R | S | - |
9022 | S | S | R | R | R | ASF1 | R | - | - |
9021 | S | S | R | R | R | ASF1 | R | - | - |
VTSU default | 1/10 | 1/6 | R | R 1 | CS1 | - | R | R | CR |
1Left half of the ISO 8-bit code table for printers with 8-bit character sets; otherwise basic character set)<sup>1</sup>Left half of the ISO 8-bit code table for printers with 8-bit character sets; otherwise basic character set
Meaning:
S | Reset to switch setting |
M | Reset to menu setting |
R | Reset |
- | No logical support for function |
CS | Character set |
n(S) | n defined by switch setting |
n(M) | n defined by menu selection |
Note
VTSU defaultIt is assumed for the logical support of these functions that the VTSU default values are set by menu or switch settings. Any differences from the default settings are the responsibility of the user.
Automatic sheet feedFor the 9011-18/19 Printer, the menu setting for automatic sheet feed (ASF) simply means selection of tractor or sheet feeder.
Layout of the DSECT
VTCSET BSP 1 * 1 * VIRTUAL TERMINAL CONTROL CHARACTER SET 1 * 1 * 1 * LOGICAL RECORD DELIMITERS 1 * 1 BSPNL EQU X'15' LOGICAL LINE END (CONT NEXT LINE) 1 BSPNP EQU X'0C' LOGICAL PAGE END (CONT NEXT PAGE) 1 BSPCL EQU X'0D' LOGICAL LINE END (CONT SAME LINE) 1 BSPVPA EQU X'29' LOG VERTICAL POS ABSOLUT (CONT LINE N) 1 BSPHPA EQU X'2A' LOG HORIZONT POS ABSOLUT (CONT COL N) 1 BSPASF EQU X'21' LOG SHEED FEDDING FROM CASETTE N D1 1 BSPCAP EQU X'20' CONTINUE ACTUAL POSITION AT MSG BEGIN 1 * 1 * LOGICAL UNIT DELIMITERS 1 * 1 BSPEM1 EQU X'1D' EMPHASIZED LAYOUT 1 1 BSPEM2 EQU X'1F' EMPHASIZED LAYOUT 2 1 BSPEM3 EQU X'13' EMPHASIZED LAYOUT 3 1 BSPEM4 EQU X'14' EMPHASIZED LAYOUT 4 1 BSPNOR EQU X'1E' NORMAL LAYOUT 1 BSPDAR EQU X'12' DARK LAYOUT 1 BSPPLD EQU X'2B' PARTIAL LINE DOWN 1 BSPPLU EQU X'2C' PARTIAL LINE UP 1 * 1 BSPSO EQU X'0E' SHIFT OUT TO 2ND CHARACTER SET 1 BSPSI EQU X'0F' SHIFT IN TO NORMAL CHARACTER SET 1 * 1 BSPSPA EQU X'36' START PROTECTED AREA 1 BSPEPA EQU X'08' END PROTECTED AREA 1 BSPNUM EQU X'11' START NUMERIC (UNPROTECTED) AREA 1 * 1 BSPCHS EQU X'06' CHARACTER SET D1D2 1 BSPCOL EQU X'17' COLOUR CHOICE 1 BSPLOC EQU X'09' LOCAL ATTRIBUTE START S1 1 BSPLOX EQU X'0A' LOCAL ATTRIBUTE EXIT S1 1 * 1 BSPVMI EQU X'24' VERTICAL MOVEMENT INDICATOR D1 1 BSPHMI EQU X'23' HORIZONTAL MOVEMENT INDICATOR D1 1 BSPLM EQU X'38' LEFT MARGIN D1D2D3 1 BSPPTS EQU X'1A' PROPORTIONAL TYPING START 1 BSPPTX EQU X'1B' PROPORTIONAL TYPING END 1 BSPMLL EQU X'33' MAXIMAL LINE LENGTH 1 BSPMLN EQU X'35' MAXIMAL LINE NUMBER (ON PAGE) 1 BSPNLQ EQU X'39' NEAR LETTER QUALITY START
1 BSPNLX EQU X'3B' NEAR LETTER QUALITY EXIT 1 * 1 * SPECIAL FUNCTIONS 1 * 1 BSPDEL EQU X'07' DELETE 1 BSPBS EQU X'16' BACKSPACE 1 BSPSUB EQU X'3F' SUBSTITUTE 1 * 1 * DELIMITER EXTENSION 1 * 1 BSPEXT EQU X'3E' DELIMITER EXTENSION BYTE 1 * 1 * EXTENDED LOGICAL DELIMITERS 1 * 1 BSPTRA EQU C'T' TRANSPARENT OUTPUT X1L1L2 1 BSPDIM EQU C'D' DIMENSION OF SCREEN D1D2D3D4D5 1 BSPRPT EQU C'R' REPEAT NEXT CHARACTER NN TIMES 1 BSPDIS EQU C'I' SET DISPLAY ATTRIBUTES 1 BSPRS EQU X'00' RESET DISPLAY ATTRIBUTES 1 BSPFL EQU X'01' FLASHING 1 BSPUND EQU X'02' UNDERSCORED 1 BSPBLK EQU X'04' BLANKED 1 BSPRIN EQU X'08' REDUCED INTENSITY 1 BSPINV EQU X'10' INVERSE 1 BSPFLD EQU C'F' SET FIELD CHARACTERISTICS 1 BSPINP EQU X'00' INPUT FIELD 1 BSPPNS EQU X'01' PROTECTED NOT SENDABLE 1 BSPPRS EQU X'20' PROTECTED SENDABLE 1 BSPNUF EQU X'02' NUMERIC 1 BSPMOD EQU X'04' PRE-MODIFIED 1 BSPMAR EQU X'08' MARKABLE 1 BSPPRT EQU X'10' PRINTABLE 1 BSPASK EQU X'40' AUTOMATIC SKIP 1 * 1 * 1 * PHYSICAL UNIT DELIMITERS 1 * 1 BSPESC EQU X'27' ESCAPE X 1 BSPDC4 EQU X'3C' DC4 X 1 BSPHT EQU X'05' HORIZONTAL TABULATION 1 BSPVT EQU X'0B' VERTICAL TABULATION 1 * 1 *,VTCSET 080 941024 53531028
An example of extended line mode is given at the end of the WRTRD macro description (Example 5).