Adjunct values

GDDM V3R2 Base Application Programming Reference

Adjunct values

GDDM V3R2 Base Application Programming Reference
SC33-0868-02

Table 42 summarizes valid settings for adjunct fields. Information for each type of adjunct is given in the following text.


Table 41. Adjunct field naming conventions
Adjunct	Length	COBOL name	Assembler name	PL/I name
Selector	1	XXX-SEL	XXXS	XXX_SEL
Cursor	1	XXX-CURSOR	XXXCR	XXX_CURSOR
Base attribute	1 1	XXX-ATTR-SEL XXX-ATTR	XXXAS XXXA	XXX_ATTR_SEL XXX_ATTR
Extended highlighting	1 1	XXX-HI-SEL XXX-HI	XXXHS XXXH	XXX_HI_SEL XXX_HI
Color	1 1	XXX-COL-SEL XXX-COL	XXXCS XXXC	XXX_COL_SEL XXX_COL
PS	1 1	XXX-PS-SEL XXX-PS	XXXPS XXXP	XXX_PS_SEL XXX_PS
Validation	1 1	XXX-VAL-SEL XXX-VAL	XXXVS XXXV	XXX_VAL_SEL XXX_VAL
Outlining	1 1	XXX-OUT-SEL XXX-OUT	XXXOS XXXO	XXX_OUT_SEL XXX_OUT
Length	2	XXX-LENGTH	XXXL	XXX_LENGTH


Table 42. Values used in adjunct fields
Adjunct	Value (See Note 1)	Meaning
Selector	C' '	MSPUT: Any data value is ignored. The field is unchanged (see Note 2).
Selector	C' '	MSGET: Neither the application nor the operator has put a value in it.
Selector	C'1'	MSPUT: The field contains a value.
Selector	C'1'	MSGET: The field contains a value that the operator has just modified.
Selector	C'2'	MSPUT: The field is to be reset to its map-defined default value. The data value is ignored. On a subsequent MSGET, the field contains its default value and the selector is C'3'.
Selector	C'2'	MSGET: not used.
Selector	C'3'	MSPUT: The field contains a value. (that is, the same as C'1').
Selector	C'3'	MSGET: The field contains a value that has not just been modified by the operator.
Cursor	C' '	MSPUT: The cursor is not in this field.
Cursor	C' '	MSGET: The cursor is not in this field.
Cursor	C'1'	MSPUT: The cursor is in this field.
Cursor	C'1'	MSGET: The cursor is in this field (set only if map is a cursor rece iver).
The cursor position within the field can be controlled by using the MSCPOS call, and verified by using the MSQPOS call.
Attribute Selector (first byte of adjunct)	C' '	The attribute is unchanged (see Note 2). The attribute byte (the second byte) is ignored.
Attribute Selector (first byte of adjunct)	C'1'	Change the attribute to the value in the second byte.
Attribute Selector (first byte of adjunct)	C'2'	Reset the attribute to the map-defined default value.
Attribute Selector (first byte of adjunct)	C'3'	Change the attribute to the value in the second byte (same as C'1'). After an MSGET, the attribute selector is set to C'3' and the attribute byte set to the current attribute value.
Attribute Value (second byte of attribute adjunct)	Ignored unless the attribute selector is C'1' or C'3'. Otherwise, the valid value depends on the attribute type, as follows: C' ' Default for all attributes. X'00' Default for all attributes.
Base attribute	A valid 3270 attribute if used. These values are defined mnemonically in ADMUAIMC (Assembler), ADMUCIMC (COBOL), and ADMUPIMC (PL/I). For example: C' ' Unprotected C'H' Unprotected, Intensified C'-' Protected C'Y' Protected, Intensified C'0' Autoskip B'`xx......`' Ignored (set by GDDM) B'`..1.....`' Protected B'`..0.....`' Unprotected B'`...0....`' Alphanumeric B'`..01....`' Unprotected numeric B'`..11....`' Autoskip B'`....00..`' Normal B'`....01..`' Selectable B'`....10..`' Intensified selectable B'`....11..`' Nondisplay B'`......x.`' Ignored (set by GDDM) B'`.......1`' Modified data tag set B'`.......0`' Modified data tag not set
Extended high-lighting attribute	C' '	No extended highlighting.
Extended high-lighting attribute	C'1'	Blinking.
Extended high-lighting attribute	C'2'	Reverse video.
Extended high-lighting attribute	C'4'	Underscore.
Color attribute	C' '	Default.
Color attribute	C'1'	Blue.
Color attribute
Color attribute	C'2'	Red.
Color attribute	C'3'	Magenta (pink).
Color attribute	C'4'	Green.
Color attribute	C'5'	Turquoise (cyan).
Color attribute	C'6'	Yellow.
Color attribute	C'7'	White/Neutral.
PS attribute	C' '	Default character set.
PS attribute	X'41'-X'DF'	PS code of any symbol set specified in PS Set Management in GDDM-IMD, or loaded using PSDSS, PSLSS, or PSLSSC.
Validation attribute	C' '	No validation.
Validation attribute	X'00'	No validation.
Validation attribute	X'01'	Trigger.
Validation attribute	X'02'	Mandatory enter.
Validation attribute	X'04'	Mandatory fill.
Validation attributes can be ORed together to give two or more validation attributes to the same field. For example, specify X'03' to give a field the mandatory enter and trigger attributes (X'02' OR X'01'=X'03').
Outlining attribute	C' '	No outlining.
Outlining attribute	X'00'	No outlining.
Outlining attribute	X'01'	Underline.
Outlining attribute	X'02'	Vertical line on right.
Outlining attribute	X'04'	Overline.
Outlining attribute	X'08'	Vertical line on left.
Outlining attributes can be ORed together to give two or more outlining attributes to the same field. For example, specify X'03' to give a field with underlining and a vertical line on the right (X'02' OR X'01'=X'03').
Length	Binary value	Length, in characters, of the data.

Notes:

1. In this table, C'c' indicates character data type, X'x' indicates hexadecimal data type, and B'bbbbbbbb' indicates a binary pattern.

2. On an MSPUT call with option 0 ("WRITE"), all fields and attributes are reset to their map-defined default value, before the application data area is processed. Therefore, an attribute selector or field selector of C' ' has the net effect of resetting the value to default, when used on an MSPUT call with option 0, or of leaving the value unchanged, when used on an MSPUT call with option other than zero.

The application program sets the values required for a send request. GDDM sets the values associated with input data returned for a receive request. On a send request, each field must contain one of the settings given for it in Table 42.

Subtopics:

Notices | Terms of use | Support | Contact z/OS