Chapter 12: Using the APS/ENDEVOR Interface

This chapter contains the following sections:

APS/ENDEVOR Overview
Using APS/ENDEVOR

APS/ENDEVOR Overview

Version control for APS applications

The APS/ENDEVOR Interface is an interface between Micro Focus's APS for z/OS and LEGENT Corporation's ENDEVOR/MVS software management product. The interface lets you manage your APS application components--called elements in ENDEVOR--using ENDEVOR from within APS for z/OS.

APS/ENDEVOR tasks

Specifically, you can do the following:

Store and retrieve multiple revisions of an APS application component.
APS/ENDEVOR stores all revisions of an application component in a single controlled member in the ENDEVOR/MVS library. You can retrieve any revision at any time.
Manage all components of an application as one group.
For an application component that references all components of an application, APS/ENDEVOR manages all its referenced components as a group. You can add, update or sign in, and retrieve and signout all components of an application with one request.
Resolve access conflicts.
When you retrieve a revision to modify it, you can sign it out to prevent other developers from simultaneously changing that revision.
Display the history of source code changes.
You can display just the statements that differ between a specific revision and the preceding one, instead of comparing revisions line by line. Alternatively, you can display all the inserted and deleted statements in all revisions of a component.
Display component information.
You can display log information on all revisions of a component, including creators and creation dates, the origin of the base revision, and when it was last generated and retrieved, and by whom.

Supported actions and displays

The APS/ENDEVOR Interface lets you use the basic ENDEVOR/MVS action and display functions that you are likely to need. For those functions not supported by the interface, you can invoke ENDEVOR/MVS from within APS. This document discusses only those ENDEVOR/MVS functions relevant to understanding and using the interface.

The APS/ENDEVOR Interface provides options that correspond to ENDEVOR/MVS actions and displays, as follows. Each option works in APS just as it works in ENDEVOR.

Interface Option	ENDEVOR/MVS Function
Checkin	Add/Update or Signin
Checkout	Retrieve and, by default, Signout
Summary Report	Summary Element Display
Master Report	Master Element Display
Browse Report	Browse Element Display
View Differences Report	Changes Element Display
History Report	History Element Display

Checkin

The check in action adds to or updates the ENDEVOR library with an APS component from an APS Project.Group. Alternatively, you can sign in a component at checkin, without adding to or updating the library.

The first time you check in a component from your APS Project.Group, APS/ENDEVOR creates a controlled member that stores the component, and all subsequent revisions of that component, in the ENDEVOR/MVS library. The first checked in component is the first revision. It has the version number number 01 and the level number 00, expressed as 01.00.

A controlled member contains the following information:

The complete text of the latest revision of the component.
The modified text, or set of deltas, from all prior revisions. When a user checks out any prior revision, ENDEVOR reconstructs it from the latest revision and the deltas of the prior revisions.
Log information on all revisions that you can display in reports.

APS submits a batch job to check in the Program (PG) and Screen (SC) component types; for all other component types, APS executes a job immediately.

Checkout

The checkout function retrieves and, by default, signs out a revision from a controlled member of the ENDEVOR library to an APS Project.Group so that you can modify it.

By signing out a revision, you prevent anyone else from modifying it. Conversely, you cannot checkout a revision that has been checked out by some one else. You can, however, override the signout, assuming you have authority to do so. Otherwise, the signout is released when the component is moved or transferred to another Stage.

Reports

APS/ENDEVOR provides reports that help you monitor the changes made to APS components in the ENDEVOR library.

The View Differences report lets you display the source statements that differ between a specific component revision and the preceding one.

The four View Print reports let you display log and source change information on one or all revisions of a component.

Report	Description
Browse	Log information on all revisions, including creators; creation dates; number of statements; CCIDs; comments; when the component was last generated and retrieved, and by whom. All statements in the specified revision, marked with the level number at which they were first inserted.
History	Log information on all revisions, including creators; creation dates; number of statements; CCIDs; comments; when the component was last generated and retrieved, and by whom. All inserted and deleted statements that ever existed in all revisions of the component, marked with the level number at which they were inserted or deleted.
Master	Information on a component, including its processor group; the last action performed against it; its current signout status; when it was last modified and generated, and by whom; the origin of its base revision; who moved or transferred the component from a Stage, and when.
Summary	Log information on all revisions, including creators; creation dates; number of statements; number of inserted and deleted statements.

For information on ENDEVOR/MVS, see the ENDEVOR/MVS User's Guide and the ENDEVOR/MVS Administrator's Guide.

Using APS/ENDEVOR

This section provides instructions for accessing the interface, specifying the APS location for checkins and checkouts, executing checkins and checkouts, and running reports.

Accessing APS/ENDEVOR Options

To access the APS/ENDEVOR Interface, select option 5, Version Control System, from the APS Main Menu. The APS/ENDEVOR Version Control Menu displays.

Select one of the five APS/ENDEVOR options.

