NAME macro

The LTERM can be specified as the IMS master terminal if the associated physical terminal is a 3270 display terminal, SLU 1, or SLU 2. The terminal must be nonswitched. If the terminal is a SLU 1, both the input (ICOMPT) and the output (COMPT) component designations must refer to the first physical component. The first physical component of a SLU 1 terminal must be a console if it is to be defined as the IMS master terminal.

For SLU 1 terminals, the NAME macro statement also defines the data set at the terminal to receive output for corresponding components defined in the TERMINAL macro statement as USERDS1.

For LU 6.1 nodes, the position of the NAME macro within the system definition macro set determines whether LTERM allocation is fixed or dynamic.

If the allocation of LU 6.1 logical terminals is to be predefined (fixed), the NAME macro statement must follow the TYPE and TERMINAL macro statements, and the SESSION parameter must be equal to 1 (by specification or default).

If the allocation of LU 6.1 logical terminals is to be dynamic, the NAME macro statement must follow the SUBPOOL macro statement, and the SESSION parameter must specify a valid value in the range 1 through 255. The default is 1.

Dynamic definition

You can define remote LTERMs dynamically by using the CREATE LTERM command, instead of defining them statically with the system definition NAME macro.

Supported environments

The NAME macro can be used in the DB/DC and DCCTL environments.

Syntax

Master terminal

Figure 0.

3601 workstation

Figure 0.

3275 terminal

Figure 0.

SLUTYPE1, SLUTYPEP, LUTYPE6 terminals

Figure 0.

Positional parameters

lterm

Specifies one or more 1- to 8-character names for logical terminals associated with previously defined physical terminals. The name can contain only alphanumeric characters, that is, the letters A through Z, digits 0 through 9, and national characters #, $, and @. WTOR and DFSMTCNT are invalid lterm names. The entered name cannot begin with the character sequence INQU. Logical terminal names, transaction codes, and MSNAME link names, collectively, cannot contain duplicates. This operand is required. For further restrictions, refer to Resource naming rules.

If you enter the operand as a sublist with the keyword MASTER as a second parameter, the entered name is the identifier of the IMS master terminal.

If you enter the operand as a sublist with the keyword SECONDARY as the second parameter, the entered name is the identifier of the IMS secondary master terminal.

The IMSID is a reserved keyword and cannot be used as a master or secondary master LTERM name.

One logical terminal in the system must be specified as the master terminal. The logical terminal chosen as the master terminal cannot be on a switched LINEGRP. It must be one of the following types:

• 3270 display terminal
• Terminal defined as either SLUTYPE1 or SLUTYPE2

It must also be the console component if the terminal is defined as SLUTYPE1.

One logical terminal can be specified as the secondary master terminal. This logical terminal cannot be on a switched line group. It must be one of the following types:

• A 328x physical terminal
• A terminal defined as SLUTYPE1
• A terminal in a line group defined as a SPOOL

You can specify multiple LTERMs per TERMINAL macro. For example:

NAME  LTERMA,LTERMZ
NAME  LTERMA,LTERMX,LTERMZ

For IMS to designate data and commands as having originated at a master terminal, you must specify the first LTERM as MASTER. For example, for IMS to use master terminal default command security for commands entered from the master terminal, specify the first LTERM as MASTER:

NAME  (LTERMA,MASTER),LTERMX,LTERMZ

However, to specify a master terminal and to prevent IMS from designating data and commands as having originated at a master terminal, such as to bypass default command security and use some other form of security such as RACF command security, specify an LTERM other than the first LTERM for the terminal as MASTER:

NAME  LTERMA,(LTERMX,MASTER),LTERMZ

For terminals with multiple NAME LTERMs defined, system error message responses are sent to the logical terminal name that is lowest in the collating sequence, unless the terminal is an input-only terminal. For input-only terminals, the system responses go to the first assigned logical terminal OUTPUT= terminal.

remote lterm name

Specifies a one- to eight-character name for a logical terminal associated with a physical terminal defined in a remote IMS system. The name can contain only alphanumeric characters. WTOR and DFSMTCNT are invalid logical terminal names. The name cannot begin with the character sequence INQU. For further restrictions, refer to Resource naming rules. No other operands are meaningful for a remote logical terminal; if provided, they are interpreted as comments only.

Usage information

If the IMS master terminal is specified as a SLU 1, the designation of a secondary master terminal is optional. The master secondary terminal can be specified if the logical terminal's associated physical terminal is SLU 1. The terminal must be nonswitched. If the terminal is a SLU 1, both the input (ICOMPT) and the output (COMPT) component designations must refer to the first physical component. The first physical component of a SLU 1 can be either a console or a printer if it is to be defined as the IMS secondary master terminal.

If the IMS master terminal is specified as a 3270 display terminal, a secondary master terminal is required, and must be specified for a 328x, associated physical terminal.

If the IMS master terminal is specified as SLU 2, you must specify a secondary master terminal in a preceding NAME macro for a 328x, SLUTYPE1, or SPOOL associated physical terminal.

If other physical terminals are defined on the same communication line as the primary or secondary master terminal, then special restrictions apply to the use of the /CHECKPOINT and /IDLE commands in the IMS system.

The Message Format Service (MFS) special master terminal formatting is only available for 3270 display terminals specified with a screen size of 24 x 80.

For output purposes, the COMPT operand associates the specified logical terminal with a specific component in a 3601, SLU 1, or SLU P terminals, or LU 6.1 nodes. The COMPT operand is valid only for these terminal types.

If two or more sessions are defined on the SESSION parameter, dynamic allocation must be used.

Consider using dynamic rather than fixed allocation for one parallel session (SESSION=1). This permits all subpools to be available for dynamic allocation to that session.

Keyword Parameters

To find which parameters apply to your IMS configuration, refer to Selecting the appropriate macros to define your system.

COMPT=

Specifies the output component associated with this logical terminal. If this is the master terminal, the COMPT= operand value must be either not specified or 1.

For 3601 work stations, you can specify 1, 2, 3, or 4.

COMPT= cannot be specified for NTO devices.

EDIT=

Specifies whether the logical terminal user-supplied edit routine DFSCNTE0 is to be used when routing a message to this logical terminal. The logical terminal edit routine is loaded as a stand-alone module during IMS initialization only if at least one NAME statements specifies EDIT=YES during system definition. If IMS initialization does not detect any static LTERMS defined with EDIT=YES, then DFSCNTE0 is not loaded. If ULC is specified, output is transmitted as received. If UC is specified, output is translated to uppercase before transmission.

The logical terminal edit routine DFSCNTE0 is not supported for ETO logical terminals.

ICOMPT=

Specifies the input component associated with the terminal defined in the previous TERMINAL macro. If this is the master terminal, the ICOMPT= operand value must be either not specified or 1.

For SLU 1, SLU P, or LU 6.1 terminal systems, you can specify 1, 2, 3, or 4. These values relate to the components specified in the preceding TERMINAL macro statement.

For secondary logical units defined as SLUTYPE1, if the first component is a console, the default is 1; if the first component is a printer, no default exists. For terminals defined as SLUTYPEP or LUTYPE6, the default is 1.

ICOMPT= cannot be specified for NTO devices.

OUTPUT=

Specifies a terminal that is to be used as the output terminal for this logical terminal name. This is specified by entering the label of the TERMINAL macro defining the desired terminal. The referenced TERMINAL statement must occur before this NAME statement. OUTPUT= cannot be specified for VTAM® terminals. OUTPUT= cannot be used with response mode, Fast Path, or conversational transactions.

A split input/output LTERM is not applicable to ACF/VTAM terminals.