How to Install the Software

Install and configure 
CA Endevor
® SCM Integration for the Natural Environment in your Natural and ADABAS environments to enable  to control application development in the Natural environment. The installation and configuration process includes the following steps:
ce18
Install and configure
CA Endevor
Integration for the Natural Environment in your Natural and ADABAS environments to enable
CA Endevor
to control application development in the Natural environment. The installation and configuration process includes the following steps:
  1. Install the
    CA Endevor
    Integration for the Natural Environment data sets on the mainframe.
  2. Install the Natural objects into the Natural environment. (Done by the Natural administrator).
  3. Install the ADABAS files into the ADABAS environment. (Done by the ADABAS administrator).
  4. Edit, assemble, and relink the NATPARM module for the Natural nucleus. (Done by the Natural administrator).
  5. Install user exits. (Done by the Natural administrator.)
  6. Create a default job card for batch jobs. (Done by the
    CA Endevor
    administrator.)
  7. Create a default
    CA Endevor
    procedure for package execution. (Done by the
    CA Endevor
    administrator).
  8. Create a
    CA Endevor
    procedure for action processing. (Done by the
    CA Endevor
    administrator).
  9. Configure a Natural Lifecycle in
    CA Endevor
    (Done by the
    CA Endevor
    administrator).
  10. Configure the
    CA Endevor
    Integration for the Natural Environment server startup and shutdown tasks. (Done by the Natural administrator.)
  11. Update C1DEFLTS -- Ensure that the
    CA Endevor
    Automated Configuration ACM control option, ASCM= is set to Y in the Defaults table (C1DEFLTS). For more information about updating the C1DEFLTS, seeDefaults Table C1DEFLTS. (Done by the
    CA Endevor
    administrator.)
Contents
2
Install the Natural Objects
Install the Natural objects and SYSERR messages in the Natural environment to enable
CA Endevor
Integration for the Natural Environment. The Natural administrator usually performs this procedure. However, if Natural Security is installed at your site, the Natural Security administrator performs step 1.
If you are upgrading from a previous version of
CA Endevor
Integration for the Natural Environment, copy the NDVJOBCD, NDVPROCP, UEXIT00, UEXIT99 (if modified), and any NAT* TEXT members that have been modified to a temporary library. All members of the EINELIB will be replaced by LOADNAT job.
If you want to run the new version simultaneously with the current version, in the LOADNAT JCL use the NEWLIBRARY option to specify a different library name other than EINELIB, such as EINEVxxx.
Follow these steps:
  1. Define the EINE application to Natural Security if the Natural Security (NSC) is installed at your site. If Natural Security is not defined, skip this step and go to step 2. Define EINE with the Predict XREF feature set to OFF, because the EINE NATLOAD data set contains no XREF data. (This step is performed by the Natural Security administrator).
    This enables Natural Security to recognize the
    CA Endevor
    Integration for the Natural Environment library and allows
    CA Endevor
    Integration for the Natural Environment processing.
  2. Execute the Natural LOADNAT JCL to load the
    CA Endevor
    Integration for the Natural Environment programs to a FUSER file. The LOADNAT JCL is provided in the JCL library. This JCL does not run
    as is
    and is provided only as a reference.
    The LOADNAT JCL loads the
    CA Endevor
    Integration for the Natural Environment programs and SYSERR messages into the EINELIB library.
    You can also use the online Object Handler utility (SYSOBJH) to load the
    CA Endevor
    Integration for the Natural Environment programs to a FUSER file. For more information about SYSOBJH, see the
    Natural Utilities Guide
    .
  3. Copy the EINE program to the FUSER SYSTEM library to enable users to initiate sessions without logging on to the main library of the integration software.
