BMS constants

This information describes the BMS-related standard attribute and printer control characters, a bitmap for attributes, MSR control value constants, and attention identifier constants.

Standard list DFHBMSCA

The standard list DFHBMSCA makes it simpler to provide field attributes and printer control characters. Table 1 lists the symbolic names for the various combinations of attributes and control characters. If you need combinations other than the ones shown, you must generate them separately. To help you do this, see Table 2 for a bitmap of attributes. To find the value of an attribute constant, see the 3274 Control Unit Reference Summary GA27-2827.

You can get the standard attribute and printer character control list by copying copybook DFHBMSCA into your application.
  • For COBOL users, it consists of a set of 01 statements that can be copied into the working storage section.
  • For C® users, it is included in applications as follows: 
    #include "dfhbmsca.h"
  • For PL/I users, it consists of DECLARE statements defining elementary character variables.
  • For Assembler language users, the list consists of a set of EQU statements.

You must use the symbolic name DFHDFT in the application structure to override a map attribute with the default. You can use a high value, such as X'FF', to reset the COLOR, HILIGHT, OUTLINE, PS, SOSI, or VALIDN attributes to their default values. To specify default values in a set attribute (SA) sequence in text build, use the symbolic names DFHDFCOL, DFHBASE, or DFHDFHI.

Table 1. Standard attribute and printer control character list, DFHBMSCA
Constant Meaning
DFHBMPEM Printer end-of-message
DFHBMPNL Printer new-line
DFHBMPFF Printer form feed
DFHBMPCR Printer carriage return
DFHBMASK Autoskip
DFHBMUNP Unprotected
DFHBMUNN Unprotected and numeric
DFHBMPRO Protected
DFHBMBRY Bright
DFHBMDAR Dark
DFHBMFSE MDT set
DFHBMPRF Protected and MDT set
DFHBMASF Autoskip and MDT set
DFHBMASB Autoskip and bright
DFHBMPSO shift-out value X'0E'.
DFHBMPSI shift-in value X'0F'.
DFHBMEOF Field erased
DFHBMCUR Field containing cursor flagged
DFHBMEC Erased field containing cursor (COBOL only)
DFHBMFLG Flags (COBOL only)
DFHBMDET Field detected
DFHSA Set attribute (SA) order. For text processing only. Use for constructing embedded set attribute orders in user text.
DFHERROR Error code
DFHCOLOR Color. For text processing only. Use for constructing embedded set attribute orders in user text.
DFHPS Programmed symbols. For text processing only. Use for constructing embedded set attribute orders in user text.
DFHHLT Highlight. For text processing only. Use for constructing embedded set attribute orders in user text.
DFH3270 Base 3270 field attribute. For text processing only. Use for constructing embedded set attribute orders in user text.
DFHVAL Validation
DFHOUTLN Field outlining attribute code
DFHBKTRN Background transparency attribute code
DFHALL Reset all to defaults. For text processing only. Use for constructing embedded set attribute orders in user text.
DFHDFT Default
DFHDFCOL Default color. For text processing only. Use for constructing embedded set attribute orders in user text.
DFHBLUE Blue
DFHRED Red
DFHPINK Pink
DFHGREEN Green
DFHTURQ Turquoise
DFHYELLO Yellow
DFHNEUTR Neutral
DFHBASE Base programmed symbols. For text processing only. Use for constructing embedded set attribute orders in user text.
DFHDFHI Normal. For text processing only. Use for constructing embedded set attribute orders in user text.
DFHBLINK Blink
DFHREVRS Reverse video
DFHUNDLN Underscore
DFHMFIL Mandatory fill. Cannot be used in set attribute orders.
DFHMENT Mandatory enter. Cannot be used in set attribute orders.
DFHMFE Mandatory fill and mandatory enter
DFHMT Trigger
DFHMFT Mandatory fill and trigger
DFHMET Mandatory enter and trigger
DFHMFET Mandatory fill and mandatory enter and trigger
DFHUNNOD Unprotected, nondisplay, nonprint, nondetectable, MDT
DFHUNIMD Unprotected, intensify, light-pen detectable, MDT
DFHUNNUM Unprotected, numeric, MDT
DFHUNNUB Unprotected, numeric, intensify, intensify, light-pen detectable
DFHUNINT Unprotected, numeric, intensify, light-pen detectable, MDT
DFHUNNON Unprotected, numeric, nondisplay, nonprint, nondetectable, MDT
DFHPROTI Protected, intensify, light-pen detectable
DFHPROTN Protected, nondisplay, nonprint, nondetectable
DFHDFFR Default outline
DFHUNDER Underline
DFHRIGHT Right vertical line
DFHOVER Overline
DFHLEFT Left vertical line
DFHBOX Underline and right vertical and overline and left vertical
DFHSOSI SOSI=yes
DFHTRANS Background transparency
DFHOPAQ No background transparency
Table 2. Bitmap for attributes
prot a/n hi spd ndp mdt ebcd asci char
U           40 20 b (blank)
U         Y C1 41 A
U     Y     C4 44 D
U     Y   Y C5 45 E
U   H Y     C8 48 H
U   H Y   Y C9 49 I
U       Y   4C 3C <
U       Y Y 4D 28 (
U N         50 26  
U N       Y D1 4A J
U N   Y     D4 4D M
U N   Y   Y D5 4E N
U N H Y     D8 51 Q
U N H Y   Y D9 52 R
U N     Y   5C 2A *
U N     Y Y 5D 29 )
P           60 2D - (hyphen)
P         Y 61 2F /
P     Y     E4 55 U
P     Y   Y E5 56 V
P   H Y     E8 59 Y
P   H Y   Y E9 5A Z
P       Y   6C 25 %
P       Y Y 6D 5F _ (underscore)
P S         F0 30 0
P S       Y F1 31 1
P S   Y     F4 34 4
P S   Y   Y F5 35 5
P S H Y     F8 38 8
P S H Y   Y F9 39 9
P S     Y   7C 40 @
P S     Y Y 7D 27 '
Table 3. Key to attributes and settings in bitmap
Code Meaning
a/n Automatic skip or numeric
asci American National Standard Code for Information Interchange
char Graphic character equivalent to hex code
ebcd Extended binary coded decimal interchange code
hi High intensity
H High
mdt modified data tag
ndp nondisplay print
N Numeric
prot Protected
P Protected
spd Selector pen detectable
S Automatic skip
U Unprotected
Y Yes

