Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 10 Creating a Change Request : Creating a Change Request

Creating a Change Request
By creating a change request you are, in effect, requesting a new promotion. The process involves the following tasks:
You perform these activities through the Request Promotion of a Change screen.
Accessing the Request Promotion of a Change Screen
To create a change request, position your cursor beside the option Request A New Promotion on the Promotion Utility menu and press Enter. The following screen illustrates the Request Promotion of a Change screen:

 
Request Promotion of a Change
Change# : 5463 Req#'s Coreq#'s Coreq Node
Requestor : USER7 ----------- -------- ----------------
Component : MONTHLY REPORTS
Category : NEW FEATURE
PRT Option: N
Summary: This is the first implementation of this feature
Detailed Description
_ ---------------------------------------------------------------------------
_
PFKEYS: 3=SAVE INCOMPLETE 12=CANCEL 4=SUBMIT 5=SEL OBJS 6=SEL CHG REQ

 
The fields of the Request Promotion of a Change screen are described in Create or change the description of the change request below.
 
Task A Create or change the description of the change request
Overview
In this step, you identify and describe the change request.
Screen Fields Of The Request Promotion of a Change Screen
An explanation of the screen fields follows. Type information into the fields as described.
Displays the user ID of the person requesting the change. In a group rights environment, displays the current library name. This field is protected and cannot be changed.
Required field. Type in the name of the application your change request affects. For example, if you want to make changes to an application that manages employee data and you commonly call this application PERSONNEL, type PERSONNEL in this field. All values are accepted, since this field documents the change request.
Required field. Type in the category, if known. To display valid category names, press PF1. The entry in this field can be used in queries to collect change requests by a specific feature of category.
Optional field. Type in the number or code of the requirements specification1 related to the change. Use this field for documentation purposes only; no validation is performed.
Optional field. Type in the change request numbers that must precede or accompany this one. Use this field for documentation purposes only; no validation is performed.
Optional field. Type in the node name that identifies the TIBCO Object Service Broker system from which the Coreq# originates. No validation is performed.
Detailed Description

1
This can be a project number or anything else that gives a context for the existence of this Change Request.

Proceeding to the Next Step
After completing the description, you can begin identifying or consolidating objects:
For more information, refer to Identify the object types to be promoted.
For more information, refer to Consolidating Change Requests.
Task B Identify the object types to be promoted
Access the Object Promotion Utility Screen
Press PF5 to display the Object Promotion Utility screen.

 
Object Promotion Utility
Borrower: USER7 Library: USER7
 
--------------- Type S against object types & press Enter ---------------
_ RULE _ TABLE _ SCREEN _ REPORT
_ OBJECTSET _ GLOBALFIELD _ MENU _ TAGLET
_ PAGELET _ TRAN _ TAGLETFIELDMAP _ XMLDOC
_ XMLFIELDMAP _ WEBSERVICEPROD
PFKEYS: 3=EXIT 12=EXIT ENTER=SELECT 5=MANAGE RIGHTS

 
Refer to Promotions and Compound Objects for more information on how to promote compound objects.
Select an Object Type for Promotion
This screen lists the object types that can be included in a change request. Before you can identify a specific object, you must first select the object type. After selecting one or more object types, press Enter. You are then presented with the appropriate selection screen for the object type. For more information on selecting objects, refer to Chapter 11, Completion and Submission of Change Requests.
To be eligible for promotion, an object must have documentation and you or other group members must have promotion rights to it. While in the process of creating a change request, you can access objects for the purpose of adding or editing documentation.
PF Keys For the Object Promotion Utility Screen
The following PF keys are available:
Setting a Promotion Rights Filter Before Selecting Objects
The selection filter appears in the middle of the Object Promotion Utility screen. With this filter, you can further restrict the display of the objects selected by name, unit, and author. You can also input another attribute on the last line to fine tune your selection.
Accessing the Selection Filter
Press PF5 at the Object Promotion Utility screen to access the selection filter shown here:

 
Show self rights: Y Show avail rights: N Show other rights: N
+-- Selection Specification for promotion rights search --------------------+
| |
| Attribute Op Value |
| ---------------- ---- ---------------- |
| NAME ____ ________________ & |
| UNIT ____ ________ & |
| AUTHOR ____ ________ & |
| ________________ ____ ________________ |
| |
+---------------------------------------------------------------------------+

 
Fields of The Filter
Show self rights:
When set to Y, the display includes all selected objects to which the requestor holds rights. When set to N, it excludes these objects from the display.
Show avail rights:
When set to Y, the display includes all selected objects to which no one holds rights. When set to N, these objects are excluded from the display.
Show other rights:
When set to Y, the display includes all selected objects to which others hold rights. When set to N, these objects are excluded from the display.
Task C Save the incomplete change request for future completion, if necessary
Incomplete Change Requests
Pressing PF3 saves the information entered so far, including the change request description and any objects you select. For information on selecting objects to include in the change request, refer to Chapter 11, Completion and Submission of Change Requests.
The change request is saved with a status of I (incomplete). While the request is incomplete, you continue to hold the promotion rights to all objects that you included in it. You can access the request to make further changes, but with an incomplete status it cannot be promoted.
Chapter 12, Management of Change Requests describes how to manage change requests after their initial creation.

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved