Program Development Extension

PROGRAM DEVELOPMENT EXTENSION

USER MANUAL

Winkler-Davis

San Francisco, California

(415) 956-6626



 PROGRAM DEVELOPMENT EXTENSION (PDX) USER MANUAL RELEASE 3.3 

 06/15/1991 



PREFACE

This manual describes Program Development Extension (PDX). It addresses PDX functions as separate, but interrelated, steps. To minimize searching for individual panels to accomplish a given function, panels and key actions required for each task are grouped and illustrated. Users are encouraged read the Overview section, however, before attempting to research a particular function.

RELEASE 3.3 ENHANCEMENTS

Release 3.3 is a major upgrade to prior releases. Its installation requires compiling all COBOL programs and a one-time database conversion, using an installation utility. The new features provided are:

•Automatic Delta Generation.

•Automatic Cross Reference (XREF Command).

•Automatic Related Library Allocation.

•External BROWSE and EDIT functions, allowing authorized developers direct access to PDX entities.

•An external language translation command, allowing authorized developers to compile programs from inside other tools or directly from ISPF panels.

•A command to quickly compress PDS datasets.

•A new PDX Repository Interface (API).

•A set of host and workstation commands and programs allowing synchronization of materials being developed on the host for workstation install or materials being developed on the workstation for host installation.

•A new DEFINE command allowing definition of entities to be worked on without typing.

The new features are described in the appropriate sections of this manual.

RELATED DOCUMENTS

PDX System Administration Guide

Provides System Administrators with functions and procedures for initializing and maintaining PDX parameters, such as Authorization, Change Archival, Library and Data Base backup and restoration.

PDX System Programmers' Guide

Provides detailed Program Logic, Data Base Layouts and performance suggestions.

ACKNOWLEDGMENTS

Contributors

Winkler-Davis acknowledges the participation of the individuals who contributed to this document and who offered many valuable suggestions for features which have been included in PDX.

Vendor Interfaces

LIBRARIAN is a trademark of Applied Data Research, Inc.

PANVALET is a trademark of Pansophic Systems, Inc.

ACF2 is a trademark of Computer Associates International, Inc.

RACF is a trademark of International Business Machines, Inc.

Top Secret is a trademark of Computer Associates International, Inc.

DB2 is a trademark of International Business Machines, Inc.

IDMS is a trademark of Culinet, Inc.

 PREFACE PROGRAM DEVELOPMENT EXTENSION 

 6/15/1991 RELEASE 3.3 

______

PREFACE...... i

SECTION 1 - OVERVIEW 1

SECTION 2 - START...... 9

SECTION 3 - DEFINE...... 17

SECTION 4 - DEVELOP...... 25

SECTION 5 - REVIEW...... 39

SECTION 6 - APPROVE...... 41

SECTION 7 - INSTALL AND BACKOUT...... 43

SECTION 8 - ENTITY ATTRIBUTES AND RELATIONSHIPS...... 45

SECTION 9 - ARCHIVE AND RETRIEVAL...... 47

SECTION 10 - RELEASE-CONTROL SEGMENTS...... 49

SECTION 11 - DELTA PROCESSING...... 53

Appendix A Library Types and Relationships...... 59

Appendix B CLIST Procedures...... 61

Appendix C Batch Messages...... 62

Appendix D Online Messages...... 64

PREFACE...... i

SECTION 1 - OVERVIEW 1

SECTION 2 - START...... 9

SECTION 3 - DEFINE...... 17

SECTION 4 - DEVELOP...... 25

SECTION 5 - REVIEW...... 39

SECTION 6 - APPROVE...... 41

SECTION 7 - INSTALL AND BACKOUT...... 43

SECTION 8 - ENTITY ATTRIBUTES AND RELATIONSHIPS...... 45

SECTION 9 - ARCHIVE AND RETRIEVAL...... 47

SECTION 10 - RELEASE-CONTROL SEGMENTS...... 49

SECTION 11 - DELTA PROCESSING...... 53

Appendix A Library Types and Relationships...... 59

Appendix B CLIST Procedures...... 61

Appendix C Batch Messages...... 62

Appendix D Online Messages...... 64

 TABLE OF CONTENTS PROGRAM DEVELOPMENT EXTENSION (PDX) USER MANUAL 

 6/15/1991 RELEASE 3.3 

