----------------------------------------------

| INSYNC - GENERAL INFORMATION |

----------------------------------------------

INSYNC is a utility designed to aid programmers and systems analysts

in the manipulation of datasets. It is a menu-driven interactive
system and is designed to run under ISPF/PDF using function keys
similar to those used in ISPF.

INSYNC provides the ability to create, display, edit, extract, reformat,

and print data records in a formatted manner, based on a COBOL or PL/1 record
description, or in an unformatted manner. It enables the user to create
datasets in a new format using a new COBOL or PL/1 record description and t o
move data from an existing dataset to the new output dataset.

INSYNC supports any record layout, including those with multiple record
types, and any record size within a QSAM, BDAM or VSAM KSDS, ESDS or RRDS
dataset.

----------------------------------
| PARMS - PRIMARY OPTION |
----------------------------------

Option 0 is the PARMS Primary Option. Parameters may be specified here

for use throughout INSYNC and will be retained between sessions. You
may change these options at any time. Below is a brief description of
the parameters:

1 PROFILE - Set indentation, caps on/off, prefix on/off, and EDIT

logging.

2 PRINT - PRINT dataset allocation and JOBCARD information.

3 AUDIT - AUDIT dataset allocation and JOBCARD information.

4 PF KEYS - Set the PF Key assignments.

You may select any of the above topics by entering a one-character

selection code in the option field.

---------------------------
| BROWSE PRIMARY OPTION |
---------------------------

INSYNC BROWSE displays the records in a dataset in formatted, unformatted,

full screen, or table format (TFORMAT) modes.

One record at a time is displayed in formatted or unformatted mode,

one record per line is displayed for full screen or TFORMAT mode.
Formatted mode is selected by supplying the name of a dataset containing
a COBOL or PL/1 record description of the records to be browsed. If the
COBOL or PL/1 record description length does not match the record length
of the records being browsed a warning message will be issued. Once in
formatted mode, the TFORMAT command switches to TFORMAT mode where the
fields are headed by layout information.

The following topics are presented in sequence, or may be selected by

entering a one-character selection code in the option field:

1 - BROWSE formatted mode 3 - BROWSE full screen

mode
2 - BROWSE unformatted mode 4 - BROWSE TFORMAT
(TFMT) mode

INSYNC EDIT displays the records in a dataset in formatted, unformatted,

full screen, or table format (TFORMAT) modes.

One record at a time is displayed in formatted or unformatted mode,

one record per line is displayed for full screen or TFORMAT mode.
Formatted mode is selected by supplying the name of a dataset containing
a COBOL or PL/1 record description of the records to be edited. If the
COBOL or PL/1 record description length does not match the record length
of the records being edited a warning message will be issued. Once in
formatted mode, the TFORMAT command switches to TFORMAT mode where the
fields are headed by layout information.

The following topics are presented in sequence, or may be selected by

entering a one-character selection code in the option field:

1 - EDIT formatted mode 3 - EDIT full screen mode

2 - EDIT unformatted mode 4 - EDIT TFORMAT (TFMT)
mode

------------------------------
| PRINT PRIMARY OPTION |
------------------------------

The PRINT option allows you to print selected records from a dataset
in a formatted mode based on a supplied COBOL or PL/1 record description or
in unformatted mode. When all information has been entered, a batch job
is submitted to print the selected records.

For a formatted PRINT, enter YES in the "Use COBOL or PL/1 To Format Print"
option. You must specify an ISPF Copy Library and member.
Otherwise, enter NO and the records will be printed in an unformatted mode.
Specify whether or not lower case characters are to be printed and, also,
the Start record number and Maximum number of records as required.

The following topics are presented in sequence, or may be selected by

entering a one character selection code in the option field:

1 FORMATTED PRINT
2 UNFORMATTED PRINT

-------------------------------
| LAYOUT PRIMARY OPTION |
-------------------------------

