QuickStart

®
(For Windows Interface)
 PrimeCode™ is a trademark of Data Design Systems, Inc. PrimeCode
contains intellectual property which is proprietary to and a trade secret of
Data Design Systems, Inc. and/or Canyon Software Alliance, Inc.
Unauthorized reproduction of this document is strictly prohibited.

For any occurrence of the word PrimeCode, the trademark is assumed. All
other brand names are trademarks or registered trademarks of their
respective companies.

Copyright © 1999. All rights reserved. No part of this document may be

reproduced in any form by any means without express written permission
from Data Design Systems, Inc.

Document History

Edition Release Date

First Edition PrimeCode 3.0 November 1999

5915 Airport Road,

Suite 625,
Mississauga, Ontario, Canada. L4V 1T1

( (905) 677-6666  (905) 677-6671 8 sales@datadesign.com

þ www.datadesign.com
 Table of Contents

Preface
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Purpose of the QuickStart. . . . . . . . . . . . . . . . . . . . . . vii
Symbols and Conventions Used in This Document . . . . . . . . viii
Related Documentation . . . . . . . . . . . . . . . . . . . . . . . viii

Installing the Client

System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . 1
PC Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Communication Requirements . . . . . . . . . . . . . . . . . . . . 2
RTC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
RSC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Running Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

The Quick Tour

Logging In . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Main Window Features . . . . . . . . . . . . . . . . . . . . . . . . 7
Title Bar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Menu Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Toolbar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Status Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Operation Windows Features . . . . . . . . . . . . . . . . . . . . 12
Hourglass . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Find . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Drop-Down Lists . . . . . . . . . . . . . . . . . . . . . . . . . 13
Check Boxes. . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Radio Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Status Bar Help . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Swap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Navigator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Explorer Windows Features . . . . . . . . . . . . . . . . . . . . 16
Resizing Explorer Windows. . . . . . . . . . . . . . . . . . . . 17
Navigation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

iii
 Explorer Toolbar . . . . . . . . . . . . . . . . . . . . . . . . . 18
Right-Click Menus . . . . . . . . . . . . . . . . . . . . . . . . 19
Catalog Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Release Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Location Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . 24
UserChange Explorer . . . . . . . . . . . . . . . . . . . . . . . . 25
Drag and Drop Operations . . . . . . . . . . . . . . . . . . . . . 26
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Performing a Drag and Drop Operation . . . . . . . . . . . . . . 26
Drag and Drop a Single Component . . . . . . . . . . . . . . . 26
Drag and Drop Multiple Components . . . . . . . . . . . . . . . 27
Features Using Drag and Drop . . . . . . . . . . . . . . . . . . . 28
Add a Compile Relationship . . . . . . . . . . . . . . . . . . . 28
Add a Component Requisite . . . . . . . . . . . . . . . . . . . 28
Add a Release Requisite. . . . . . . . . . . . . . . . . . . . . . 28
Add a Reference . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Rules - Add Step . . . . . . . . . . . . . . . . . . . . . . . . . 28
Link to a Group or Object . . . . . . . . . . . . . . . . . . . . . 28
Link a Component to a Release . . . . . . . . . . . . . . . . . . 28
Link a Component to a UserChange . . . . . . . . . . . . . . . 28
Link a Release to a UserChange. . . . . . . . . . . . . . . . . . 28
Link a Component Version to a Release . . . . . . . . . . . . . 29
Link a Component Version to a UserChange . . . . . . . . . . . 29
Unlink From a Group or Object . . . . . . . . . . . . . . . . . . 29
Unlink a Component From a Release . . . . . . . . . . . . . . . 29
Include a UserChange . . . . . . . . . . . . . . . . . . . . . . . 29
Add a License . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Acquire a Release or Manifest . . . . . . . . . . . . . . . . . . 29
Install a Release . . . . . . . . . . . . . . . . . . . . . . . . . . 29
Distribute a Release . . . . . . . . . . . . . . . . . . . . . . . . 29
User Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Favorite Paths . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
WorkSpace . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
User Profiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Options Window . . . . . . . . . . . . . . . . . . . . . . . . . 33
Security and Licensing. . . . . . . . . . . . . . . . . . . . . . . . 36
How to Get Help . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Tool Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Status Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
On-line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Customer Support . . . . . . . . . . . . . . . . . . . . . . . . . 37

iv
Exiting PrimeCode . . . . . . . . . . . . . . . . . . . . . . . . . . 38
File Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Main Window Title Bar . . . . . . . . . . . . . . . . . . . . . . 38
Windows Task Bar . . . . . . . . . . . . . . . . . . . . . . . . 38
Press Alt è F4 . . . . . . . . . . . . . . . . . . . . . . . . . . 38

v
 Notes:

vi
Preface
Introduction
PrimeCode is an enterprise Software Configuration Management (SCM) tool
for managing changes to software applications through the entire software
life cycle across multiple platforms. It is executable object centric, unlike
other SCM solutions which are simply source code centric. PrimeCode goes
beyond simple source code version management. It manages the relationship
between all software application Components, from acquisition through
development, testing and production.

PrimeCode can be enhanced with advanced features such as:

u Automated Change Policy (ACP)
u Code Editor Interface (CEI)
u Parallel Application Development (PAD)
u Enterprise Software Distribution (ESD)
u Cross-Platform Configuration Management (XCM).

Purpose of the QuickStart

The QuickStart has been written to familiarize you with the Windows
Interface to PrimeCode. It starts with the PC client installation, then gives
you a tour of the PrimeCode Windows Interface, describing how it is
organized, the standard features available throughout, and how certain
Windows features have been used.

The QuickStart does not explain PrimeCode software management

functions. You can refer to the appropriate PrimeCode manual for this type
of detailed information. The QuickStart is intended only to familiarize you
with the user interface.

The QuickStart will not teach you how to use your PC or Windows. It
assumes that you have a basic, working knowledge of Microsoft Windows
95/98 or NT. For information about Windows 95/98 or NT concepts and
functionality, you should refer to your Microsoft Windows documentation.

This document has been written for anyone who will be using the PrimeCode
Windows Interface. It has been designed to give you just enough information
to get you started. You can then take advantage of Tool Tips, Status Bar
Help and the On-line Help facility.

vii
 Symbols and Conventions Used in This
Document

ë Important note.

U Caution.

è Help è Contents. Click Help, then from that Menu,

click Contents.

G Extra information or a tip.

Menu PrimeCode terms have an uppercase first letter.

Related Documentation
u PrimeCode Installation Guide.
u PrimeCode/Core Manual.
u PrimeCode/ACP Manual.
u PrimeCode Release Notes.
u Remote Transaction Call (RTC) Administrator and
Programmer’s Guide (available for download from the Data
Design Systems’ website).
u Tandem RSC Installation Manual.
u Piccolo Installation Manual.
u Any Microsoft Windows documentation that came with your
Windows 95/98 or NT operating system.

viii
Installing the Client
System Requirements
PC Requirements
Minimum
Operating System Windows95/98 Windows NT
Processor PentiumI/166 MHz PentiumI/133 MHz
Memory 32 MB 64 MB
Free hard disk space 20 MB 20 MB
Monitor Size 15 inch 15 inch
Monitor Resolution 800 x 600 800 x 600
Recommended
Operating System Windows95/98 Windows NT
Processor PentiumII/266 MHz PentiumII/266MHz
Memory 32 MB 128 MB
Free hard disk space 30 MB 30 MB
Monitor Size 17 inch 17 inch
Monitor Resolution 1024 x 768 1024 x 768

ë Estimated disk space requirement includes space required to install Microsoft

Data Access Components and storage of locally-cached data. (Cache size will
vary depending on the size of the Component database — rule of thumb is 1KB
per Catalog Item).
Estimate does NOT include the size of the On-line Help file.

1
 Communication Requirements
PrimeCode provides support for RTC (Remote Transaction Call), RSC
(Remote Server Call) or Piccolo to communicate with the Tandem.

RTC
u RTC client software is automatically installed into the
PrimeCode directory by the PrimeCode Setup program.

RSC
u You should have already installed the RSC software.
u The RSC directory must be in the Path.
u The 16-bit Windows version of RSC (RSCW.DLL) must be
used on Windows 95/98. You can use the RSCTESTW
program to confirm RSC is working.
u The 32-bit version of RSC (RSCNT.DLL) is required on NT
machines. PrimeCode does not automatically initiate an
RSCTCP process on the PC. We recommend that you add a
shortcut to RSCTCP.EXE in your Windows Startup folder.
Otherwise you will need to restart RSCTCP manually each
time you reboot. You can use the RSCTEST program to
confirm RSC is working.

Running Setup
Before starting the Setup, check that the following steps have been
performed:
u PrimeCode servers should have already been installed on the
Tandem.
u RTC, RSC, or Piccolo communications software should also
have already been installed on the Tandem.
u Uninstall the previously-installed version of PrimeCode.
u If you have run PrimeCode since the last time you started
Windows, there may be parts of the program still loaded in
memory. To clear out these processes, either reboot or use
Task Manager (Ctrl-Alt-Del on Windows 95) and end the
PrimeCode task.
u From the Windows Start menu, select Settings/Control
Panel/Add Remove programs.
u Select PrimeCode from the list, then click the Add/Remove
button.
u If asked if it is OK to remove shared files, click Remove All.
u If you are installing PrimeCode on an NT machine, log on as
a user with administrative privileges.

2
1. Insert the CD in the CD-ROM drive.
The Setup window will display automatically, allowing you to choose from
the following options:
u Install PrimeCode
u Explore the CD
u Install Acrobat
u Exit.

2. Click on Install PrimeCode.

The Setup program will guide you through the installation, prompting you
for information as needed.

Setup will determine if all the necessary Microsoft Windows prerequisite

components are installed on your computer and, if necessary, will install
Microsoft HTMLHelp files, Microsoft DCOM95, and Microsoft Data
Access Components (MDAC).

ë On an NT machine, you must be logged on as a user with administrator

privileges, or the MDAC installation will fail.

ë If a reboot proves necessary, you should restart the Setup program after the
reboot has completed.

You will be prompted for information about the communications software

you are using. Setup will install the COMM.DLL appropriate for that
software (e.g RTC or RSC). COMM.DLL will be installed in the same
directory you select for PrimeCode.

Setup will offer to edit your Path environmental variable to ensure that the
PrimeCode (and if appropriate, RSC) directories are in your Path.

ë You may need to reboot at the end of the Setup if Autoexec.bat was edited.
3. Start PrimeCode.
Double-click on the PrimeCode desktop icon or choose
PrimeCode from the Start/Programs Menu.

ë If you see the message “Run-time error 440, Automation error”, then either
COMM.DLL is missing or not in your Path. Make sure your Path points only to the
most recently-installed COMM.DLL.

3
 Notes:

4
The Quick Tour
Logging In
Once you have started PrimeCode, the Login Window will appear,
prompting you for the following information:
System The node name of the Tandem system running
PrimeCode.
Pathmon The name of the PrimeCode Pathmon.
Group Your Guardian user group.
User Name Your Guardian user name.
Password Your password.

Click on the Login button.

ë The System, Pathmon, Group and User Name fields in the Login window will
default to the names specified during installation, or the names used in the
previous PrimeCode session.

ë PrimeCode/ACP: Read-only access will be granted to users with a valid Guardian

UserID. A Task Security Profile must be added in PrimeCode to allow any further
access to PrimeCode functions. Contact your Security Administrator if you
require any changes to your access privileges.

5
 The PrimeCode splash screen will be displayed while PrimeCode is loading:

ë For an explanation of Login Options, see Options Window - Session Inactivity

Lock in this document.

Now that you’ve started PrimeCode, this is the first window you will see:

Here is a quick tour of the Windows features available to you.

6
Main Window Features
The Main window provides Menus, tools and status information that can be
accessed at any time during your PrimeCode session. When you close this
window you will exit PrimeCode.

Title Bar
Menu Bar

Toolbar

Status Bar

Title Bar
Shows the current system/Pathmon and current user on the left, and the
minimize, maximize and close buttons on the right.

Menu Bar
Access to the hierarchical, Drop-Down Menus.

Toolbar
Icons providing direct access to specific tasks.

Status Bar
Progress status of long tasks and field level help is displayed on the left of
this bar.

Descriptions of each of the features available on the Main window are

documented in more detail on the next few pages.

7
 Title Bar
Minimize the Main window to give access to other programs
on your PC.

Expand or shrink the Main window. Expand it to fit the full

screen size or shrink it, allowing you to view other programs.

Exit PrimeCode.

Menu Bar
The Menu Bar consists of eight hierarchical Menus, described below.

G If a Menu or Menu item has an underlined letter, there is a keyboard shortcut to

invoke that Menu. Press ALT and the underlined letter of the Menu, then when
the Menu appears, press the underlined letter of the Menu option you want to
see.

File
Print Screen
Print the full screen, active window, or displayed contents of an
active window.

Save WorkSpace
Save a list of windows that are open at the current time together with
whatever information is necessary to re-open the same windows with
the same position and content at a later time. See User Options.

Load WorkSpace
Load a previously-saved WorkSpace. See User Options.

Exit
Exit PrimeCode.

Functions
Access to the Navigator and task-level operations, organized in hierarchical
Menus by PrimeCode function. These functions are described in detail in the
PrimeCode/Core and PrimeCode/ACP manuals.
Kernel Policy
Develop Administer
Package Configure
Deploy

8
System
System Information
View system information by clicking on one of three tabs: General,
Location and Options.

u General - Server names, versions, Catalog owner.

u Location - File and spooler locations.
u Options - ACP System and Approval Options.
Change System
Allows you to log in to another PrimeCode system.

Change User
Allows you to log in with a different UserID. Once you have done so,
any command buttons or Menus not allowed to you will be grayed
out.

Refresh Task Security

Will refresh your security privileges from an updated Task Security
Profile.

Edit
Cut
Copy text from a text field and clear the field.

Copy
Copy text from a text field.

Paste
Paste text you have cut or copied into other text fields.

Utilities
Differences
Generate a Differences comparison report to analyze differences
between Components, versions of a Component, NonStop™ Edit
files or any combination thereof.

Info Component
Search for a set of Components you want to retrieve. Specify a Path
and Component name, a pattern matching string, a Define or a file.

Merge
Generate a Merge report and merged file to submit later as a new
version.

9
 Persue
An interface to the spooler.

Scan
Allows you to search the Catalog for Components that match the
specified criteria.

ë These Utilities are described in detail in the PrimeCode/Core manual.

View Options
Display the Options window. User Options are described in detail
later in this document.

Toolbar
Display or hide the Main window Toolbar.

Status Bar
Display or hide the Main window Status Bar.

Expand All
Download and locally cache data for all items in the Catalog.

ë This could take up to an hour or more if you have a large Catalog.

Window
Cascade
Arrange the open windows so that they overlap from the top left to
bottom right of your screen.

Tile Horizontal
Arrange the open windows side by side with no overlapping.

Tile Vertical
Arrange the open windows top to bottom with no overlapping.

G Do not tile windows that can’t be resized. Tiling only works well with windows
that can be resized. Microsoft Windows makes a best attempt at tiling windows
that can’t be resized. However, the results may not be consistent or desirable.

10
 Help
PrimeCode Help
Run the On-line Help.

About PrimeCode
View PrimeCode version, technical support and Microsoft Windows
system information.

Toolbar
Open a Catalog Explorer window. It is described in detail
later in this manual.

Open a Release Explorer window. It is described in detail

later in this manual.

Open a Location Explorer window. It is described in detail

later in this manual.

Open a UserChange Explorer window. It is described in

detail later in this manual.

Print the active window, displayed contents or the entire

screen to a printer that you select. You can also copy the
image to paste into a document. The print preview appears on
the right of the window.

Copy text from a text field and clear the field.

Copy text from a text field.

Paste text you have cut or copied into other text fields.

Run the On-line Help.

11
 Status Bar
Progress of a long operation is shown in the Status Bar.
u Long multiple step operations display a description of what is
happening and/or a Progress Bar.
u Long single step operations show a Progress Bar.

Operation Windows Features

Operation Windows are the windows that appear within the Main window
when you choose an operation from a Menu. They are floating windows
which can be moved around, tiled, cascaded, minimized or resized. The
example below shows the Navigator, Catalog Explorer and User Profile
windows:

There are standard features used in the Operations windows. Some of these
features are shown on the Extract Component Operation window described
on the next page.

12
Hourglass

6
An hourglass is displayed when Component information is being updated
or when a long operation takes place in any Operation window.

Find
Retrieve information for the specified Component version.

Drop-Down Lists
By clicking the down arrow, a list of options appears:

13
 Check Boxes
Options displayed in a frame using Check boxes allow you to select
multiple options at the same time. They can be checked or unchecked
to turn an option on or off.

Radio Buttons
Options displayed in a frame using Radio Buttons allow only a single
selection. When you select a radio button, all the other buttons in the
boxes are turned off.

Status Bar Help

Help about a data entry field or button is also shown in the Status Bar. See
How to Get Help later in this manual.

Swap

Reverse the information in fields on a window such as Add Compile

Relationship.

14
Navigator
The Navigator is displayed after logging into PrimeCode and provides a high
level graphical view of PrimeCode functions.

Associated task-level operations can be accessed by clicking on any of the

functions:
Kernel Policy
Develop Administer
Package Configure
Deploy

Navigator Menus provide you with a direct entry point to specific tasks if
you know which Component you want to work on. Selecting an operation
from the Menu will display a Select Component window which requires you
to identify the Component you want to work on. Clicking on the Select
Component button will retrieve the required Component information and
display the appropriate Operation window for the selected task. If no
Component selection is needed to perform the task (such as Add), the
Operation window will be displayed immediately. Catalog, Release,
Location and UserChange Explorers can also be accessed from the
corresponding Navigator function Menu.

15
 Explorer Windows Features
PrimeCode has four types of Explorers which have been designed to allow
you to easily manage specific Component types within the Catalog:
u Catalog Explorer - a complete view of the entire Catalog.
u Release Explorer - a restricted view of the Releases Group.
u Location Explorer - a restricted view of the Locations Group.
u UserChange Explorer - a restricted view of the UserChange
Group.

There are many standard features common to all Explorers (such as the
Toolbar, and Right-Click Menus) which are explained in this section. Some
features are specific to each type of Explorer and are explained later in this
section.

Explorer windows are accessible from the Navigator, the Main window
Toolbar or Functions Menu.

16
 The Explorer windows are divided into two sides: on the left, a view of all
Catalog Items and on the right, a list of the Contents of the selected Catalog
Item. The Catalog Items are displayed in a hierarchical tree view. The
Contents of any of the Catalog Items will be displayed on the right when
selected.

ë Favorite Paths will appear in the Main window’s Menu Bar when a Catalog,
Release or Location Explorer has the focus. See User Options - Favorite Paths.

All of the Explorers have some things in common which we will explain
next.

Resizing Explorer Windows

You can resize both the active window and the columns within. To resize the
active window, move the mouse to the top, corners, sides or bottom of the
window until the resize arrow (↔) appears, then drag to the size you need.
To resize the columns, move the mouse on the bar between the Catalog
Items and Contents or between each of the headings, then drag to the right or
left.

Navigation
To display the contents of a Group, click on a Group in the Catalog Items
view, or double-click on a Group in the Contents view. After a Group’s
contents are displayed, it will have a plus sign (+), a minus sign (-) or
nothing at the left of the Group icon in the Catalog Items view.
u + means the Group contains other Groups and/or objects.
u - means the Subgroups are already displayed.
u nothing means the Group doesn’t contain any Subgroups.

ë Double-click on a component listed in the Contents view to display detailed

information about that component.

17
 Explorer Toolbar
Properties - display the details of the selected item.

Large Icon View - display the contents as large icons.

Small Icon View - display the contents as small icons.

List View - display the contents as an alphabetical list.

Details View - display the contents as a detailed list.

Move up in the Catalog by one level and display the contents

at that level.

Refresh - update the displayed Catalog information based on

the timestamp of the selected item. If a more recent version
exists in the Catalog the displayed list will be updated as
follows:

u If an item is selected in the Contents list (right side):

refreshes the list displayed in Contents.
u If an item is selected in the Catalog Items list (left side):
refreshes the selected item, all levels above, and items at the
same level that are displayed in the Catalog Items list.

The Path of the Components displayed in the Contents.

Drop-Down List - display a list of all the Catalog Paths

previously visited during the current session.

Go To - takes you to the Path and Component specified in the

Path field (either a selection from the Drop-Down list or
typed directly into the Path field). Right-click on this button
to save or load a PathSet. See User Options - Favorite Paths
later in this manual.

18
 ë Wildcards (*) can be used to limit the Components displayed in the Contents side
of the Explorer. To display only Components starting with “SRC” in the Group
\SOURCES, type: \SOURCES\SRC*. Use “?” to replace any single character
except the backslash “\”. Use square brackets and a range [a-z] to display
Components in the specified range, or use tilde and square brackets ~[a-z] to
display Components not contained in that range.

Right-Click Menus
Right-clicking on any Component or Group will display a pop-up
hierarchical Menu showing all the relevant actions that can be performed on
the selected item. Right-clicking on the white space of the Contents view
displays the Add Menu item.

19
 Catalog Explorer
The Catalog Explorer gives a complete view of the entire Catalog, allowing
you to perform tasks on individual Components.

Explorer Menus are context dependent. Menus in the Catalog Explorer are
related to a Component and general Catalog activities. Although you can list
Releases, Locations and UserChanges, you can only see information about
them at a Component level, and you can only perform Component-level
tasks.

For example, displaying Detail on a Release from the Catalog Explorer will
only display Component detail, not Release-specific detail.

To display Release detail or perform a Release-related task, you should use

the Release Explorer. The same rules apply for Locations and UserChanges.

Icons are used throughout the Explorers to denote a particular Component

type. These icons are shown next to the individual Components in the list. In
cases where the Component type is also an Explorer type, such as Locations,
Releases and UserChanges, the same icon is used next to the Component and
on the Explorer icon. The icons used in the Catalog Explorer are described
next.

20
Groups Unlink folder.

Component Group Components

not currently selected.
Data file.
Component Group
currently selected.
Document file.
Datalib not currently
selected. Document reference.
Datalib currently
selected. External document
file.
External Group not
currently selected. External data file.

External Group
External object file.
currently selected.

Location. External source file.

Object Library not Keyed Component.

currently selected.

Object Library Object file.

currently selected.
Source reference.
Release.

Release manifest.
Release Subsystem
not currently selected.
Source file.
Release Subsystem
currently selected.
Source reference.
Source Library or
DDLDICT not State.
currently selected.

Source Library or UserChange.

DDLDICT currently
selected. Volatile Blob.
UserChange.

21
 Release Explorer
The Release Explorer gives you a restricted view of the Releases Group
which allows you to easily manage Releases. Operations within the Release
Explorer are considered to be Release oriented. However, you can perform
tasks on Components within a Release as though you were using the Catalog
Explorer. The Menus for these Component types will be the same.

Icons are used throughout the Explorers to denote a particular Component

type. These icons are shown next to the individual Components in the list. In
cases where the Component type is also an Explorer type, such as Locations,
Releases and UserChanges, the same icon is used next to the Component and
on the Explorer icon.

The icons used in the Release Explorer are described next.

22
Groups Components
Component file not Data file.
currently selected.

Component file Document file.

currently selected.
Document reference.
Datalib not currently
selected.
External document
Datalib currently file.
selected.
External data file.
External Group not
currently selected. External object file.
External Group
currently selected. External source file.

Object Library not

currently selected. Keyed Component.

Object Library Object file.

currently selected.

Release. Release manifest.

Release Subsystem Source file.

not currently selected.
Source reference.
Release Subsystem
currently selected.
Volatile Blob.
Source Library not
currently selected.

Source Library
currently selected.

Unlink folder.

23
 Location Explorer
The Location Explorer gives you a restricted view of the Locations Group
which allows you to easily manage Locations. All operations shown on the
Menus are Location oriented.

Icons are used throughout the Explorers to denote a particular Component

type. These icons are shown next to the individual Components in the list. In
cases where the Component type is also an Explorer type, such as Locations,
Releases and UserChanges, the same icon is used next to the Component and
on the Explorer icon.

This is the only icon used in the Location Explorer:

Location.

24
UserChange Explorer
The UserChange Explorer gives you a restricted view of the UserChange
Group which allows you to easily manage UserChanges. All operations
shown on the Menus are UserChange oriented.

Icons are used throughout the Explorers to denote a particular Component

type. These icons are shown next to the individual Components in the list. In
cases where the Component type is also an Explorer type, such as Locations,
Releases and UserChanges, the same icon is used next to the Component and
on the Explorer icon.

This is the only icon used in the UserChange Explorer:

UserChange.

25
 Drag and Drop Operations
Introduction
PrimeCode fully supports Drag and Drop operations for many key features
that relate to Linking and Deploy functionality. Drag and Drop operations
take place in the Explorer windows. The various Linking and Deploy tasks
are performed either within the same Explorer window, between Explorer
windows of the same type, between different types of Explorers or between
an Explorer and Operation window.

This section of the manual first explains the general rules for Drag and Drop,
then describes how the Drag and Drop operation works for each PrimeCode
feature.

Performing a Drag and Drop Operation

Begin by opening the required Explorer window(s), select a Component
from the Contents side of the window and drag it to a Component in the
other Explorer window, or to a Component in the Catalog Items side of the
same window.

Based on the type of Component selected and the type of Explorers you are
working with, you will be prompted for verification that you want to perform
a specific task. After verification you may get a Menu of options, or be
prompted for any information necessary to perform the task.

U You can only drag FROM the Contents side of an Explorer window.
Drag and Drop a Single Component
Click on the selected Component and hold the mouse button down. When
you move the mouse the drag icon will appear (the icon will correspond to
the type of Component you have selected). Drag the Component by moving
the mouse over the Component you wish to Link/Deploy to. When it is
highlighted, release the mouse button.

26
Drag and Drop Multiple Components
There are two ways to select multiple Components: contiguous and
noncontiguous. Contiguous Components are a selection of Components
which follow one after the other in a list. Noncontiguous Components are a
selection of Components in no specific order, i.e. that are not grouped in a
list one after the other.
Contiguous

Click on a Component, hold the Shift key down, click on the last Component
in the list you wish to select, and release the Shift key. The list of
Components is now highlighted. Click on the selected list and drag the
Components to the destination Component involved in the Drag and Drop
operation. Drop the list by releasing the mouse button on that Component.
Noncontiguous

Click on a Component, hold the Ctrl key down, click on each Component
you wish to select and release the Ctrl key. The set is now highlighted. Click
on the set and drag the Components to the destination Component involved
in the Drag and Drop operation. Drop the set by releasing the mouse button
on that Component.

U Drag and Drop with multiple Components is not applicable for all operations....
you’ll get an error when it’s not appropriate to use multiples.

27
 Features Using Drag and Drop
Add a Compile Relationship
Drag one Component from a Catalog Explorer onto a different Component
in the same or another Catalog Explorer.

Add a Component Requisite

Drag one Component from a Catalog Explorer onto a different Component
in the same or another Catalog Explorer.

Add a Release Requisite

Drag one Release from a Release Explorer onto a different Release in the
same or another Release Explorer.

Add a Reference
Drag a Component from a Catalog Explorer to a version of the target
Component in a List Versions window.

Rules - Add Step

Drag the corresponding Object Component from the \TANDEM Group onto
the Processor field in the Rule Step window.

Link to a Group or Object

Drag one or more Components from a Catalog Explorer onto a Group or
Object in the same or another Catalog Explorer.

Link a Component to a Release

Drag one or more Components from a Catalog Explorer onto a Release in a
Release Explorer

Link a Component to a UserChange

Drag one or more Components from a Catalog Explorer onto a UserChange
in a UserChange Explorer.

Link a Release to a UserChange

Drag a Release from a Release Explorer onto a UserChange in a UserChange
Explorer.

28
Link a Component Version to a Release
From a Catalog Explorer, select a Component and list its versions. Then drag
the desired version onto a Release in a Release Explorer.

Link a Component Version to a UserChange

From a Catalog Explorer, select a Component and list its versions. Then drag
the desired version onto a UserChange in a UserChange Explorer.

Unlink From a Group or Object

Drag one or more Components to the Unlink folder in the same Catalog
Explorer.

Unlink a Component From a Release

Drag one or more Components from a Release Explorer to the Unlink folder
in the same Release Explorer.

Include a UserChange
Drag a UserChange from a UserChange Explorer to a Release in a Release
Explorer window.

Add a License
From a Release Explorer, drag a Release onto a Location in a Location
Explorer. You will be prompted for additional information.

Acquire a Release or Manifest

Drag a Release from a Release Explorer to a Location in a Location Explorer
that does not have a license (right side of window).

Install a Release
Drag a Release from a Release Explorer to a Location in a Location Explorer
that already has a license (right side of window).

Distribute a Release
Drag a Release from a Release Explorer to a Location in a Location Explorer
that already has a license (right side of window).

29
 User Options
Favorite Paths
PrimeCode allows you to save the list of Paths you have visited in a given
session. The Favorite Paths Menu appears on the Main window’s Menu Bar
when any of the Explorer windows have focus. Favorite Paths can also be
accessed on the Explorer window by right-clicking on the “Go To” button
next to the Path field.
u To Save your current set of Paths, select Save PathSet from
the Favorite Paths Menu. The Select PathSet window will
appear. Type a name for the PathSet and click OK. The
Saved PathSet name will appear on the list at the top of the
window.
u To Load a previously-saved PathSet, select Load PathSet
from the Favorite Paths Menu. The Select PathSet window
will appear. Select the PathSet you want to load from the list,
and click OK.
u To Edit a previously-saved PathSet, select it from the list and
click Edit. The saved PathSet will be displayed in a Notepad
window for you to edit. Close the Notepad window. If any
changes are detected, you will be asked if you want to save
the changes. Click Yes to save.
u To Delete a previously-saved PathSet, select it from the list,
and click Delete.

ë Saved PathSets are displayed by name on the Favorite Paths Menu, providing a
convenient way to select a PathSet to be reloaded.

ë PathSets are saved locally and are not tied to the UserID that saves them.
ë PathSets are tied to a specific Catalog and Explorer type. For example, you can’t
load a Location Explorer PathSet into a Release Explorer, or load a PathSet from
one Catalog to another. To guarantee this, the PathSet list presented at any time
is context sensitive.You will only see the PathSets appropriate for the current
Explorer in the current Catalog.

30
WorkSpace
A WorkSpace is a set of windows that are currently open. Saving a
WorkSpace stores information about which windows are open, their position
and their content. You give each saved WorkSpace a name, which allows
you to quickly and easily revert to a previously-used set of windows and
their content, simply by selecting the WorkSpace name from a Menu.
u To Save your WorkSpace, select Save WorkSpace from the
File Menu on the Main window Menu Bar. A list of currently
open windows and Paths will be displayed. Verify that the list
is correct and click Yes to save. The Select WorkSpace
window is displayed. Name the WorkSpace in the “Save
WorkSpace as” field, or overwrite an existing WorkSpace by
selecting it from the list, then click OK.

ë Due to the context sensitive/dependent nature of the Right-Click Menus and Drag
and Drop operations, it is sometimes not possible to reload certain combinations
of windows/contents out of context. PrimeCode will detect this type of situation
when you try to save the WorkSpace.The Save Verification list will show which
windows cannot be saved and give an explanation. You can then choose whether
or not to proceed.

ë A WorkSpace is saved locally and is not tied to the UserID that saved it.
u To Load a saved WorkSpace, select Load WorkSpace from
the File Menu, then select the WorkSpace from the displayed
list. You can also simply select it by name directly from the
File Menu.
u To Delete a WorkSpace, select it from the list and click
Delete.

31
 User Profiles
User Profiles can be configured to provide additional information about a
user, restrict user access, and set user defaults. Refer to the PrimeCode/Core
manual for detailed information about this feature.

The User Profile window can be selected from the Functions Menu under
Administer. The window has two tabs allowing you to select either the
General or Search Subvolumes panes which are described later. You can
select each option pane by clicking on the appropriate tab. After you have
made your changes click Apply or OK. Click Cancel at any time if you don’t
want to apply the changes you selected.
General Options

Login Restrictions

Allows the Administrator to control the period of time when a certain user
can log in to PrimeCode. The Administrator can also prevent that user from
logging in at all. From here, a user’s Login privileges can be suspended or
activated, and the Login timeout can be set.

User Preferences

Allows the Administrator to tailor which screen PrimeCode will start with,
as well as specify the Release and Component Paths.

32
 Search Subvolume Options

Here is the User Profile window showing the Search Subvolumes pane. It is
used to specify the search subvolumes you will be using:

ë User Profiles are optional, but if used can be secured to allow Add/Modify/Delete
privileges. Contact your Security or System Administrator for information about
how this feature is being used at your site.

Options Window
The Options window can be displayed from the View Menu on the Main
window Menu Bar. The window has two tabs allowing you to select either
the General or Communications pane which are described later. You can
select each option pane by clicking on the appropriate tab. After you have
made your changes, click Apply or OK. Click Cancel at any time if you
don’t want to apply the changes you selected.

33
 General Options

Session Inactivity Lock

PrimeCode provides a configurable Session Inactivity Lock which requires

you to log in again, if there has been no activity for a specified period of
time. From this window, you can change the length of time for the timeout,
within the limits set in your User Profile. For example, if your User Profile
specifies a timeout value of 30 minutes, you can change this value to 1-30
minutes, but can’t change it to anything greater than 30 minutes. When the
timeout occurs, a Login window will be displayed. Simply enter your
password and click Login.

ë PrimeCode does not require the use of User Profiles. Each site can choose
if/how they want to implement this feature. User Profiles can be secured for
add/modify/delete privileges. The Session Inactivity Lock is activated only if you
have set a timeout in the Option window or if you have a User Profile.
Configuration of these options will be site specific. Contact your Security or
System Administrator to determine how this feature has been implemented at
your site. See the PrimeCode/Core manual for detailed information on User
Profiles.

Preferred Text Editor

PrimeCode allows you to choose the text editor you wish to use to display
the output from Browse, Merge and Scan commands if they are directed to a
PC disk file. Either type the Path of the editor you wish to use, or click the
Browse button to navigate to the editor on your hard drive.

34
Communications Options

This window allows you to view or modify the communications options that
were originally configured during the installation. Changes made will not
take place until you click either the Apply or OK button. You can click
Cancel at any time, and changes you have made will not be applied or saved.
Refer to the PrimeCode Installation manual for detailed information on
PrimeCode communications options, or contact your System Administrator
for site-specific information.

ë At times the Apply and OK buttons will disappear when you clear the information
in the Process Name or Communicate via Expand Node fields. This is because
you must press the appropriate Add or Modify buttons next to the Process Name
or Comm Node fields to register the changes you have just made in these fields.

35
 Security and Licensing
Security is enforced by graying out (deactivating) Menu items and data
fields that are denied by either the node’s license or your User Task Security
Profile. Both a valid license and the appropriate task security permissions
must be in place for you to be able to get to a function.

If the node does not have:

u a Develop license - all items (including Explorers) are grayed
out under the Functions and Navigator Develop Menus.
u a Package license - all items under the Package Menu are
grayed out.
u a Distribute license - all items under the Deploy Menu are
grayed out.
u an Acquire license - all items under the Deploy Menu are
grayed out.
u an ACP license - all items related to Approvals and Task
Security under the Configure and Policy Menus are grayed
out.

ë If you need access to any task that is grayed out, contact your Security or System
Administrator.

36
How to Get Help
There are four ways of getting help in PrimeCode:
u Tool Tips on buttons
u Status Bar
u On-line Help
u call Data Design Systems’ Customer Support line.

Tool Tips
When you position the cursor over a button, a description appears.

Tool Tips appear throughout PrimeCode on all windows.

Status Bar
When you hold the cursor over an icon or data entry field, PrimeCode
displays information at the bottom of the window in the Status Bar. If the
mouse moves over a disabled or neutral area of the window, the help shown
at the bottom of the window relates to the data entry field or button that
currently has the focus.

On-line
There are three ways of accessing the On-line Help:
u On the Main window Toolbar, click on the On-line Help icon.
Help related to the active window appears.
u For help related to the screen you are currently on, press F1
and the related help topic appears.
u For general help, from the Main window select Help è
PrimeCode Help and the On-line Help appears.

Customer Support
We offer two types of support: send us an e-mail or call the numbers below.

E-mail: (support@datadesign.com)

Phone:
Regular Hours (Monday - Friday, 9 a.m. - 6 p.m. Eastern Standard time) at
(905) 677-6666

After Hours Support: (416) 626-1912.

37
 Exiting PrimeCode
There are four ways to exit PrimeCode:
u File Menu
u Main window Title Bar
u Windows Task Bar
u Pressing Alt è F4

File Menu
From the Main window, select File è Exit.

Main Window Title Bar

Click the X button on the Main window Title Bar.

Windows Task Bar

Right-click on the PrimeCode application on the Windows Task Bar and
select Close from its Pop-up menu. Select Yes.

Press Alt è F4
Press the Alt button, then press the F4 button. Select Yes.

38