Install the ADABAS Files
To enable
CA Endevor
Integration for the Natural Environment, you must install the message queue file in ADABAS. The system profile file must be installed to store the user profile information set by the user from session to session.
Each instance of
CA Endevor
Integration for the Natural Environment must have its own unique set of files. The ADABAS administrator usually installs these files using the following procedures.
If you are upgrading from a previous release, you must delete the EINE message queue file (file 125 only) and use the LOADADA JCL to allocate and load a new message queue file.
Follow these steps:
  1. Edit the sample LOADADA JCL, provided in the JCL library, to meet your site standards. You can directly input the ADACMP data set provided in the SAGLOAD library into the ADABAS LOADADA JCL.
    If you are upgrading from a previous release, delete the LODSYS step from the LOADADA JCL. If you delete and reallocate the EINE system profile file (file 126), you lose the user profile information that is stored in the system profile file.
    Ensure the Natural transaction used to execute
    CA Endevor
    Integration for the Natural Environment can issue Adabas commands to the database where these files are installed.
  2. (Optional) Edit the LOADADA JCL to use the ADABAS Security facilities to password-protect and cipher-encrypt the files.
  3. Execute the LOADADA JCL.
    The message queue file and the system profile file are added to the ADABAS database where the
    CA Endevor
    Integration for the Natural Environment modules is installed.
Edit, Assemble, and Relink the NATPARM Module
Edit the NATPARM module for each online and batch Natural nucleus that is used by
CA Endevor
Integration for the Natural Environment. The Natural administrator usually performs this procedure.
Follow these steps:
  1. Insert a macro invocation after the last line in the NATPARM macro, but before the END statement, to support the message queue file.  Insert the following macro invocation. This keyword has this format:
    NTLFILE 125,daa,faa,password,cipher-key
    • 125
      Defines the file ID used internally by
      CA Endevor
      Integration for the Natural Environment. It does not affect any file on the database that has a file number 125.
    • daa
      Defines the ADABAS DBID of the
      CA Endevor
      Integration for the Natural Environment file.
    • faa
      Defines the file number of the
      CA Endevor
      Integration for the Natural Environment file.
    • password
      (Optional) ADABAS security password.
    • cipher-key
      (Optional) ADABAS security cipher-key.
  2. Insert a macro invocation after the last line in the NATPARM macro, but before the END statement, to support the system profile file. Insert the following macro invocation. This keyword has this format:
    NTLFILE 126,daa,faa,password,cipher-key
    • 126
      Defines the file ID used internally by
      CA Endevor
      Integration for the Natural Environment. It does not affect any file on the database that has a file number 126.
    • daa
      Defines the ADABAS DBID of the
      CA Endevor
      Integration for the Natural Environment file.
    • faa
      Defines the file number of the
      CA Endevor
      Integration for the Natural Environment file.
    • password
      (Optional) ADABAS security password.
    • cipher-key
      (Optional) ADABAS security cipher-key.
  3. If you are using local buffer pools, verify that the size of the Natural buffer pool that is used for the System Object Handler (SYSOBJH) Natural utility is set to 5120 or higher. The size of the buffer pool is set by the SIZE parameter of the TYPE=NAT NTBPI macro in the NATPARM to be used for the
    CA Endevor
    Integration for the Natural Environment server (for example, NTBPI TYPE=NAT,SEQ=0,SIZE=5120). Failure to have a large enough buffer pool can result in NAT0777 errors when you attempt to perform Add or Retrieve actions.
  4. Assemble the NATPARM module using the standard NATPARM assembly procedure, if it was modified.
    The assembly should receive a condition code of 0.
  5. Re-link the modified NATPARM modules. No modifications are required to the standard JCL used to link Natural, and no additional INCLUDE statements are needed. If necessary, recycle the CICS or COM-PLETE region to load the new Natural executable module as resident.
