Using the
CA Endevor
Integration for the Natural Environment

This article explains how to use the
CA Endevor
Integration for the Natural Environment.
ce18
This article explains how to use the 
CA Endevor
 Integration for the Natural Environment.
For information about the implementation of the
CA Endevor
Integration for the Natural Environment, see Implementing the
CA Endevor
Integration for the Natural Environment
.
 
2
 
 
Start a User Session
You can start 
CA Endevor® SCM
 Integration for the Natural Environment at any time to develop, manage, and control your software changes.
Follow these steps:
 
  1. Enter EINE on the command line and press Enter.
  2. Enter your user ID and password or passphrase, and press Enter. The passphrase allows 9 to 100 characters.
    The 
    CA Endevor® SCM
     Integration for the Natural Environment Main Menu opens.
  3. Select an option from the menu.
Exit a User Session
You can exit 
CA Endevor® SCM
 Integration for the Natural Environment at any time from the Main Menu by pressing PF3 or entering an option code of a period (.).
To require a password or passphrase to enter the next session, a user can override the user password timeout value by logging off using the option X on the Main Menu. After logging off on the Main Menu, the user is presented with the login screen when attempting to enter the next session, even if the timeout period has not expired.
If you have MFA PassTicket generation activated in your 
CA Endevor
 configuration and you exit 
CA Endevor
 Integration for the Natural Environment from the Main Menu by pressing PF3 or period (.), new PassTickets will be still generated for your user in the server until the timeout limit is reached. (The timeout function has a maximum limit of 12 hours, but a lower threshold limit can be configured in user exit UEXIT00.) If you press option X to log off from the Main Menu, PassTicket generation stops for your particular user.
Field Default Values
To help you more easily and accurately enter field data, default values are used. When you enter a value in an Object/Element Name, Type, Environment, System, Subsystem, Stage, FUSER, or FDIC field, that value becomes the default when the same field appears on a different screen. Using default values saves you time and ensures that the same value is used when the field appears on multiple screens. To specify a new default value for a field, enter the new value and submit your request.
Name Masking
To help you more easily find information and process requests, you can use name masking. By substituting a name with the asterisk (*) wildcard character, a character with the percent (%) sign placeholder, or by using both together, it is much faster and easier to find information and process requests.
You can use name masks for the following 
CA Endevor
 items:
  • Object/Element names
  • Environment, system, subsystem, and stage names within FROM clauses
Natural name masking conventions are honored for the Object field on the Natural Programming Object Add screen. The Natural name masking convention uses the question mark symbol (?) in place of the percent sign (%) as a placeholder character.
Wildcard (*)
Using an asterisk (*) as a wildcard character in a search string lets you find all elements or all elements that begin with the same characters you specify. You can use wildcards in the following ways:
  • When the wildcard is used as the only character of a search string, all members of the search field are returned.
  • When the wildcard is used as the last character of a search string, all members of the search field beginning with the characters in the search string preceding the wildcard are returned. For example, entering UPD*, returns all elements beginning with UPD, such as UPDATED or UPDATE.
  • You cannot use more than one wildcard in the same search string. For example, entering U*PD* would result in an error.
Placeholder (%)
Using a percent sign (%) as a placeholder character in a search string lets you represent a wildcard for one character. You can use placeholders in the following ways:
  • When the placeholder is used as the last character in a string, the search result includes all members of the search field, beginning with the characters in the search string preceding the placeholder, but which have no more characters than were used in the search string. For example, UPD% would return all elements beginning with UPD that are four characters in length such as UPD1 or UPDA.
  • More than one placeholder can be used in the same search string. For example, U%PD% would return all elements with five-character names that have the letter U as the first character and PD as the third and fourth character.
Wildcard (*) and a Placeholder (%) Usage
You can use both a wildcard and one or more placeholders within the same search string, as long as the wildcard appears at the end of the search string and is used only once. For example, a search string of U%D* would return elements with names of any length that have U as the first character, any one character as the second character, and D as the third character.
Function Keys
There are several standard function keys that can help you move through 
CA Endevor® SCM
 Integration for the Natural Environment. The following function keys are available from many screens and windows:
  •  
    ENTER (function key)
    Processes the information about a detail screen or window. Scrolls down on a summary listing screen or window.
  •  
    PF1 (function key) - Help
    Accesses screen-level help or accesses selection-list help. See the Display Online Help section for details.
  •  
    PF3 (function key) - End
    Returns to the previous logical screen. From the Main Menu, returns to Natural.
  •  
    PF6 (function key) - Top
    Scrolls to the top of a summary listing.
  •  
    PF7 (function key) - Up
    Scrolls up one page in a summary listing.
  •  
    PF8 (function key) - Down
    Scrolls down one page in a summary listing.
  •  
    PF9 (function key) - Bottom
    Scrolls to the bottom of a summary listing.
Display Online Help
You can display 
CA Endevor® SCM
 Integration for the Natural Environment online help for more information about features, fields, and so on. The following types of help are available:
  • To display value-selection list help, on any screen on which Element Type, Environment, System, Subsystem, or Stage values can be entered, enter a question mark (?) on a field and press Enter.
  • To display screen-level help, ensure that the cursor is not positioned on a value-selection field such as Element Type, Environment, System, Subsystem, or Stage; and enter a question mark (?) on a field and press Enter, or press PF1.
API Message Reports
 
CA Endevor® SCM
 Integration for the Natural Environment processes all foreground action requests by invoking the 
CA Endevor
 API. After you execute one or more foreground action requests, you will see this message at the top of the screen:
 
n
 total actions processed; press PF12 for API-message info
The message shows the total number (
n
) of actions that have been processed.
View an API Message Report
To view the report for a completed foreground action request, press PF12. A summary of all completed action requests appears, allowing you to enter any character next to an item to view its API Message report.
As you view the API Message report, you can scroll left or right using the PF10 and PF11 function keys.
For cases in which detailed tracing of the API structures is required, press PF2 (Trace) to view the content of the API control block, request block, and response block associated with the foreground action request.
Save an API Message Report
All API Message reports are automatically deleted when you return to the Foreground Processing Menu, so the PF4 (Output) option is provided to allow you to externally save an API Message report prior to its automatic deletion.
To send the API Message report to your system batch output queue, press PF4 (Output). The Batch Job Submittal window appears, allowing you to customize the job card, if job card modifications have not been restricted by the EINE Administrator. Press Enter to submit the job or press PF3 to cancel the submission. Your API Message report is written to the CMPRT01 data set of the batch job.
Main Menu Options and Processing Menu Objects
The
CA Endevor
Integration for the Natural Environment administrator can customize the
CA Endevor
Integration for the Natural Environment Main Menu to remove the Packages option, or Saved SCL Objects option, or both from the menu. The administrator can also customize the Foreground Processing Menu and Batch Processing Menu to remove the DDMs, or Predict Objects, or both from the menus.
If any of these options or objects is missing from a menu, you can contact your local
CA Endevor
Integration for the Natural Environment administrator to confirm that the administrator intentionally customized the menu.