Option	Function
Project Group Environment	Specify the APS Project and Group for checking components in and out.
Checkin	Add to or update the ENDEVOR library with an APS component from an APS Project.Group, or signin a component without adding to or updating the library.
Checkout	Retrieve and, by default, sign out a revision from a controlled member of the ENDEVOR library to an APS Project.Group so that you can modify it.
View Differences	Display a report showing the changed source statements that differ between a specific component revision and the preceding one.
View Print	Display reports showing log and source change information on one or all revisions of a component.

If you need to use an ENDEVOR/MVS function not presented on the APS/ENDEVOR Menu, you can access ENDEVOR/MVS from any APS screen by entering ndvr in the Command field on any APS screen.

Specifying a Project and Group

From the APS/ENDEVOR Version Control Menu, select option 0, Project Group Environment. Alternatively, enter proj in the Command field on any APS screen.
Specify the Project and Group you want to check components in from, and check components out to. You can change the value at any time.

Checking a Component In

From the APS/ENDEVOR Version Control Menu, select option 1, Checkin. Alternatively, enter ci in the Command field on any APS screen.

Complete the Checkin screen fields as follows:

Screen Field

Description

Entity Type

Entity Type of the APS component to check in. Valid values:

ap	Application Painter component in APSAPPL plus its related component in APRAPPL
cn	Scenario Painter component in APSCNIO
ds	Data Structure Painter component in APSDATA
ox	Online Express component in APSEXPS
pg	Program Painter component in APSPROG plus its related component in APRPROG
rp	Report Mock-up Painter component in APSREPT
sc	Screen Painter component in APSSCRN

For other APS component types in your Project.Group, specify a data set name, such as USERMACS and DDISYMB.

Member

Component name to check in, or leave the Member field blank to select from a member list.

System

ENDEVOR System name, if it differs from the default System name for your current APS Project.Group.

Subsystem

ENDEVOR Subsystem name, if it differs from the default Subsystem name for your current APS Project.Group.

Comment

Text comment for the checkin.

CCID

ENDEVOR CCID for the checkin.

Bypass Gen Processor

Default: No. Specify yes to bypass the associated ENDEVOR Generate Processor.

Delete Input Source

Default: No. Specify yes to delete the component from the APS Project.Group.

Processor Group

Name of the ENDEVOR Processor Group.

Override Signout

Default: No. Specify yes to override an existing signout. You must have authority to do so.

Signin Only

Default: No. Specify yes to Signin only, releasing a previous signout of the component issued with your user ID; the Add or Update action is not executed.

Stage

ENDEVOR Stage number for signin.

Component Parts

To use when checking in AP and PG component type components. Valid values:

none

Default. Process only the component specified in the Member field.

all

Process the component specified in the Member field and all its associated component parts, or components.

list

Display the Component Types Selection screen, to select the associated component types for processing.

APS submits a batch job to perform the checkin when some or all component parts are checked in with the component specified in the Member field.

Press Enter to execute the checkin.
Check the ENDEVOR Action Summary Report to ensure that the checkin job succeeded.

Checking a Revision Out

From the APS/ENDEVOR Version Control Menu, select option 2, Checkout. Alternatively, enter co in the Command field on any APS screen.

Complete the Checkout screen fields as follows.

Screen Field	Description
Entity Type	Component Type of the component to checkout. Valid values same as for Checkin.
Member	Member name to checkout, or leave the Member field blank to select from a member list.
System	ENDEVOR System name, if it differs from the default System name for your current APS Project.Group.
Subsystem	ENDEVOR Subsystem name, if it differs from the default Subsystem name for your current APS Project.Group.
Stage	ENDEVOR Stage number of the member to checkout.
Version	Defaults to the current revision. You can optionally override this value with another version number.
Level	Defaults to the current level. You can optionally override this value with another level number.
Comment	Text comment for the checkout.
CCID	ENDEVOR CCID to associate with the checkout.
No Signout	Specify yes to checkout and browse the member without signing it out to your user ID.
Replace Member	Specify yes to overlay an existing member in the APS Project.Group.
Override Signout	Specify yes to override an existing Signout by another user. You must have authority to do so.
Component Parts	For use when checking out AP and PG component type components. Valid values same as for checkin.

Press Enter to execute the checkout.
Check the ENDEVOR Action Summary Report to ensure that the checkout job has succeeded.

Running the View Differences Report

On the APS/ENDEVOR Version Control Menu, select option 3, View Differences. Alternatively, enter df in the Command field on any APS screen.
Specify the name, location, version, and level of a controlled member revision you want to report on. The report defaults to the current version and level; you can override with any version and level.

Running the View Print Reports

On the APS/ENDEVOR Version Control Menu, select option 4, View Print. Alternatively, enter vp in the Command field on any APS screen.
Run any of the reports by specifying the report, name, and location of a controlled member you want to report on. For reports on a specific revision, specify the version and level of the revision to report on. The report defaults to the current version and level; you can override with any version and level.