Format library member selection

When a message is received as input or prepared for output, the DIF or DOF is selected on the basis of the user-provided name from the message descriptor and the device type and features of the terminal.

The MFS language utility constructs the member name of each DIFand DOF in the IMS.FORMAT library from the FMT label and the DEV TYPE= and FEAT= specifications as follows:
Byte
Contents
1
Device type indicator (hexadecimal). For a list of device types by indicator, see the following table.
2
Device feature indicator (hexadecimal). For a list of indicators by feature, see the subsequent table.
3
If DOF, first character of label provided in the FMT statement. If DIF, first character of label provided in the FMT statement converted to lowercase.
4-8
Remaining characters from the label of the FMT statement.
For byte 1 of the DEV specification FMT=, the device type indicators are as listed in the following table.
Table 1. Device type indicators for FMT=
Device Feature Indicator (Hex)
SLU 2, Model 1 display 00
3284-1 or 3286-1 printer 01
3277, or SLU 2, Model 2 display 02
3284-2 or 3286-2 printer 03
3604-1 or 2 (FIDS) 05
3604-3 (FIDS3) 06
3604-4 (FIDS4) 07
3600 (FIN) 08
3610, 3612 journal printer (FIJP) 09
3611, 3612 passbook printer (FIPB) 0A
3618 administrative printer (FIFP) 0B
SCS1: 3770; NTO; and SLU 1 (print data set) 0C
SCS2: 3521 card punch, 3501 card reader, 2502 card reader, and SLU 1 (transmit data set), 0D
3604-7 (FIDS7) 0E
DPM-A1 through DPM-A15, respectively 11 through 1F
DPM-B1 through DPM-B15, respectively 21 through 2F
3270-A1 through 3270-A15, respectively 41 through 4F

Recommendation: You should define device formats for each device type expected to receive a given message. If the MOD or the DOF with the required device type and feature specification cannot be located during online execution, the IMS error default format (containing an error message) is used to display the output message. If the MID or the DIF with the required device type and feature specification cannot be located, input is ignored and an error message is sent to the device that entered it.

However, it is possible to use the same format for a variety of specific devices. Formats defined as TYPE=3270,2 with FEAT=IGNORE specified, can be used as default formats for users of the following devices:

  • 3275
  • 3276, models 2/3/4
  • 3277, model 2
  • 3278, models 2/3/4
  • 3279, models 2/3

To define the terminal to IMS, you must specify TYPE=3270-An with SIZE=(n,80), where n≥24.

Restriction: The IGNORE feature is not supported in MFSTEST mode.

The terminal must be defined to IMS as TYPE=3270,2 or MFS searches for a block with the exact TYPE and FEAT specification, and if one is not found, MFS searches for the default TYPE=3270,2 with FEAT=IGNORE.

Another level of defaulting occurs for ETO terminals prior to the already described defaulting. If an ETO terminal is defined with a screen size of 12x40 or 24x80 in the VTAM® PSERVIC information, and that format block is not found, an additional search is made for a format of the same name using TYPE=3270,1 (12x40) or TYPE=3270,2 (24x80) and using the same features. If that search is unsuccessful, the already described default search is performed. This new default search is also used when in MFSTEST mode, whereas the old default search is not.

Device format selection is based upon the features of the destination terminal as defined at IMS system definition. If feature selection is used, a device format must be created for every combination of features in the system that can receive a message using feature selection. Feature selection is performed based on the specification of the message descriptor (MOD or MID). If the IGNORE option is specified on the MOD, device formats must be created with the IGNORE feature option to ensure proper operation.

Because the screen size for 3270 or SLU 2 devices, other than 3270 model 1 or 2, is specified during IMS system definition, an IMS system definition must be performed before execution of the MFS language utility for user-defined formats.

Use feature selection when devices with different feature combinations are to receive or enter a message and the special features of each device are to be used.

For example, an operator at a device with program function keys can enter a literal in a field using a program function key, and another operator at a device without program function keys can enter the same literal by typing it in a field on the screen. To the application program, these literals are the same. To the application program, the following input devices can enter messages that can look identical regardless of how they were entered:

  • Device Features
  • Print Line 120
  • Print Line 126
  • Print Line 132
  • Data Entry Keyboard
  • Program Function Keys
  • Selector Light Pen Detect
  • Magnetic Card Reading Devices (OICR and MSR)
  • Dual Platen
  • User-defined features for the 3270, SCS1, and SCS2 devices and DPM programs

Use the device feature indicator values listed in the following table for byte 2 of the DEV FEAT= specification:

Table 2. Example of device feature indicator values
Device Feature Indicator (Hex)
P.L. 120 (Print Line 120) 40
P.L. 126 50
P.L. 132 60
DEK (data entry keyboard) C8
PFK (program function keys) C4
SLPD (selector light pen detect) C2
OICR/MSR (magnetic card reading devices) C1
IGNORE 7F
DEK,SLPD 4A
DEK,OICR C9
DEK,SLPD,OICR 4B
PFK,SLPD C6
PFK,OICR C5
PFK,SLPD,OICR C7
SLPD,OICR C3
DUAL (dual platen) C1
P.L. 132,DUAL 61
No features (3270) 40
3270,3270P,3770,SLU 1, SLU 2, SLU P,ISC (User-defined features) Indicators available for definition:
  1. 01
  2. 02
  3. 03
  4. 04
  5. 05
  6. 06
  7. 07
  8. 08
  9. 09
  10. 0A