______

SECTION 1 - OVERVIEW

1.1Purpose

Program Development Extension (PDX) facilitates changes to the data processing production environment, including Development, Test, Approval, and Installation.

PDX supports managment and control of the orderly implementation of production changes. It supports the development process and ensures that the source and execution entities correspond and valid copies of current and previous production entities are available.

1.2Composition

The PDX System consists of computer programs, interactive ISPF panels, messages and skeletons. A control data base is used to store information about changes and their entities. A set of data security rules ensures that actions are authorized.

1.3Control Features

PDX control is accomplished by a set of ISPF panels which enable authorized users to:

•Obtain copies of production entities.

•Edit test versions in controlled staging libraries.

•Compile and link (or otherwise translate) test versions.

•Perform appropriate tests from staging libraries.

•Mark the entities ready for installation at the correct time and sites.

Authorized personnel may review and approve changes in Ready Status. Only authorized personnel may then install the reviewed and approved changes. PDX also performs the following functions:

•Ensures that backup copies of production are created before changes are made.

•Enables quick and orderly backout of changes when necessary.

PDX host Panels are driven by a set of COBOL programs, plus some Assembler subroutines. The COBOL programs have program path authority to update the PDXcontrolled libraries (which may NOT be updated by any other means). Each time a controlled library is modified, PDX creates an audit record, thus ensuring production library integrity.

The PDX Data Base, CLIST libraries and override libraries contain:

•Library Names and Relationships.

•Entity History.

•Entity Attributes.

•Compiler Options.

•Threshold Condition Codes.

•Entity Deltas.

•Change Segment Entities and Status.

•Language processor and preprocessor parameters.

These data include everything required for executing source language translations and installs into production in accordance with enterprise and application standards.

The control data base also stores lists of users authorized to perform PDX functions and the scope (e.g., application or group) within which the function is valid.

There are six levels of parametric control data:

1.Global

2.Group

3.Application

4.Segment

5.Segment Library Type

6.Segment Entity

Standard parametric data controlling the operation of compiles, link edits and other "source" to "target" translations reside at the Global level and, optionally, at any of the other lower levels. Thus, overrides at any of the above levels are permitted. A translated entity of a change segment has an associated "standards level" that is determined by the highest number of the override data encountered by the PDX source conversion process. The change segment as a whole assumes a standards level equal to the highest standards level of any of its elements.

In addition, detailed parametric data may be stored and retrieved for each PDX Entity.

1.4Benefits

Combined as a system, the PDX panels, controlled libraries, Installation automated security rules (RACF or operating system security package), the PDX control database and PDX procedures:

•Ensure that production source and execution entities correspond,

•Maintain the specified number of production back-level copies,

•Maintain all entities required to reconstruct a load entity from source,

•Provide an integrated, consistent means for developers to specify, prepare and test changes,

•Maintain a complete and accurate audit trail of production library modifications, and

•Highlight non-standard changes when changes are made (the READY function) and allow for reporting non-standard changes on an audit report.

1.5Change Functions

Production change development functions available to Users are displayed on the PDX Primary Menu Panel:

 -- PROGRAM DEVELOPMENT EXTENSION 

 OPTION ===> _ 

 USERID: TSOID TIME: 12:31 

 SYSTEM: PROD 

 

 C CONTROL Show/define segments for CHG CNTL==> 

 P PROCESS EDIT, COMPILE, LINK, TEST 

 S STATUS Examine or update change status 

 L LIBRARIES Manipulate segment libraries 

 R REVIEW Browse changes by category 

 A ADMIN Update system parameters or user authorization 

 O OPTIONS Create or modify user options 

 E ENTITIES Update or translate entities 

 T PDX DESC How to use the system 

 X EXIT Return to previous panel 

 

 SEGMENT ID====> 0000000 GROUP ID ==> APPLID ===> ABC 

 

Figure 1(A). PDX Primary Menu Panel

Functions of each option are as follows:

CONTROL•Provide Change Control Number to PDX

•Specify (add/change/delete) Change Segments

•Inquire concerning Change Segments

PROCESS•Add, Change or Delete entities of a segment

•Fetch Elements from Production into Segement Libraries

•Fetch Entities from another Segment into Segment Libraries

•Edit Segment Entities

•Compile, link and test programs

