File Manager for IMS

8/6/2019 File Manager for IMS

1/41

COMPUTER SCIENCES CORPORATION

Global Transformation Solutions

Owned by:

GTSVersion: 1.0

GROUPLIFEANDPENSION CSCINDIA

FILE MANAGERFORIMS

Approved by: Page: Page 1 of 41 Date: 7/17/2011

TABLE OF CONTENTS

INTRODUCTION ............................................................................................................................... 2

FILE MANAGER - START ................................................................................................................ 3

TEMPLATES ..................................................................................................................................... 4

Creating a Template ................................................................................................................. 4

Editing a template .................................................................................................................. 13

VIEWS ............................................................................................................................................. 16

Creating a View ...................................................................................................................... 16

BROWSING THE DATABASE ....................................................................................................... 25

SETTING UP FILE MANAGER OPTIONS ..................................................................................... 39

HOW TO USE HELP AND GET MORE INFORMATION .............................................................. 41

General................................................................................................................................... 41

Browsing HELP ...................................................................................................................... 41


2/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


Introduction

This document is intended to provide information on how to perform commonly used functions of

the IMS File Manager. The detail level of the information provided is enough to perform these

tasks without the need of further reference.

However, for more detailed information, please refer the File Manager manual, a link to which is

provided in the Appendix. Also, please refer How to use HELP and get more information.

Note: The examples cited in this document are from the authors project, but are general enough

to support the explanation.


3/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


File Manager - Start

You are at the Primary Option Menu of the File Manager for IMS.


4/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


Templates

Creating a Template

A Template allows one to associate a COBOL segment layout with each segment type in

a DBD. These are used in the Browse, Edit, Extract, View and Criteria functions.

Select Option 5 from the Primary Options menu.


5/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


The Template Entry Panel is displayed.

Next to the Data set name 1 field under DBD, one has to enter the dataset which contains the

DBD of the database one wants to process. The Member field would contain the DBD member

name in the dataset. It is also possible to list an additional dataset next to Data set name 2.

Under Template, the Data set name field lists the PDS which contains the template (if it alreadyexists) or which will hold the newly created template.

This PDS should already exist and should be created with a Record format of FB and a Record

length of 80.

When creating a new Template, ensure that the layout copybooks members for each segment

are present in the Template data set listed above.

A layout is a description of the database segment provided by the user to File Manager. The

usual practice is to use the segment copybook from Endevor.

Once a template is created, a new copybook load member of the same name as the DBD isplaced in the Template dataset.


6/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


A. If a template already exists in the listed PDS, the next screen Template Specification, shown

below, says that the existing template has been loaded.

B. For a new template, the source datasets entered in the previous screen are confirmed on the

Library List screen. Also, one can enter additional dataset names for use in the following

screens, if needed. Note that another dataset CHV0257.PRIVATE.JCL has been entered in the

screen shown below.


7/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS



8/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


The next screen is the Template Specification screen. Press Enter without entering any values.

Template dataset Segment name from the DBD Segment layout member name


9/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


The next screen displays all the members from all the datasets listed earlier in the Library List

screen shown earlier. The top line keeps changing as the layout corresponding to the member

listed in the top line is selected. Select layouts for all segments and press Enter after eachselection. All layout copybook members have to be in COBOL only.

Here, selecting the VFART member is shown. This member is from the second dataset listed in

the LibraryList screen, and lists as 2 under the Lib field.

After all the layouts are selected, the Template Specification screen is displayed again with the

selected choices.


10/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS



11/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


Note that the Layout Member column has an entry for each segment under the ID Segment

column. The Lib column states the position of the source dataset in the list specified on the

LibraryList screen.

It is possible to mention more than one layout for a particular segment. This is done by inserting

another row for any particular segment with I in the Cmd column. Type in the new layout name

and press Enter. The display for another layout for VFA11 is shown below. The new layout is

VFA12.

The added layout can be deleted by typing D against it under the Cmd column.

A text description can be entered for a segment under the Segment Description column. A 01

level can be inserted into the layout by specifying Y under the 01 column. If a 01 level already

exists, the Y is ignored. If the 01 is selected, an optional field name in the generated copybooks

can be specified under the Field Name column.

After the template has been designed to ones satisfaction, press F3.


12/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


A template with the same name as of the DBD is now created and saved in the Template PDS

listed as shown below.

(If there are problems during the compilation of the layout copybook members, another screen

with the return code/error message pops up. Select the option which displays the compilation

errors. These are listed like in a normal COBOL compilation listing. After making the required

corrections, the template can be compiled again by pressing F3 on the Template Specification

screen.)


13/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


Editing a template

