Menu principal                 [Fechar]
Introdução
Divisões
Identification Division
Environment Division
Data Division
Procedure Division
Comandos CICS
VSAM - File Status
Quadros importantes
SQL - Structured Query Language
Outros programas
Rotinas prontas
Palavras reservadas
Introdução ao Oracle
Sites de busca
Sites interessantes
Meu e-mail

CICS Manual do Usuário - DFHMDI


Volta a página anterior

Volta ao Menu Principal


Desenvolvido por DORNELLES Carlos Alberto - Analista de Sistemas - Brasília DF.

DFHMDI

Partition definition.

The DFHMDI macro defines a map within the mapset that was defined by the previous DFHMSD macro. A map contains zero or more fields.

Syntax 

map    DFHMDI
       [,SIZE=(line,column)]
       [,CTRL=([PRINT]
         [,length]
         [,FREEKB]
         [,ALARM]
         [,FRSET])]
       [,EXTATT={NO | MAPONLY | YES}]
       [,COLOR={DEFAULT | color}]
       [,HILIGHT={OFF | BLINK | REVERSE | UNDERLINE}]
       [,PS={BASE | psid}]
       [,VALIDN=([MUSTFILL][,MUSTENTER][,TRIGGER])]
       [,COLUMN=number]
       [,LINE=number]
       [,FIELDS=NO]                                 (1)
       [,MAPATTS=(attr1,attr2,...)]
       [,DSATTS=(attr1,attr2,...)]
       [,OUTLINE={BOX |
         ([LEFT][,RIGHT][,OVER][,UNDER])}]
       [,DSATTS=(attr1,attr2,...)]
       [,SOSI={NO | YES}]
       [,TRANSP={YES | NO}]               (1)
       [,JUSTIFY=BOTTOM]
       [,DATA={FIELD | BLOCK}]
 
(1) Not supported by CICS, therefore ignored;
    see operand description for more information.

Description

map is the one- to seven-character name of the map.

If the maps are for use in a COBOL program, and STORAGE=AUTO has not been specified in the DFHMSD macro, they must be specified in descending size sequence.
Size refers to the generated 01 level data areas and not to the size of the map that is on the screen.
You cannot use DSATTS=YES if you specify DATA=BLOCK.