•Import Entities to Segment Libraries

•Export Entities from Segment Libraries

•Checkout Entities to Workstation

•Checkin Entities to Workstation

•Promote Entities to Quality Assurance Segments

•READY Segment

STATUS•Review, or (for Segments in progress) modify Segment Status data including description, installation windows, remote site specifications or remarks

•Approve Segments

•Install Segments

•Backout Segments

LIBRARIES•Allocate, delete, or reallocate Segment Libraries

•Import complete PDS datasets

•Copy segment definitions from another segment

REVIEW•Display segments matching selection criteria

•Browse changes in progress, or installed

ADMIN•Review Production Library parameters

•Update Production Library parameters

•Review User Authorizations

•Update User Authorizations

OPTIONS•Review User Profile data

•Modify User Profile data

ENTITIES•Entity attributes

•Entity history

•Entity relationships

•Translation of production source entities

TUTORIAL•Obtain assistance for using the PDX System

1.6Program Function (PF) Keys

PDX is menudriven, with commands that can be entered on one or more PDX panels. See Section 2.2, "Command Summary," for a list of PDX commands.

Program Function (PF) Key usage is standard.

FUNCTIONKEY ENTRY

______

HELP/TUTORIALPF1

SCROLL UPPF7

SCROLL DOWNPF8

EXIT TO THE PREVIOUS PANELPF3

EXIT TO THE PRIMARY PANELPF4

GO TO ANY PANELIn any field with = =>, (See above) Enter = plus Panel Identification (and suboption if wanted)

NOTE: PF Keys can be changed using the 'KEYS' command (These PF Key values are separate from the standard ISPF keys.)

1.7System Terms

GROUPA 3 character code for permitting access to system features for more than one APPLID code. In general, represents a set of applications which can share access to change segment libraries and parametric data.

APPLID3 character code identifying the Application. There are one or more applications in a GROUP.

ENTITYA member of a production library. A unique object of a change. An entity is an element of a LIBTYPE.

CHANGE8 character code referring to all segments and Approvals for a Change.

SEGMENTA set of entities to be installed as a unit at one or more locations at a specified time. Identified by a 7digit number. One or more segments may be associated with a change.

SEGMENT LIBRARYLibrary created by PDX System as directed by an Authorized User. The segment library contains materials being created or modified by the developer.

LIBTYPEThe internal name for a target production library or dataset containing "entities".

RELATIONSHIPSA libtype may be related to another libtype (e.g., SOURCE-LOAD) or an entity may be related to another entity. Entities inherit libtype relationships and may also have particular relationships to other entities (e.g., COPY, SOURCE). PDX provides ways to define these relationships.

1.8Responsibility

Typical responsibilities for various PDX System functions are as follows

FUNCTIONTYPICAL ORGANIZATION/POSITION

______

Product Management,Problem and Change Management,

PDX Process ManagementSystem Control

Initial System TrainingPDX Administrator/Team

Provide Control InformationSystem Development

Change ProcessesSystem Development

Define/prepareProgrammers

Make ReadyProject Leaders

ApproveQuality Assurance

InstallImplementation Support

BackoutImplementation Support

Emergency ProceduresProduction Support

 SECTION 1 - OVERVIEW PROGRAM DEVELOPMENT EXTENSION (PDX) USER MANUAL 

 6/15/1991 RELEASE 3.3 

______

SECTION 2 - START

2.1Quick Overview

If you have browsed this manual and perhaps have had a chance to go through the PDX tutorial provided for IBM compatible PCs and/or the host tutorial, you may wish to just "dive in" and try the system. This subsection is an overview of the steps required to define, prepare and install a change to the production environment. These are the steps to follow:

1.Define Segment. Select CONTROL on the PDX primary panel. To do this, you must have received your change control number from a source outside of PDX. Enter this number (left justified, if you wish) on the primary panel, and enter a "C" on the command line. Depress ENTER. Then overtype the information you see to define a "segment" and ENTER. When CHANGE DEFINED appears in the upper right corner of your screen, proceed to the next step.

2.Update Install Windows. Select the STATUS option (enter "=S" on the command line and ENTER). On this panel, modify the "window" for the installation time of your change segment to the correct dates and times. ENTER. STATUS UPDATED appears on the upper right hand corner of the panel.

