LINEGRP macro

The LINEGRP macro defines the beginning of a set of macro instructions that describe your telecommunications system.

The LINEGRP macro statement is the first in a series of macros. The IMS macros that can be part of a LINEGRP macro set are LINE, TERMINAL, and NAME.

Dynamic definition

Your telecommunications system cannot be defined dynamically.

Supported environments

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

Syntax

All line groups

Read syntax diagramSkip visual syntax diagramLINEGRPBACKUP=4XNO,DDNAME=,name,EDIT=( outmodule name, inmodule name),FEAT=(NONSWITCHED,POLL,AUTOPOLL),UNITYPE=DISKPUNCHPRINTERREADERTAPESPOOL

Positional parameters

The LINEGRP macro does not include positional parameters.

Keyword parameters

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

BACKUP=
Specifies (for XRF only) the control of automatic restart after takeover. Use only when HSB=YES is specified on the IMSCTRL macro.

X is a numeric integer from 1 to 7, inclusive, which specifies the priority assigned to reestablishing the session. When either the keyword or the operand is omitted, the default is 4. Specifying BACKUP=NO suppresses the automatic restart of the devices after a takeover.

DDNAME=

Specifies a one- to eight-character name that associates the generated DCB for this line group, within the IMS nucleus control block, with the generated JCL DD statements identifying the lines within the line group. If the line group being defined is a SPOOL line group, a list of up to 20 names can be specified: 255 SPOOL data sets, but no more than 20 names per line group can be specified. Each SPOOL name specification is associated, in the order in which it was specified, with the SPOOL data set names that you specify for the SPOOL print procedures, including DFSWTxxx, IMS, and DCC procedures. These procedures are provided as samples in SDFSPROC and can be modified to include actual specifications.

The names must begin with an alphabetic character, and the operand is required. The following names cannot be used as LINEGRP ddnames:
  • DFSRESLB
  • DUMP
  • IEFRDER
  • IEFRDER2
  • IMSACB
  • IMSDBL
  • IMSDILIB
  • IMSLOG
  • IMSLOGR
  • IMSLOGR2
  • IMSLOG2
  • IMSMON
  • IMSRDS
  • IMSSPA
  • IMSTFMT
  • IMSUDUMP
  • LGMSG
  • MSDBCP1
  • MSDBCP2
  • MSDBDUMP
  • MSDBINIT
  • PRINTDD
  • PROCLIB
  • QBLKS
  • SHMSG
Recommendation: Allocate at least two data sets.
EDIT=
Specifies a one- to eight-character, user-supplied physical terminal output edit routine and a one- to eight-character, user-supplied physical terminal input edit routine for the terminal type in this line group.

This routine cannot be the same as the one that is used on a TRANSACT EDIT= parameter.

FEAT=
Specifies that this group of telecommunication lines is leased (NONSWITCHED). This is the default.

Polling features are ignored, and no polling list is generated if any of the following values are specified for UNITYPE= keyword: READER, PRINTER, PUNCH, TAPE, DISK, and SPOOL.

Direct SYSOUT specifications (PRINTER, PUNCH, TAPE, or DISK) do not require that a specific device type is assigned at IMS execution time. All specifications except PRINTER affect only default BUFSIZE or generated JCL. Specifying PRINTER results in execution time being translated to the 48-character set, lowercase is translated to uppercase, and all other codes translated to periods(.). If a specification other than PRINTER is used, no translation occurs. If a line not generated as a PRINTER is allocated to a printer having the universal character set feature (UCS), and fold mode operation is used, unprintable characters print as extraneous alphanumerics.

UNITYPE=
Specifies the terminal device type contained in this line group.

Valid UNITYPE parameters are DISK, PUNCH, PRINTER, READER, TAPE, and SPOOL.

When a JES SPOOL DATASET (SYSOUT) is used, UNITYPE = PRINTER must be specified.

Sample LINEGRP macro JCL

The JCL example below shows the LINEGRP macro and the resulting DDNAME/DSNAME and print procedure associations for a SPOOL line group.
LINEGRP DDNAME=(NAME1,NAME2),UNITYPE=SPOOL
 
LINEGRP DDNAME=(NAMEA,NAMEB),UNITYPE=SPOOL

You must define the SPOOL print procedures for each line group. Use the sample SPOOL print procedure, IMSWT000, which is provided in SDFSPROC to define your own IMSWTxxx procedures.

The SPOOL print procedure for line group 1 is named IMSWT000. The data set names produced for this print procedure are IMS.SYSO1 and IMS.SYSO2.

The SPOOL print procedure for line group 2 is named IMSWT001. The data set names produced for this print procedure are IMS.SYSO3 and IMS.SYSO4.

The corresponding JCL statements that you define for the IMS online execution procedure are as follows:
 //NAME1  DD  DISP=SHR,DSNAME=IMS.SYSO1
 //NAME2  DD  DISP=SHR,DSNAME=IMS.SYSO2
 //NAMEA  DD  DISP=SHR,DSNAME=IMS.SYSO3
 //NAMEB  DD  DISP=SHR,DSNAME=IMS.SYSO4

If UNITYPE=SPOOL on the LINEGRP macro statement, DD names used in the preceding JCL must agree with the actual DD names specified on this statement.