Template Specification panel

The Template Specification panel is displayed after the Template data set name and member is entered on the Template Entry Panel.

When you specify a non-existent template member or an old version of the template that does not contain the library information, the DBD Library List panel and Copybook Library List panel are displayed prior to the display of the Template Specification panel.
Note: Older templates will be automatically updated to the new format if a cancel is not issued. Existing templates will be updated automatically if the segments defined in the template don't match the segments defined in the DBD.

The Template Specification panel displays a list of the segment types in the DBD and their corresponding copybooks that define the segment layouts.

On this panel, you can:
  • Specify one or more copybooks to describe the layouts for any segment.
  • Specify whether an 01 should be inserted for any given copybook.
  • Update the template.
  • Edit the template for a given segment.

Panel and field definitions

Figure 1. Template Specification panel
 Process   Options   Help
 FM/IMS                      Template Specification


                 Layout        Segment
 Cmd RI Segment  member    Lib description    01 Field name
 *** ****  Top of data  ****
      I SHIRE    SHIRE       1                 N                               
      I SHIRENP  SHIRENP     1                 N                               
      I LINKSUB  LINKSUB     1                 N                               
 *** ****  End of data  ****

 Command ===>                                                       Scroll CSR
  F1=Help      F2=Split     F3=Exit      F4=CRetriev  F6=Describe  F7=Backward
  F8=Forward   F9=Swap     F10=Actions  F12=Cancel

For each segment type, you enter a member name of a copybook and, optionally, a description:

This displays the name of the partitioned data set where the template being created is to be stored.
Prefix command field. Segment header rows are rows that contain a non-blank segment value. These rows cannot be deleted or moved. You cannot insert a row before the first segment header row. Available commands are:
Create (if necessary) the template and edit it.
Identifies the row after which data is to be moved or copied.
Identifies the row before which data is to be moved or copied.
Copy one row.
Copy n rows.
Copy block of rows. Marks the start and end of the block.
Delete one row.
Delete n rows.
Delete block of rows. Marks the start and end of the block.
Edit the segment layout.
Insert one empty row.
Insert n empty rows.
Move one row.
Move n rows.
Move block of rows. Marks the start and end of the block.
Overlay one row.
Overlay n rows.
Overlay block of rows. Marks the start and end of the block.
Repeat row once.
Repeat row n times.
Repeat block of rows. Marks the start and end of the block.
Repeat block of rows n times. Marks the start and end of the block.
Edit the copybook member. (For copybooks managed by other library products, view is substituted). This allows you to specify the criteria that identify the layout occurrences of this segment type or view the layouts of the segment types.

If the segment type to be edited has multiple layouts, FM/IMS displays the Segment Layout Selection panel. If the segment type has only one layout, FM/IMS displays the Segment Layout panel.

Update and edit the segment layout to which this copybook belongs.
View the copybook member.
Displays the Redefines / Range Specifications panel.
This column contains the value R if redefines or range parameters have been specified for the corresponding layout member.
This column contains:
When a new template is being created.
When the template has been created, the I value is only displayed on segment header rows when one of these conditions is true:
  • Only one layout has been specified for the segment.
  • Criteria have been provided for each layout for a given segment.
This is a display field. This is the name of a segment type within the DBD.
Layout member
The member name of the copybook containing the layout (or layouts) for the segment type.

To select a member from a concatenated list of members in the (up to six) partitioned data sets that you specified on the previous panel, either type a pattern in this field or leave it blank.

Tip: If the copybook members and segment types have matching names, then (if you are using a terminal emulator that supports a clipboard) you can select the names in the Segment fields, copy them to the clipboard, then paste them into the Layout member fields.
Segment description
On most panels where FM/IMS displays the name of the segment type, FM/IMS also displays this description. Entering a description is optional.
The sequence number of the library, relative to one, within the library list from which the copybook was selected.
Insert COBOL level-01 indicator. Can be:
Instructs File Manager to insert an 01 for this copybook. For COBOL copybooks the inserted 01 is ignored if the copybook already contains an 01.
Note: This may cause compile errors for PL/I copybooks where an 01 is not required.
Instructs File Manager not to insert an 01 for this copybook. This is the default.
Field name
An optional field containing the name to be included in the generated 01 statement for the copybook. If you do not specify a name, File Manager generates one in the format FMNnnnn, where FMN is a constant and nnnn is a number starting at 1.

Parent panels

Child panels