The editing of an existing template begins at the Template Specification screen after the

template is loaded.


14/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


On the above screen, rows can be inserted with Iunder the Cmd column. They can be deleted

with D. After a template is modified, it can be updated with a U. The copybook member can be

viewed with V and modified with S.

The segment layout can be modified with E against a segment name. Press Enter to go to the

Segment Layout screen shown below.

At the Segment Layout screen, it is possible to edit individual fields. Type E against a field under

the prefix Cmd column and hit Enter.


15/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


In the field Field Attributes screen, it is possible to specify alternate headings for the field name

next to Heading under Use Attributes which will be displayed when the database is browsed inTABL mode. Save your template changes with an F3 from the Template Specification screen.


16/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


Views

Creating a View

File Manager uses a View to select the data required from an IMS database for use in an edit or

browse session. A view is also used to describe which fields of the selected segment occurrences

are to be displayed. In the View function, you can create or edit a view based on a template or

another view. Views are used by the Browse and Edit functions.

Select 6 from the Primary Option Menu.


17/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


The View Entry Panel is presented.

To create a new view, type CT on the primary command line.

To edit an existing view, type E.

The template dataset/member and the View dataset/member have to be mentioned under

Template and View respectively. The View dataset has to be created prior to the creation of the

View and should have a Record format FB and a Record length of 80.

Select CT and press Enter to create the view from the existing Template.


18/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS



19/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


Editing a View

Select E on the View Entry Panel, and press Enter. The Segment Selection screen isdisplayed. All the segments in the DBD are displayed. A * next to the segment name under the

Sel column indicates that the segment is selected for display during a Browse. The Level

indicates the segment level in the database structure. Segments that have a * against them are

highlighted.

Sel Segment Name


20/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


Segments can be hidden in a Browse session by typing S against a segment name and pressing

Enter. All hidden segments will not have a * against them and are not highlighted. In the screen

shown below VFART and VFA11 are hidden. After a view is changed a C appears here.Segments can be edited by typing E in the prefix Cmd column against the Segment name and

pressing Enter.

The Segment Layout panel is displayed. Here, fields can be selectively chosen for display in a

browse session by typing the selection criteria against the Sel field. View HELP for detailed

information on selection criteria.


21/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


By typing E in the prefix Cmd column against a field name, one can edit the Field attributes. The

Field Attributes panel is displayed next.

A heading can be provided for the field by typing it against Heading under Use Attributes. Also,

the suppression of the leading zeroes of a numeric type variable can be toggled with YES or NO

in the Leading Zeros field. The Fixed Attributes section shows the invariable attributes of the

field.

The heading for the field, if entered, will be displayed when the segment is browsed in the TABL

format.


22/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


F3 will take you back to the Segment Layout screen. Notice that a C is placed against the field

display which has just been changed.


23/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


An S in the prefix Cmd column against a field will select it for display in the TABL format. Only

those fields with an S are displayed. If no S is present all fields are displayed.

The Type column lists the data type of the field. View HELP for a complete list.

The Start column lists the relative starting position of the field within the segment.

The Length displays the field length.

The Ref indicates the File Manager reference number of the field. This number is used when

formulating criteria for field selection which can be entered against the Sel field. A K

indicates that the field is part of the key. An S indicates that it is a secondary index search field.

An s indicates that it is a secondary index subsequence field.

F3 back to the Segment Selection screen and to the View Entry Panel that states that the View

is now saved.


24/41


25/41


26/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


The Browse Entry Panel is displayed.

Under PSB mention the PSB library against Data set name and the corresponding PSB namewith which you want to browse the database against Member. The PSB you mention should have

read rights for all the segments you wish to browse. Please check the PSB to make sure of this.

(Correspondingly, in an Edit session, you have to check the PSB for edit rights).

Mention the DBD details under DBD. The IMS details are the default ones.


27/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


The Database Data Set Specification screen is displayed next. Here, we have to mention the

VSAM datasets to use against each DBD name supplied on the screen.

DBD name ddname User supplied VSAM dataset name

If the Save dsnames in profile option is selected, the same VSAM dataset names will be

displayed the next time you arrive at this screen.

The VSAM dataset names can be your own copies of the region specific IMS VSAM datasets

also, as shown above. (Scan your test JCL for the VSAM datasets being used). Please refer to

the DB Backup document for information on how to create your own copies. A link to this is

available in the Appendix.


28/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


Press Enter to go to the View Specification screen. You can confirm your entries here.


29/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


Press Enter to go to the Database Positioning screen.

This screen displays the Segment level in Level, the key length of the segment in Key len and afield for user entry in Key value.

An S under Cmd against a segment name positions the database pointer to that segment. This