Install User Exits
Certain user exits supplied by Software AG are required. In addition, optional exits allow you to customize security and exit procedures.
The Natural administrator usually performs this procedure.
Follow these steps:
  1. Copy the object code of the following Natural objects from the SYSEXT library to the SYSTEM library or the EINELIB library (in the Natural environment in which
    CA Endevor
    Integration for the Natural Environment was loaded). The following Software AG supplied user exits are required and must reside in the SYSTEM library or the EINELIB library:
    USR0050N USR0210N USR0320N USR0420N USR1023N
    USR1033N USR1043N USR1051N USR1054N USR1055N
    USR1056N USR1057N USR2004N USR2014N USR2018N
    USR2019N USR2027N USR3013N
    USR1051N is the interface subprogram for Predict. If Predict is not installed, skip USR1051N and continue to copy the remaining USR subprograms.
  2. (Optional) Modify the initialization exit. The
    CA Endevor
    Integration for the Natural Environment initialization exit (UEXIT00) is used to control configuration options for the EINE Natural application. The initialization exit is invoked (by fetch) immediately after the invocation of a
    CA Endevor
    Integration for the Natural Environment session from the Natural command prompt.
    Modify UEXIT00 by logging on to the EINELIB Natural library, update UEXIT00 to your site requirements, and issue a STOW command. Once the modifications are complete and the exit STOWed, the EINE Servers must be shut down and restarted.
    If you are upgrading from a previous release and saved your current UEXIT00 to a temporary Natural library, you can use it as a model for updating UEXIT00.
    You can make the following changes to UEXIT00:
    1. Add security checks to allow the session to be terminated from within the user-exit module.
    2. Change the values for the following variables if you want to change the default values:
      +UEXIT00-RJE-GEN-USERID-PASSWORD
      Defines the logical variable that is used to tell EINE whether to include USERID= and PASSWORD= as part of the job card for jobs submitted using RJE. PASSWORD= may be your password or passphrase depending on what you have specified.
      Valid values are TRUE or FALSE. The default is TRUE.
      +EINE-TIMEOUT-INTERVAL-SERVER
      Defines the wait time limit for the server to begin to process a request. The server is allowed to begin to process a queued request before it returns control to the user in a particular number of seconds. The user may wait for the request or return to EINE. Timeouts for this value can indicate that more servers may be required.
      Valid values are 10 to 180 seconds. If the value is set outside this range, the default is used. The default is 30 seconds.
      +EINE-TIMEOUT-INTERVAL-API
      Defines the wait time limit that the API has to process a request from the server. This is the time in seconds that the API gets to process a request before returning control to the user. The user may wait for the request to complete or return to EINE.
      Valid values are 10 to 180 seconds. If the value is set outside this range, the default is used. The default is 30 seconds.
      +EINE-TIMEOUT-INTERVAL-PWD
      Defines the timeout interval for user passwords or passphrases. A zero value causes a prompt for a password or passphrase to occur for every login attempt. If the value is greater than zero, the user is not prompted to reenter a password or passphrase for each new session until the timeout interval has expired. The encrypted password or passphrase is stored in the User Profile record and is used with the user ID to verify access to EINE. If the login attempt fails, the login window reopens.
      Valid values are 0 to 999999. The value is defined in minutes (1440 = one day, 10080 = one week, 525600 = one year). The default is zero (0), which forces the user to log in every time upon entering EINE.
      +EINE-TIMEOUT-INTERVAL-PTK
      Defines the timeout interval for generating PassTickets in the server, starting at the time that the user introduces the user ID and password or passphrase to access EINE. A zero value causes the PassTicket to never be generated in the server. If the value is greater than zero, new PassTickets are generated until the timeout interval has expired.
      Valid values are 0 to 999999. The value is defined in minutes (1440 = one day, 10080 = one week, 525600 = one year). The default and maximum allowed time by the server is 12 hours (720). We recommend configuring this variable with a time of more than 10 minutes because PassTickets are refreshed every five minutes. If a value of more than 12 hours is configured, this value is ignored and set automatically to 720 minutes. PassTicket generation can be finished for a particular user if X option is used to log off from the EINE Main Menu.
      +EINE-CLEANUP-LATENCY-MINUTES
      Defines the time in minutes after which a request that is found on the message queue file is deleted.
      Any positive value is valid. The default is 240 minutes (four hours).
      +EINE-MAX-ADD-RETRIEVE-PER-JOB
      Defines the maximum number of Add or Retrieve actions to be processed by one batch job that is submitted by the EINE application. If more than this number is requested, multiple jobs are submitted.
      Valid values are 1 to 240. The default is 240.
      +EINE-STARTUP-CMD
      Defines the name of the EINE program that is used to startup the EINE application.
      The default is EINE.
      +EINE-INSTALL-LIBRARY
      Defines the name of the Natural library into which the EINE executables have been installed.
      The default is EINELIB.
      +EINE-INSTALL-SITESYM-SUFFIX
      Defines the suffix of the EINE site symbol variable set in the Endevor Site Symbol Table that identifies the location where the EINE application (EINELIB) is installed.
      The default is blank. If the default value is used, then the variables that are specified for the action request are used for the location of the EINE application.
      +EINE-SCL-LIBRARY
      Defines the name of the Natural library into which an SCL Text Object is saved.
      The default is EINESCL.
      +EINE-SYSTRANS-SYSOBJH
      Defines the Natural utility program that is used to load and unload Natural objects from Natural libraries. Valid values are:
      O
      — Specifies SYSOBJH Internal format which includes the Natural line numbers when the Natural object is unloaded and stored in
      CA Endevor
      metadata files. However, the line numbers in the unloaded source are in an unreadable hex format. When you include the Natural line numbers in the unloaded source,
      CA Endevor
      marks each line as changed, when only the line number changed as a result of lines being inserted or deleted and the line numbers in the Natural object were automatically resequenced by the Natural editor. This is the default.
      F
      — Specifies SYSOBJH Transfer format which does not include the Natural line numbers when the Natural object is unloaded and stored in
      CA Endevor
      metadata files.
      I
      — Specifies SYSOBJH TRANSFER INCLUDE-LINE-NUMBERS, which includes the Natural line numbers in a readable format when the Natural object is unloaded and stored in
      CA Endevor
      metadata files. When you include the Natural line numbers in the unloaded source,
      CA Endevor
      marks each line as changed when only the line number changes as a result of lines being inserted or deleted and the line numbers in the Natural object were automatically resequenced by the Natural editor.
      Do
      not
      change the
      CA Endevor
      Compare From start position in the Type definitions to exclude the line numbers. If the line numbers are excluded from the compare, the lines are not updated in
      CA Endevor
      when only the line number changes. Then when the Natural object is retrieved and reloaded to the Natural library, the old line numbers are used and this results in catalogue and STOW errors. This can have catastrophic results if line number refer backs are used in the Natural source statements and the connection between the refer back line number and the line it is referring to is broken. These connections must be rebuilt manually.
      IS
      -- Specifies SYSOBJH TRANSFER INCL SUBST, which includes both the INCLUDE-LINE-NUMBERS and SUBSTITUTE keywords. The Natural line numbers are included and Natural line number refer backs are converted to labels when the Natural object is unloaded and stored in
      CA Endevor
      metadata files.
      L
      — Specifies SYSOBJH Transfer USE-LINE-NUMBER-INCREMENT, which works the same as the Transfer option, F, except that the USE-LINE-NUMBER-INCREMENT keyword is specified in the Transfer clause. The USE-LINE-NUMBER-INCREMENT keyword causes the line number increment to be unloaded with the Natural object during the SYSOBJH unload process. If the line number increment is unloaded with the Natural object, it is used to rebuild the line numbers of the Natural source object during the SYSOBJH load process.
      The USE-LINE-NUMBER-INCREMENT option is only available with Natural 8.2.3 SP07 or higher.
      S
      — Specifies SYSOBJH TRANSFER SUBSTITUTE, which does not include the Natural line numbers when the Natural object is unloaded and stored in
      CA Endevor
      metadata files. It also replaces a Natural line number refer back with a label and inserts the label on the line that is referred to when the Natural source is unloaded thus eliminating the four-digit line number refer backs in Natural source statements
      .
        Do
      not
      change the
      CA Endevor
      Compare From starting position in the Type definitions to exclude the line numbers. If the line numbers are excluded from the compare, the lines are not updated in
      CA Endevor
      when only the line number changes. Then when the Natural object is retrieved and reloaded to the Natural library, the old line numbers are used resulting in catalogue and STOW errors. This can have catastrophic results if line number refer backs are used in the Natural source statements and the connection between the refer back line number and the line it is referring to is broken. These connections must be rebuilt manually.
      LS
      — Specifies SYSOBJH TRANSFER USE-LNI SUBST, which includes the USE-LINE-NUMBER-INCREMENT and SUBSTITUTE keywords. The line number increment is unloaded with the Natural object and Natural line number refer backs are converted to labels when the Natural object is unloaded and stored in
      CA Endevor
      metadata files. (Only available with Natural 8.2.3 SP7 and higher.)
      T
      — Specifies SYSTRANS. The value T for the SYSTRANS utility is no longer supported in Natural v8.2 and higher. If you are currently using SYSTRANS, switch to the SYSOBJH Transfer format.
      For more information about how the +EINE-SYSTRANS-SYSOBJH setting affects line numbering, see the example at the end of this topic.
      +EINE-RESTRICT-JOBCARDS
      Determines if the Job Cards presented in the Batch Submittal window can be modified or not. Valid values are 'Y' and 'N'. The default is N.
      +EINE-LOGON-EXIT-ENABLED
      Used to determine whether the EINE Logon exit, UEXIT01, is enabled or not. If +EINE-LOGON-EXIT-ENABLED is enabled (set to Y ), then UEXIT01 is FETCHed during the EINE logon process. Sites can use UEXIT01 to perform any custom logon processing necessary. Valid values are 'Y' and 'N'. The default is N.
      +EINE-DSPLY-MENU-PACKAGES
      Determines if the Packages Option is displayed on the EINE Main menu. Valid values are Y or N. The default is Y.
      +EINE-DSPLY-MENU-SAVEDSCL
      Determines if the Saved SCL Option is displayed on the EINE Main menu. Valid values are Y or N. The default is Y.
      +EINE-DSPLY-MENU-DDM
      Determines if the DDM Option is displayed on the Foreground and Batch Processing Menus. Valid values are Y or N. The default is Y.
      +EINE-DSPLY-MENU-PREDICT
      Determines if the Predict Option is displayed on the Foreground and Batch Processing Menus. Valid values are Y or N. The default is Y.
      +EINE-DFLT-SIGNOUT
      Defines the initial default Signout Element action option value for Retrieve actions. Valid values are Y or N. The default is N.
      +EINE-DFLT-REPLACE
      Defines the initial default Replace if Present action option value for Retrieve actions. Valid values are Y or N. The default is Y.
      +EINE-DFLT-GENERATE
      Defines the initial default Generate Element action option value for Add and Transfer actions. Valid values are Y or N. The default is Y.
      +EINE-DFLT-UPDATE
      Defines the initial default Update if Present action option value for Add actions. Valid values are Y or N. The default is Y.
      +EINE-DFLT-W-HIST
      Defines the initial default With History action option value for Move and Transfer actions. Valid values are Y or N. The default is N.
      +EINE-DFLT-RET-SIGNOUT
      Defines the initial default Retain Signout action option value for Move and Transfer actions. Valid values are Y or N. The default is N.
      +EINE-DFLT-ACK-JUMP
      Defines the initial default Acknowledge Jump action option value for Move actions. Valid values are Y or N. The default is N.
      +EINE-DFLT-DEL-FROM
      Defines the initial default Delete from Element action option value for Move and Transfer actions. Valid values are Y or N. The default is Y.
      +EINE-DFLT-COPYBACK
      Defines the initial default Copyback action option value for Generate actions. Valid values are Y or N. The default is N.
        The +EINE-DFLT-
      xxxxxx
      parameters are used to establish site specific initial default values presented on the Foreground and Batch Processing screens for the
      CA Endevor
      Action Options: Signout Element, Replace if Present, Generate Element, Update if Present, With History, Retain Signout, Acknowledge Jump, Delete 'From' Element, and Copyback. If the user modifies the value of one of these Action Options on an EINE Processing screen, the user specified value is retained in the user's System Profile record. That retained value is used the next time the Action Option is presented.
      The +EINE-DFLT-EW-
      xxxx-xxxx
      parameters are used to display default values for the package Execution Window From and To dates and times when a package is being created. These fields are not edited for content. If non-numeric values are coded for the Execution Window parameters, the user will need to enter valid execution window dates and times when creating a package. Usually, there is no need to provide a value other than blank for these parameters.
      +EINE-DFLT-PKG-PROMOTION
      Defines the initial default value of the Promotion Package field on the Create Package screen. Valid values are Y or N. The default is N.
      +EINE-DFLT-PKG-BACKOUT
      Defines the initial default value of the Enable Backout field on the Create Package screen. Valid values are Y or N. The default is N.
      IS
      –- Specifies SYSOBJH TRANSFER INCL SUBST, which includes the INCLUDE-LINE-NUMBERS and SUBSTITUTE keywords. The Natural line numbers are included and Natural line number refer backs are converted to labels when the Natural object is unloaded and stored in
      CA Endevor
      metadata files.
  3. (Optional) Enable the
    CA Endevor
    Integration for the Natural Environment login exit, UEXIT01, to customize any site-specific  login procedures. UEXIT01 is called during the online session initialization and login process. The exit is invoked after the user has logged on and their credentials have been authenticated, UEXIT00 has been initialized and validated, and the Site Symbolics processing has completed. Use UEXIT01 to do the following:
    • Perform customized logon validation
    • Customize the job cards that are presented in the Batch Job
    • Customize the job cards that are presented in the Batch Job Submittal window specifically for the user logging on
      The UEXIT00 +EINE-RESTRICT-JOBCARDS parameter can be used with this option to prevent user modification of the job cards presented in the Batch Job Submittal window.
    • Abort a logon attempt
      To enable UEXIT01, the UEXIT00 +EINE-LOGON-EXIT-ENABLED parameter must be set to Y. You must provide and write the logon processing logic for UEXIT01 and STOW the UEXIT01 exit in the EINE install library. The exit contains the following fields. Edit the fields as appropriate for your site.
    • Input fields
      • +UEXIT01-ENDEVOR-USER
        Contains a copy of the
        CA Endevor
        user ID. The logged on
        CA Endevor
        user ID cannot be changed. If +UEXIT01-ENDEVOR-USER is changed in the exit, the modification is ignored.
    • Input/Output fields
      • +UEXIT01-BATCH-JOBCARD
        Contains a copy of the four job card records read from the EINE System Profile file for the user that is logged on. These job card records can be modified by the exit. If the return code is set to a 4, the user System Profile record is updated with the job card records. The user can view the records in the Batch Job Submittal window.
    • Output fields
      • +UEXIT01-RETURN-CODE
        Specifies the action for EINE when it returns to the main login process.
      • +UEXIT01-MESSAGE
        Specifies up to four text message lines that display on the UEXIT01 Abort Logon screen when the Return Code is set to 12.
      • UEXIT01 Return Codes
        Specifies the action that the exit will perform based on the return code received. Valid return codes for this exit are listed next. Place the appropriate code in the +UEXIT01-RETURN-CODE Independent variable field before you submit a return.
        0
        -- No updates made; proceed with logon.
        4
        -- Modifications made, update the job card records in the user's System Profile record, and proceed with logon.
        12
        -- Error; abort user logon.
        Any other value is treated as a Return Code 0.
    4. (Optional) Modify the
    CA Endevor
    Integration for the Natural Environment termination exit (UEXIT99) to add alternate or additional site-specific exit procedures. The termination exit, UEXIT99, is invoked (by fetch) when a user exits a session. By default, this user-exit program stacks a return command to provide for the user to be returned to the library from which the session originated.
    Modify UEXIT99 by logging on to the EINELIB Natural library, update UEXIT99 to your site requirements, and issue a STOW command. Once the modifications are complete and the exit STOWed, the EINE Servers must be shutdown and restarted.