Magnetic slot reader (MSR) control value constants

A selection of MSR control value constants has been created for CICS® and stored in copybook DFHMSRCA. The patterns are stored as named constants that can be loaded by simple application program commands. Provision of such constants saves the programmer from having to build a commonly used bit pattern whenever it is required.

MSR control byte values

A selection of MSR control byte values has been created for CICS and stored in the copybook DFHMSRCA. The following table shows you the meaning of each bit.

Table 4. Standard list DFHMSRCA
Constant Meaning
DFHMSRST MSR reset. All lights and buzzers off. MSR available for input.
DFHMSCON Transaction ready for more input. Green and yellow on; emit short buzz; IN PROCESS (user) mode set.
DFHMSFIN Input complete. Green on; emit short buzz; IN PROCESS mode reset.
DFHMSALR Operator alert. Green, yellow, and red on; emit long buzz; IN PROCESS mode reset.
DFHMSALS Operator alert. Green, yellow, and red on; emit long buzz; IN PROCESS mode set.
DFHMSIPY IN PROCESS state set. Yellow on.
DFHMSIPN IN PROCESS state reset.
DFHMSLKY MSR operation inhibited. Yellow on.
DFHMSLKN MSR input allowed. Green on. Yellow on.
DFHMSAEY MSR autoenter on. Yellow on.
DFHMSAEN MSR autoenter off. Yellow on.
DFHMSLBN Long buzzer suppressed. Yellow on.
DFHMSLBY Long buzzer permitted. Yellow on.
DFHMSSBN Short buzzer suppressed. Yellow on.
DFHMSSBY Short buzzer permitted. Yellow on.
DFHMSNOP Leave all MSR settings unchanged.

STATE MASK

If a bit is on in the STATE MASK byte, the state it represents is adopted by the device if the corresponding bit is also on in the STATE VALUE byte.

0 USER
User mode. Turn on the yellow light if the same bit is on in STATE VALUE.
1 LOCK
Locked/Unlocked. If locked, MSR input is inhibited.
2 AUTO
Autoenter on/off. If set on, any card read by the MSR causes an ENTER operation. If off, only a secure card causes an ENTER.
3 Ai1S
Suppress audible alarm 1.
4 Ai2S
Suppress audible alarm 2.

STATE VALUE

Modifies state to on or off if the corresponding bit is set on in STATE MASK.

INDICATOR MASK

Performs a similar function to STATE MASK, but for indicators.

0
Light 1 (Green)
1
Light 1 (Green)
2
Light2 (Yellow)
3
Audible alarm 1 (Long buzz)
4
Audible alarm 2 (Short buzz)

INDICATOR VALUE

Performs a similar function to STATE VALUE.

Attention identifier constants

The standard attention identifier list, DFHAID, simplifies testing the contents of the EIBAID field. The following table shows you the symbolic name for the attention identifier (AID) and the corresponding 3270 function.

You can get a copy of the list by copying DFHAID into your application program. For COBOL users, it consists of a set of 01 statements that must be copied into the working-storage section. For C users, it consists of a series of defined constants. For PL/I users, it consists of DECLARE statements defining elementary character variables.

Table 5. Standard list DFHAID
Constant Meaning
DFHENTER ENTER key.
DFHCLEAR CLEAR key.
DFHPA1– DFHPA3 PA1–PA3 keys.
DFHPF1– DFHPF24 PF1–PF24 keys.
DFHOPID OPERID or MSR.
DFHMSRE Extended (standard) MSR.
DFHTRIG Trigger field.
DFHPEN SELECTOR PEN or CURSOR SELECT key.
DFHCLRP CLEAR PARTITION key. Does not apply to minimum function BMS.
DFHSTRF Structured field pseudo-AID. Does not apply to minimum function BMS.