Operands

  • COLOR
    • Indicates the color that is to be used for the named map.
    • This overrides the COLOR operand of the DFHMSD macro, and is in turn overridden for individual fields by the COLOR operand of the DFHMDF macro.
    • When the map is displayed, the COLOR operand is ignored unless the terminal supports color.
      • color
        • Specifies the basic color that is to be used for this map.
        • The valid colors are:
          • BLUE
          • GREEN
          • NEUTRAL
          • PINK
          • RED
          • TURQUOISE
          • YELLOW
      • DEFAULT
        • Specifies that the default color for the output device is to be used as the basic color for this map.
  • COLUMN
    • Specifies the column in a line at which the map is to be placed; that is, it establishes the left map margin.
    • number is the column from the left margin where the map is to be established.
  • CTRL
    • Specifies control actions that are to be performed when the map is displayed.
    • Use of any of the control options that are in the SEND MAP command overrides all control actions that are specified in the DFHMDI macro, which in turn override all control actions that are specified in the DFHMSD macro.
      • PRINT
        • Must be specified if the printer is to be started; if omitted, the data is sent to the printer buffer but is not printed.
        • This operand is ignored if the map is used with 3270 displays that do not have the Printer Adapter feature.
      • length
        • Indicates the line length on the printer; it can be specified as:
          • L40
          • L64
          • L80
          • HONEOM
        • L40, L64, and L80 force a new line after 40, 64, and 80 characters respectively.
        • HONEOM causes the default printer line length to be used. If the length value is omitted, BMS sets the line length to 64.
      • FREEKB
        • Specifies that the keyboard is to be unlocked after the map has been sent.
        • If FREEKB is not specified, the keyboard remains locked; data entry from the keyboard is inhibited until this status is changed.
      • ALARM
        • Specifies that the alarm feature is to be activated.
      • FRSET
        • Specifies that the Modified Data Tags (MDTs) of all fields that are currently in the terminal buffer are to be reset to the not-modified condition (that is, field reset) before any map data is written to the buffer.
        • This allows the DFHMDF macro with the ATTRB operand to control the final status of any fields that were written or rewritten in response to a BMS command.
  • DATA
    • Specifies the format of the data. This parameter is supported only for compatibility with CICS mainframe.
    • The format of the data can be one of the following:
      • FIELD
        • Specifies that the data is passed as contiguous fields.
        • This is the default. Each field has the format: 
          vv a datafield

          where:

          • vv is a 16-bit value that specifies the data as input from the terminal (ignored in output processing).
          • a is an 8-bit value into which you can place an attribute that overrides the attribute that is specified in the map that is used to process this data (see copybook DFHBMSCA).
          • datafield represents the actual data.
      • BLOCK
        • This is not supported on Open CICS.
  • DSATTS
    • Specifies the attribute types that are to be included in the symbolic description map.
    • These types can be one or more of the following:
      • COLOR
      • HILIGHT
      • OUTLINE
      • PS
      • SOSI
      • TRANSP
      • VALIDN
    • Any type that is included in DSATTS should also be included in MAPATTS.
      • Note:
        • TRANSP is supported only for application portability; it is ignored by TXSeries for Multiplatforms.
    • The attribute types that are specified in the DSATTS operand on the DFHMDI macro override any types that are inherited from the DFHMSD macro for the mapset.
  • EXTATT
    • This operand is supported for compatibility with early releases of IBM mainframe-based CICS.
    • For new maps, the DSATTS and MAPATTS operands should be used instead.
    • If DSATTS or MAPATTS is specified in addition to EXTATT, the attribute types are combined.
    • For example, EXTATT=MAPONLY and MAPATTS=SOSI is equivalent to MAPATTS=(COLOR,HILIGHT,PS,SOSI).
      • NO
        • Equivalent to specifying neither the DSATTS operand nor the MAPATTS operand.
      • YES
        • Equivalent to: 
                        MAPATTS=(COLOR,HILIGHT,PS)
               DSATTS=(COLOR,HILIGHT,PS)
      • MAPONLY
        • Equivalent to: 
                        MAPATTS=(COLOR,HILIGHT,PS)
  • FIELDS
    • This operand is not supported by TXSeries for Multiplatforms and should not be used in applications that are developed to run under TXSeries for Multiplatforms.
    • However, if this operand is present (for example, in a migrated map) the BMS processor issues a warning message and ignores it.
    • Generation of the map continues; the usability of the map is not affected.
  • HILIGHT
    • Specifies the default highlighting attribute for all fields that are in the named map.
    • This overrides the HILIGHT operand of the DFHMSD macro, and is in turn overridden for individual fields by the HILIGHT operand of the DFHMDF macro.
      • OFF
        • The default. It indicates that no highlighting is used.
      • BLINK
        • Specifies that the field must blink.
      • REVERSE
        • Specifies that the character or field is displayed in reverse video.
      • UNDERLINE
        • Specifies that a field is underlined.
    • When the map is displayed, the HILIGHT operand is ignored unless the terminal supports highlighting.
  • JUSTIFY
    • Specifies that the map is to be positioned at the bottom of the screen.
    • This operand applies to the SEND MAP command, provided that the number of lines in the map is specified in the SIZE operand; otherwise, it is ignored. No account is taken of trailer maps in the mapset.
    • JUSTIFY=BOTTOM is equivalent to specifying 
      LINE=(screendepth - mapdepth + 1)
    • On the map definition, but it allows the same map to be used for different screen sizes.
    • If JUSTIFY=BOTTOM and the LINE operand are both specified, the value that is specified in LINE is ignored.
  • LINE
    • Specifies the starting line on which data for a map is to be formatted.
    • number is a value in the range 1 through 240, specifying a starting line number.
  • MAPATTS
    • Specifies the attribute types that are to be included in the physical map.
    • These types can be one or more of the following:
      • COLOR
      • HILIGHT
      • OUTLINE
      • PS
      • SOSI
      • TRANSP
      • VALIDN
    • Note:
      • TRANSP is supported only for application portability; it is ignored by TXSeries for Multiplatforms.
    • The MAPATTS list must include all the attribute types that are to be specified for individual fields in the map (DFHMDF macro).
    • If a value is specified in a DFHMDF macro for an attribute type that is not in the (effective) MAPATTS list for the map, the BMS processor issues a warning message and ignores the operand.
    • The attribute types specified in the MAPATTS operand on the DFHMDI macro override any types inherited from the DFHMSD macro for the mapset.
  • OUTLINE
    • Allows lines to be included above, below, to the left, or to the right of a field.
    • You can use these lines in any combination to construct boxes around fields or group fields.
      • BOX
        • Constructs a box around the field.
      • LEFT
        • Puts a line to the left of the field.
      • RIGHT
        • Puts a line to the right of the field.
      • OVER
        • Puts a line at the top of the field.
      • UNDER
        • Puts a line at the bottom of the field.
  • PS
    • Specifies that programmed symbols are to be used.
    • This overrides the PS operand of the DFHMSD macro, and is in turn overridden for individual fields by the PS operand of the DFHMDF macro.
      • BASE
        • Specifies that the base symbol set is to be used.
      • psid
        • Specifies a single character that identifies the set of programmed symbols that is to be used.
    • If PS is specified but is not in the MAPATTS list for the map, the BMS processor issues a warning message and adds PS to the MAPATTS list.
    • The PS operand is ignored unless the terminal supports programmed symbols.
  • SIZE
    • Specifies the size of a map.
    • An entry is required for this option.
      • line
        • A value in the range 1 through 240 that specifies the depth of a map as a number of lines.
      • column
        • A value in the range 1 through 240 that specifies the width of a map as a number of columns.
    • This operand is required if an associated DFHMDF macro with the POS operand is used.
    • The map dimensions that are specified in the SIZE operand of the DFHMDI macro that is defining a map might be smaller than the actual screen size as defined for the terminal.
  • SOSI
    • Indicates whether Multi-Byte Character Set (MBCS) data can be entered into the field by the user.
    • If SOSI is specified but is not in the MAPATTS list for the map, the BMS processor issues a warning message and adds SOSI to the MAPATTS list.
  • TRANSP
    • This operand is not supported by TXSeries for Multiplatforms and should not be used in applications that are developed to run under TXSeries for Multiplatforms.
    • However, if this operand is present (for example, in a migrated map) the BMS processor issues a warning message and ignores it.
    • Generation of the map continues; the usability of the map is not affected.
  • VALIDN
    • Specifies that validation is to be used on an 8775 terminal.
    • This overrides the VALIDN operand of the DFHMSD macro, and is in turn overridden by the VALIDN operand of the DFHMDF macro.
    • TXSeries for Multiplatforms does not support this operand for all terminals.
      • MUSTFILL
        • Specifies that the field must be filled completely with data. An attempt to move the cursor from the field before it has been filed, or to transmit data from an incomplete field, causes the inhibit input condition.

      • MUSTENTER
        • Specifies that data must be entered into the field, although it need not fill the field.
        • An attempt to move the cursor from an empty field causes the inhibit input condition.
      • TRIGGER
        • Specifies that this field is a trigger field.
© Copyright IBM Corp.