The LAYOUT primary option is used to display or print a COBOL or PL/1 record
description as it is interpreted by INSYNC or to convert a COBOL or PL/1
record description to an EASYTRIEVE PLUS macro format.

The following topics are presented in order, or may be selected by

entering a one-character selection code in the option field.

1 - Print COBOL or PL/1 layout

2 - Create EASYTRIEVE PLUS macro
3 - Create DYL280 macro
4 - Display file layout

----------------------------
| CREATE ENTRY PANEL |
----------------------------

The CREATE option allows you to create blocks of records to add to an

existing dataset or create a new output dataset.

Specify on the CREATE entry panel your output dataset, whether or not to add
the record(s) to an existing dataset and the number of records you wish to
CREATE. Note that CREATE can be used to create a new member of an existing
PDS, but not to add records to an existing PDS member.

This screen also allows you to specify whether or not to use a COBOL or PL/1
layout and, if YES, the copy library or dataset containing the layout.
After pressing enter, a formatted or an unformatted record display will
appear (depending on whether 'Use COBOL or PL/1 layout is YES or NO), with
the name of your specified output dataset at the top. Key in your data and
then press enter. This will save your newly created records. You will then
be prompted as to whether or not you wish to CREATE more records.

--------------------------------
| EXTRACT PRIMARY OPTION |
--------------------------------

The EXTRACT option of INSYNC allows you to selectively extract records

from a dataset and incorporate them into another dataset.

Specify on the EXTRACT entry panel your input and output datasets and
the COBOL copy or PL/1 include library or dataset.

This screen also allows you to decide whether or not to add to the
existing records in the dataset (YES/NO). If NO is specified, the data
set will be overwritten. You may also specify the number of records
you wish to EXTRACT.

After pressing enter, a FIND panel will be displayed to specify any

selection criteria to be used for the EXTRACT option.

-----------------------------
| TABLES PRIMARY OPTION |
-----------------------------

The TABLES primary option is used to create and maintain tables to be

used by INSYNC in place of COBOL or PL/1 record descriptions to process files
containing multiple record layouts or records which are defined by
concatenating multiple COBOL or PL/1 record descriptions.

The following topics are presented in order, or may be selected by

entering a one-character selection code in the option field.

1 SELECT - Specify multiple format selection criteria

2 COMPOUND - Define compound record layout structure

The FIELDMAP option of INSYNC allows you to create an output file

using a new COBOL or PL/1 record layout. Specified fields from the input
record layout are mapped to specified fields in the output record
layout and a new dataset is created.

You may specify whether or not all records are to be copied to the new
output dataset. If 'YES' is specified, those records not selected for
copying (using search criteria) will be copied to the output dataset
as they appear in the input dataset. No changes will be applied to
those records. If 'NO' is specified, only those records selected via
the search criteria panel will be copied to the output dataset.

The Field Mapping Specification Panel displays the input and the output
format. The input record layout is always the left side of the screen,

(Continued on next page)

This allows you to produce a report of differences between two datasets.

The records which differ will be shown by default in 'vertical format',
if you enter 'Use COBOL or PL/1 layout to format display = NO' then you
can enter YES for 'Horizontal display'.

Specify the input datasets and the COBOL or PL/1 copybooks, and the max
number of differences to be displayed, if required.

After pressing enter panels will be displayed to specify fields to be

excluded from the compare and in the formatted option fields to be
displayed in addition to differing fields for unequal records.

If neither of the input files is keyed, a panel will be displayed

to optionally specify a 'key' field for record matching.

---------------------------------
| DATEAGE PRIMARY OPTION |
---------------------------------

The DATEAGE option of INSYNC allows you to adjust date values by

a specified number of days.

Records to be aged are selected via search criteria, then the format
of the individual date fields is entered together with the number of
days by which to adjust the date value.

If a data error is detected within one of the selected date fields

the record will be displayed in edit mode so that the data may be
corrected. To bypass a record containing an invalid date field, use
the DELETE primary command. This will not cause the record to be
physically deleted, but will bypass dateage processing for it.
If no output dataset is specified the input dataset will be updated in
place.

INSYNC - Version 3.1

The following topics are presented in sequence, or may be selected by

entering a one-character selection code in the option field:

1 LIBRARY - PDS directory and CSECT information

2 SCAN - PDS scan utility
3 VSAM - VSAM utility
4 VTOC - VTOC utility

----------------------------
| BATCH PRIMARY OPTION |
----------------------------

The BATCH option allows you to create and keep members which specify
INSYNC functions for use in batch mode.

The following topics are presented in sequence, or may be selected by

entering a one-character selection code in the option field:
1 - BATCH CHANGE
2 - BATCH DELETE
3 - BATCH PRINT
4 - BATCH EXTRACT
5 - BATCH FIELDMAP
6 - BATCH COMPARE
7 - BATCH DATEAGE
8 - BATCH SCAN
9 - BATCH VTOC
R - BATCH REVIEW
S - BATCH SUBMIT

INSYNC DB2

The following topics are presented in sequence, or may be selected by

entering a one-character selection code in the option field:

G GENERAL - General information about INSYNC DB2

0 PARMS - Specify INSYNC DB2 parameters
1 BROWSE - Table browse
2 EDIT - Table edit
3 PRINT - Table print
5 EXTRACT - Create table extract dataset
6 LOAD - Load extracted table records
 7 RELATE - Relationship Management
B BATCH - INSYNC DB2 batch functions

The following topics will be presented only if explicitly selected:

I INDEX - Alphabetical index of tutorial topics

INSYNC IMS

The following topics are presented in sequence, or may be selected by

entering a one-character selection code in the option field:

G GENERAL - General information about INSYNC IMS

0 PARMS - Specify INSYNC IMS parameters
1 BROWSE - Database browse
2 EDIT - Database edit
3 PRINT - Database print
4 FORMAT - Segment format tables
5 EXTRACT - Create segment extract dataset
6 LOAD - Load extracted segment records
7 RELATE - Extract Relationships
B BATCH - INSYNC IMS batch functions

The following topics will be presented only if explicitly selected:

I INDEX - Alphabetical index of tutorial topics
. . . . . . . . . . . . . . . . . . . . . . . . .
option.
1.

DATA FILE:
DATASET NAME ===> 1NDVT.DBA.COD.DD1D101I'
VOLUME SERIAL ===> (If not cataloged)

Use subset selection criteria ===> NO (YES, NO)

Use existing subset selection criteria ===> NO (YES, NO)
Use COBOL or PL/1 layout to format display ===> NO (YES, NO)

COPY LIBRARY OR STORED SUBSET SELECTION CRITERIA LIBRARY

ISPF: PROJECT ===>
GROUP ===>
TYPE ===>
MEMBER ===> (Blank or pattern for member selection list)
 CONCATENATED LIBRARY LIST: MEMBER ===>

OTHER DATASET ===>

2.edit…

DATA FILE:
DATASET NAME ===> NDVT.DBA.COD.DD1D101I'
VOLUME SERIAL ===> (If not cataloged)

Use subset selection criteria ===> NO (YES, NO)

Use existing subset selection criteria ===> NO (YES, NO)
Use COBOL or PL/1 layout to format display ===> NO (YES, NO)
Log dataset changes ===> NO (YES, NO)
Print audit report ===> NO (YES, NO)

COPY LIBRARY OR STORED SUBSET SELECTION CRITERIA LIBRARY

ISPF: PROJECT ===>
GROUP ===>
TYPE ===>
MEMBER ===> (Blank or pattern for member selection list)

CONCATENATED LIBRARY LIST: MEMBER ===>

OTHER DATASET ===>

3.create

OUTPUT DATA FILE: ===> 1NDVT.DBA.COD.DD1D101I'

Add to existing records in dataset ===> NO (YES, NO)

(not for existing PDS members)
Number of records to be created ===> 1
Use COBOL or PL/1 layout ===> NO (YES, NO)

COPY LIBRARY:
ISPF: PROJECT ===>
GROUP ===>
TYPE ===>
MEMBER ===> (Blank or pattern for member selection list)

CONCATENATED LIBRARY LIST: MEMBER ===>

OTHER DATASET ===>

4.extract.

INPUT DATA FILE ===> 1NDVT.DBA.COD.DD1D101I'

OUTPUT DATA FILE ===> 'NDVT.DBA.TRIAL'

Use COBOL or PL/1 layout to format display ===> NO (YES, NO)

Add to existing records in output dataset ===> NO (YES, NO)
If keyed, replace equal keyed records ===> YES (YES, NO)
Number of records to skip before sample ===> (Default = 0)
Number of records per sample ===> (Default = 1)
Maximum number of records to be extracted ===> (Blank = ALL)

COPY LIBRARY:
ISPF: PROJECT ===>
GROUP ===>
TYPE ===>
MEMBER ===> (Blank or pattern for member selection list)

CONCATENATED LIBRARY LIST: MEMBER ===>

OTHER DATASET ===>

10.compare..

INPUT DATA FILE 1 ===> 1NDVT.DBA.COD.DD1D101I'

INPUT DATA FILE 2 ===> 'NDVT.DBA.TRIAL'

Use COBOL or PL/1 layout to format display ===> NO (YES, NO)

Max number of differences to be displayed ===> (Blank = ALL)
Horizontal output (unformatted only) ===> NO (YES, NO)

COPY LIBRARY:
ISPF: PROJECT ===>
GROUP ===>
TYPE ===>
MEMBER ===> (Blank or pattern for member selection list)

CONCATENATED LIBRARY LIST: MEMBER ===>

OTHER DATASET ===>

ims…

OPTION ===>

0 PARMS - Specify INSYNC parameters

1 BROWSE - Database browse
2 EDIT - Database edit
3 PRINT - Database print
4 FORMAT - Segment format tables
5 EXTRACT - Extract database records
6 LOAD - Load extracted database records
7 RELATE - Extract Relationships
B BATCH - INSYNC IMS batch functions
T TUTORIAL - Display information about INSYNC/IMS

Software Excellence from Macro 4

(c) Copyright Macro 4 1991,2001. All rights reserved

1.browse

COMMAND ===> => IDT0

Region type ===> DLI (DLI, BMP)

DBD LIBRARY:
Dataset name ===> 'IMSVS.IDT0.DBDLIB'
Member name ===> DBDO1AL (Blank or pattern for selection
list)

Exclude segments ===> YES (YES, NO)

Use dynamic allocation dataset names ===> NO (YES, NO)
Use record layout to format display ===> NO (YES, NO)
Initial segment is: FIRST, or found
using OLD or NEW selection criteria ===> FIRST (FIRST,
OLD, NEW)
Use secondary indexes ===> NO (YES, NO)

FORMAT LIBRARY:
Dataset name ===>
Member name ===> (Blank or pattern for selection list)
5.extract.

Region type ===> DLI (DLI, BMP)

DBD LIBRARY:
Dataset name ===> 'IMSVS.IDT0.DBDLIB'
Member name ===> DBDO1AL (Blank or pattern for selection
list)

Output data file ===> 'TEST.DBA.DB159.EXTFILE.FEB2803'

Output dataset disposition ===> OLD (NEW, MOD,

OLD)
Include segment validation records ===> NO (YES, NO)
Exclude segments ===> YES (YES, NO)
Use stored selection criteria ===> NO (YES, NO)
Use dynamic allocation dataset names ===> NO (YES, NO)
Maximum number of roots to extract ===> (Blank = ALL)

----------------------------------------------
| INSYNC - BROWSE PRIMARY OPTION |
----------------------------------------------

The BROWSE option of INSYNC will display segments from an IMS database
in a formatted or unformatted mode. One segment at a time is displayed.
For formatted mode the name of the dataset containing the COBOL or PL/1
record descriptions of the segments is obtained from the segment definition
table. A warning message will be issued if the COBOL or PL/1 description
length does not match that of the segment being browsed.

Browse usually positions at the start of the database, unless OLD or NEW

selection criteria are specified on the browse Database Specification

panel.

The following topics are presented in sequence, or may be selected by

entering a one-character selection code in the option field:

1 - BROWSE formatted mode

2 - BROWSE unformatted mode
3 - BROWSE full screen mode
 . . . . . . . . . . . . . . . . . . . . . . . . .

----------------------------------------------
| INSYNC - EDIT PRIMARY OPTION |
----------------------------------------------

The EDIT option of INSYNC allows you to display the segments within a
database record in either formatted or unformatted mode. One segment
at a time is displayed. For formatted mode the name of the dastaset
containing the COBOL or PL/1 descriptions of the segments is obtained
from the segment definition table. If the COBOL or PL/1 record description
length does not match the record length of the segment being edited
the edit session will be switched to unformatted mode.

Edit usually positions at the start of the database, unless OLD or NEW
selection criteria are specified on the Edit Database Specification panel.

The following topics are presented in sequence, or may be selected by

entering a one-character selection code in the option field:

1 - EDIT formatted mode

2 - EDIT unformatted mode
3 - EDIT full screen mode
. . . . . . . . . . . . . . . . . . . . . . . . .

----------------------------------------------
| INSYNC - EXTRACT PRIMARY OPTION |
----------------------------------------------

The EXTRACT option of INSYNC allows you to selectively extract records from
a database and write them to an unload format dataset.

Specify the database to be unloaded, the extract dataset name, its DISP and
whether to include segment validation records at the front of the output file.
Validation records are for use in a subsequent LOAD operation, to check that
the extract file and the database to be loaded are compatible. Note that these
cannot be specified with DISP of MOD, since validation records must be placed
at the front of the file.

When using dynamic PSBs, you may specify if you wish to exclude segments and
you will then be presented with a panel containing a segment list.

If you specify NO to "Use dynamic allocation dataset names", you will be

presented with a panel to specify the datasets names.
 ----------------------------------------------
| INSYNC - LOAD PRIMARY OPTION |
----------------------------------------------

The LOAD option of INSYNC allows you to load segment records from an
INSYNC UNLOAD format dataset to a IMS database.

Specify the database to be loaded and the input dataset.

ADD to existing = NO

Dynamic PSB: The database MUST be empty i.e. contains NO segments.

Static PSBs: The supplied PSB MUST have a PROCOPT of L or LS(HIDAM)

ADD to existing = YES

Dynamic PSB: Database must contain at least one root segment.

Static PSBs: The supplied PCB must NOT have a PROCOPT of L or LS

If the input file was created by an EXTRACT with 'Include segment validation
records' YES, the LOAD operation will check compatibility with the target
. . . . . . . . . . . . . . . . . . . . . . . . . . .

INSYNC ---------------- Data Manipulation Utility ---------------- Ver 4.100T

OPTION ===>

0 PARMS - Specify INSYNC parameters

1 BROWSE - Dataset browse
2 EDIT - Dataset edit
3 PRINT - Dataset print
4 LAYOUT - COBOL or PL/1 record layout processing
5 CREATE - Formatted or Unformatted record create
6 EXTRACT - Create extract dataset
7 TABLES - Define complex record layout information
8 FIELDMAP - Map fields to new record layout
9 RESERVED - Reserved for future use
10 COMPARE - Dataset record compare
11 DATEAGE - Adjust dates within datasets
U UTILITIES - INSYNC utilities
B BATCH - INSYNC batch functions
IMS IMS - INSYNC/IMS
T TUTORIAL - Display information about INSYNC

Software Excellence from Macro 4

(c) Copyright Macro 4 1991,2001. All rights reserved