3.Define Entities to be Changed. If this is a conversion and/or you have a lot of entities, perform step 8 and then proceed directly to step 5, bypassing step 4. If this segment is almost like a previously defined segment, perform step 9. Otherwise, select the PROCESS panel (Enter "=P" on the command line) and perform step 10.

4.Allocate Staging Libraries. The entities of your segment are now defined. Allocate a segment library for each library type. Do this by entering ALLOC on the command line. The AUTOMATIC ALLOCATION panel will be displayed. Enter the library type and the approximate number of elements it will contain for each library to be allocated. PDX will allocate related libraries if they are not already allocated. Then END (PF3).

5.Fetch Elements. You may now FETCH entities from production or another change. Alternatively (and with less auditability) you can simply use EDIT/COPY to bring elements into your segment library. Use the "F" line action on the Process panel to FETCH.

6.Translate Source to Executable. For ASIS entities, no further processing is needed. For entities that must be translated, enter "T" next to the source for the entity. A job will be submitted for each entity. If the translation process is correct, a zero return code will appear on the panel for both source and related target entities. If a non-zero return code appears, determine the reason and correct.

7.Test from Staging Libraries. Test the entities of the change segment. For batch load entities, you can STEPLIB to the dataset:

{system-prefix}.{GRP}{APL}.C{segnum}.{libtype}.

For online entities, your CLIST process probably has copied the load entity into your online test library. Test in the normal manner.

8.Ready Segment. When testing is complete, enter READY on the command line of the PROCESS panel. This "freezes" your segment. Notify the person that will approve your change segment that "segment xxxxxxx is ready.". You can then periodically check to see if the segment has been approved or installed. When your segment status is "A", the segment is approved. When your segment status is "I", it has been installed. If production fails, an authorized individual can "backout" the segment, restoring the previous versions of each element in your segment.

9.Importing an Entire Library. For conversions or for a vendor package, use the LIB IMPORT function to define the elements of the change, allocate the segment library, and physically copy the elements from an external library to the segment library. Select LIBRARIES ("L") on the primary panel. Then select IMPORT LIBRARY ("I") and follow instructions.

10.Copying a Previous Definition. For a segment with a lot of elements that is to be just like or almost like a previous segment, copy the definition from the previous segment. Select LIBRARIES ("L") from the primary menu. Then select COPY CHANGE and follow instructions.

11.Enter Definition. If this is a relatively small number of entities, just enter the entity names, the library types and the clist names on the process panel. Once a few have been entered, you can overtype the ones there to provide a "ditto mark" effect.

2.2Command Summary

The following commands may be entered while in TSO EDIT within TSO:

PDXCOMPCompresses the current EDIT dataset. Use this command if you experience an E37 ABEND while editing a source entity.

COMPILETranslate the entity being edited. This command is provided as a convenience for initial diagnostic compiles. Care must be exercised because the compiler return code will be masked on the process panel if you exit EDIT after the translation is complete.

The following commands may be entered on any PDX panel:

OPTIONSUse this command to set up or modify your PDX profile. See primary panel, Option O, for help on this subject.

The following commands may be entered on the STATUS panel (Option S from the primary panel):

INSTALLSubmit a batch job to install the current segment (which must be in approve status). The user must have INS authority.

BACKOUTBackout the current segment.

The following commands may be entered on the PROCESS panel (Option P from the primary panel):

TRANS {libtype}

In this case, libtype must be a library type that exists in the current segment. ALL members of this libtype are translated (compiled and linked, etc.).

XREFUpdate the repository cross-reference for this segment. For example, the relationship pointers for copy members in the segment that are used by programs in the segment are updated.

VERIFYPerform extended checking in the elements in the segment. Verify checks that members are present in the staging libraries for each entity on the process panel, that compiles and links have been performed in the proper sequence and that all required related entities are present in the segment.

ALLOCAllocate segment staging library or libraries for this segment.

BACKOUTIssue this command on the status panel. The segment is backed out. The user must have INS authority.

COPYCHGThis command allows copying the definition of another change into the current change.

READYReady should be executed on the process panel. It checks to make sure all entities have zero return codes and places the segment in ready status if so. The user must have RDY authority to issue this command.

PROMOTEIssue this command on the "from" segment to promote entities from this segment to the "target" quality assurance segment. See Section 10, Release Control Segments.