Example: Initialization Exit UEXIT00 Variable EINE SYSTRAN SYSOBJH Settings
When the initialization exit, UEXIT00, variable +EINE-SYSTRAN-SYSOBJH is set to O, Natural objects are unloaded in the SYSOBJH Internal format. The internal format includes the line numbers in hexadecimal with the unloaded objects. This causes
CA Endevor
to identify lines as changed when only the line number changed as a result of lines being inserted or delete and the line numbers in the Natural object are automatically re-sequenced by the Natural editor. In this example, only the line in bold font was actually changed, but all lines thereafter are marked with a percent sign (%) to indicate that these lines changed also.
+0100 ??* MAINTENANCE HISTORY: +0100 ? * +0100 ?&* DATE WHO WHAT +0100 ?-* ------- --- ------------------------------------------ +0100 ?ø* 15MAR88 RSC +0100 ?Ø* 02MAY89 RSC CHANGED P6.5 FMTS TO P8.3 +0100 ?°* 16JUN98 JCH MODIFY FOR 4 DIGIT YEAR +0100 ? * 14MAR01 JCH INCREASE NAT-PGMID TO 22 BYTES
%+0101 ??* 12AUG13 JAA INSERTING TEST COMMENT LINE ONLY
%+0101 ??********************************************************* %+0101 ??* %+0101 ? DEFINE DATA %+0101 ?& GLOBAL USING HIST-GDA %+0101 ?-END-DEFINE %+0101 ?ø*
When the UEXIT00 variable +EINE-SYSTRAN-SYSOBJH is set to F or S, Natural objects are unloaded with the SYSOBJH Transfer option. The transfer option does not include line numbers with the unloaded objects regardless if the SUBSTITUTE keyword is specified or not specified. Only the lines of Natural code that actually changed are identified as changed by
CA Endevor
. In this example, only the line in bold font was actually changed and it is the only line marked with a percent sign (%) to indicate the line changed.
+0100 *S*** MAINTENANCE HISTORY: +0100 *S*** +0100 *S*** DATE WHO WHAT +0100 *S*** ------- --- -------------------------------------- +0100 *S*** 15MAR88 RSC +0100 *S*** 02MAY89 RSC CHANGED P6.5 FMTS TO P8.3 +0100 *S*** 18JUN98 JCH MODIFY FOR 4 DIGIT YEAR +0100 *S*** 14MAR01 JCH INCREASE NAT-PGMID TO 22 BYTES
%+0101 *S*** 14AUG13 JAA ADDED THIS COMMENT LINE ONLY
+0100 *S******************************************************* +0100 *S*** +0100 *S*** THIS VERSION READS ALL NATL RECORDS WITHIN A TIME +0100 *S*** REJECTS THOSE NOT NEEDED, DOES A -SORT- TO GET THE +0100 *S*** RECORDS INTO PGM SEQUENCE, THEN SUMMARIZES THE REC +0100 *S*** EACH NATURAL PROGRAM. +0100 *S***
When the UEXIT00 variable +EINE-SYSTRAN-SYSOBJH is set to
L or LS
, Natural objects are unloaded with the SYSOBJH Transfer option with the USE-LINE-NUMBER-INCREMENT keyword. The TRANSFER USE-LINE-NUMBER-INCREMENT (L) option has the same behavior in
CA Endevor
as the Transfer option (F) where the line numbers are not included in the unloaded source regardless if the SUBSTITUTE keyword is specified or not specified, so that only the lines of Natural code that actually changed are identified as changed by
CA Endevor
. The difference is that the TRANSFER USE-LINE-NUMBER-INCREMENT (L) option includes the line number increment with the object when it is unloaded and then the line number increment is used to rebuild the line numbers of the Natural object during the SYSOBJH load process.
When the UEXIT00 variable +EINE-SYSTRAN-SYSOBJH is set to
I
or
IS
, Natural objects are unloaded with the SYSOBJH Transfer INCLUDE-LINE-NUMBERS option. The transfer option with INCLUDE-LINE-NUMBERS keyword includes the line numbers with the unloaded objects regardless if the SUBSTITUTE keyword is specified or not specified. This causes
CA Endevor
to identify lines as changed when only the line number changed as a result of lines being inserted or delete and the line numbers in the Natural object are automatically resequenced by the Natural editor.  In this example, only the line in bold font was actually changed, but all lines thereafter are marked with a percent sign (%) to indicate that these lines changed also.
+0100 *S**0080* MAINTENANCE HISTORY: +0100 *S**0090* +0100 *S**0100* DATE WHO WHAT +0100 *S**0110* ------- --- -------------------------------------- +0100 *S**0120* 15MAR88 RSC +0100 *S**0130* 02MAY89 RSC CHANGED P6.5 FMTS TO P8.3 +0100 *S**0140* 18JUN98 JCH MODIFY FOR 4 DIGIT YEAR +0100 *S**0150* 14MAR01 JCH INCREASE NAT-PGMID TO 22 BYTES
%+0101 *S**0160* 24MAR15 JAA ADDED THIS COMMENT LINE ONLY
%+0101 *S**0170***************************************************** %+0101 *S**0180* %+0101 *S**0190* THIS VERSION READS ALL NATL RECORDS WITHIN A TIME %+0101 *S**0200* REJECTS THOSE NOT NEEDED, DOES A -SORT- TO GET THE %+0101 *S**0210* RECORDS INTO PGM SEQUENCE, THEN SUMMARIZES THE REC %+0101 *S**0220* EACH NATURAL PROGRAM. %+0101 *S**0230*
Create a Default Job Card for Batch Requests
You can create a default job card for initial display in the Batch Job Submittal window. After a user modifies the job card information, it is retained in the system profile file for that user.
If you upgrade from a previous release and saved your NDVJOBCD to a temporary Natural library, you can use it as a model to update NDVJOBCD.
Follow these steps:
  1. Log on to the EINELIB Natural library.
  2. Modify the text module NDVJOBCD to make it consistent with your general site standards for a job card layout. Include up to four lines as the default job card used when you submit batch jobs from
    CA Endevor
    Integration for the Natural Environment.
    NDVJOBCD contains the values #USERID, #USER7, or both. #USERID is automatically replaced with the submitting user’s user ID, which is the Natural system variable *USER. #USERID7 is automatically replaced with the first 7 characters of the submitting user ID. Within the default job-card layout, these substitution values #USERID and #USER7 may optionally be followed by a period.
    The default job card is read from the first three lines of the text module NDVJOBCD.
  3. Save the text module. When you submit batch requests, the text module NDVJOBCD is used as the default job card.
Create a Default
CA Endevor
Procedure for Package Execution
This
CA Endevor
procedure is used to build the JCL required for package execution.
If you are upgrading from a previous release and saved your NDVPROCP to a temporary Natural library, you can use it as a model for updating NDVPROCP.
Follow these steps:
  1. Log on to the EINELIB Natural library.
  2. Modify the text module NDVPROCP to make it consistent with your general site standards for a package execution and save the text module.
    The text module NDVPROCP is available to build default JCL for package execution.
Create a
CA Endevor
Procedure for Action Processing
A
CA Endevor
procedure is needed for execution of
CA Endevor
action processing. If your site has not customized this procedure, use the following steps to create the procedure.
  1. Customize the ENDEVOR procedure. A sample ENDEVOR procedure is located in the CSIQJCL library delivered with the
    CA Endevor
    files.
  2. After modification, copy it to a PROCLIB defined to JES.
  3. If you changed the ENDEVOR member name, you must update the text module NDVSTEP in the EINELIB Natural library. To do this, perform the following steps:
    1. Log on to the EINELIB Natural library.
    2. Modify the text module NDVSTEP to update the PROCNAME value in the EXEC statement to reflect the new procedure name.
    3. Save the text module.