can be used with an optional key value. Else, it positions the pointer to the first occurrence of that

segment (Only available with a View).

K can be entered under Cmd to go to the Key Specification screen (described next).

E under Cmd takes you to the Segment Layout screen where the attributes of the segment View

can be modified (discussed earlier).

Consider the SXE column. An S is present against a segment name if while browsing it happened

to occur in the hierarchical order of the database. (You can see this after we return to this screen

from a Browse session.)An E is present if the segment view contains any selection criteria.

All segments which will be displayed will be marked with an X against them. Unselected

segments can be selected again by typing X against them under the prefix Cmd column. While

editing the View, in the Segment Selection screen, we had unselected the segments VFART

and VFA11 from display. Hence in the screen shown below they are not highlighted and wont be

displayed in the Browse session.


30/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


Press K against any segment (even an unselected segment such as VFA11 from the above

screen) to go to the Key Specification screen. Here all the key fields of the VFART and VFA11

segments are displayed (VFART is the parent of VFA11).

The key can be specified with any one of the relational operators =, , >=,


31/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS



32/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


Notice that in the screen shown above, there is now an S in the SXE column against VFART and

VFA11, since they both were in the hierarchical sequence of browsing for the key entry. Enter S

against any segment (VFA12) under Cmd and press Enter to go to the IMS Database ########screen. Now we are looking at the contents of the database for the segment VFA12 in SNGL

format.

Segment Concatenated Displayed field name Data value Browse format

Name key

In the SNGL format shown above, only one segment at a time is displayed. To go to the next

selected (displayed) segment in hierarchical order, press F11. F10 to go back up by one. F8 to

the next data screen of the same segment. F7 for up.

The Browse format can be changed as follows:

SNGL - Single segment format

TABL - All segments in table format, each segment split into fields across the panel

CHAR - Character format

HEX - Hexadecimal format in three lines

LHEX - Displays each byte as two hexadecimal digits on the same line


33/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


The SNGL format is shown above. Change it to TABL and press Enter. All the segments in the

database are listed. F8 to scroll down, and F7 for up. Notice that in the screen shown below, the

first segment listed is VFA12. Only three fields are displayed since only three were selected fordisplay in the Segment Layout screen shown earlier. Also, the alternate heading for the first

segment SegmentLayout is shown.

Data type Data value

Cmd is active at VFA12 and the fields attributes are those of the VFA12 segment. For all other

segment types, the data is hidden and only a key is displayed. To view the data and field

attributes for the other segment types, enter V against the segment name (VFA13) in the Cmd

column (Over the L in =LG) and press Enter.


34/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


Now, data of all the VFA13 segments is displayed and all other segment types have the key

displayed. In this way, one can toggle the data of the different segment types.

K can be entered against any segment under the Cmd column to go to the Key Specification

screen described earlier. Here, a specific key value can be entered for the segment type

selected.

Change to CHAR and press Enter. All segment data is displayed in character format.


35/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


Change to HEX and press Enter. The data is displayed on three lines The first has the

character data, the second and third have the equivalent hexadecimal values read top to

bottom.

Change to LHEX and press Enter. Each data byte is displayed as two hexadecimal digits read

left to right.


36/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


Enter F3 to come back to the Database Positioning screen. Notice that there is an S against

each segment which was accessed in the hierarchical path of the last database Browse.

It is possible to browse the database without a View. But this shall restrict viewing to the CHAR,

HEX and LHEX formats only. Field names are not displayed. At the View Specification screen,

select 3.None under Processing Options


37/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS



38/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


Browsing in the CHAR format is shown below.


39/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


Setting up File Manager Options

Select 0 on the Primary Option Menu screen.

Select 7 on the Set Processing Options screen for setting Edit and Browse options.


40/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


Set options here.


41/41



Owned by:

GTSVersion: 1.0


FILE MANAGERFORIMS


How to use Help and get more information

General

File Manager has a very detailed and highly informative HELP facility. At any screen, this feature

can be activated by pressing the F1 key.

A menu driven HELP section on that particular screen is presented. On many File Manager

screens, the HELP would generally include:

1. General information

2. Primary commands

3. Prefix commands

4. Screen fields and their description

5. Other information

In addition, positioning the cursor on some fields on some screens and pressing F1 will display

additional information on that particular field.

Browsing HELP

Within a HELP screen, UP and DOWN are mapped to F10 and F11. B takes you one HELP

screen back, and N one HELP screen forward. From any HELP screen, it is possible to go

through all subsequent screens in the order of presentation by simply hitting ENTER.

F3 exits HELP and back to the File Manager screen from where HELP was invoked.

Documents

File Manager for IMS