Editing a DELTA List

You can also mark elements for execution, add notes for the DELTA List, and view details about each element in the DELTA List.

To Edit a DELTA List

1. Go to the DELTA List Edit/Execute Entry panel.From the DELTA PLUS Main Menu, type 1 in the selection field and press Enter. The DELTA List Edit/Execute Entry panel is displayed.

2. Decide if you want to create a new DELTA List, edit a specific existing DELTA List, or choose an existing DELTA List for editing. Perform the appropriate action.

   Activity	Action
   create a new DELTA List	Type 1 in the selection field and the name of a new DELTA List in the DELTA List field.
   edit a specific existing DELTA List	Type 1 in the selection field and the name of an existing DELTA List in the DELTA List field.
   choose an existing DELTA List for editing	Type 1 in the selection field and leave the DELTA List field blank or type a masking pattern in the DELTA List field.

3. Type the data set name of the library in which the existing DELTA List resides, or where you want the new DELTA List placed, in the DELTA List library field.

4. View Profile —Type the name of the View Profile in the View Profile field; otherwise, accept the default View Profile.

   Note

   When UPF security is in effect, this field will be labeled IMSID or Group. Enter the IMSID or Group for which you intend to execute the DELTA List. The view profile used will be of the form DLAKWTnn for DELTA PLUS VIRTUAL TERMINAL or DDCKWTnn for DELTA PLUS for DBCTL, where nn is from the applicable UPF record.

   This field may not display on the panel if no View Profile data set is specified in the Global Options.

5. Press Enter.

   Previous Action	Result
   You typed 1 in the selection field and the name of a new DELTA List in the DELTA List field.	The DELTA List Edit panel is displayed, beginning a DELTA List Edit session for that DELTA List.
   You typed 1 in the selection field and the name of an existing DELTA List in the DELTA List field.	The DELTA List Edit panel is displayed, beginning a DELTA List Edit session for that DELTA List.
   You typed 1 in the selection field and left the DELTA List field blank or typed a masking pattern in the DELTA List field.	The member selection list is displayed, allowing you to select a DELTA List for editing.

6. If you are on a member selection list panel, select a DELTA List to edit by typing a / next to one of the DELTA PLUS PDS member names listed on the panel and pressing Enter. The DELTA List Edit panel is displayed.

    File  Edit  View  Sort  Options  Help                                        
   -------------------------------------------------------------------------------
   DELTA PLUS                      DELTA List Edit                 Element 1 of 7
    Command ===> ________________________________________________ Scroll ===> CSR
                                                                                  
    DELTA List . : VDS                          Sorted by: INSERT_ORDER            
   Title  . . . . ____________________________ Excluded : 0      Marked: 7        
      _ DELTA List is dependent                 Variable Definition Set . DEFAULT
    Type one or more action codes.  Then press Enter.                              
      S=Detail  D=Delete  X=Exclude R=Repeat  K=Mark    U=Unmark  E=Edit DELTA List
     I=Insert  C=Copy    M=Move    A=After   B=Before  O=Overlay N=Notes          
        M ---- Element ----  DELTA             Model/  Limiting  Fnd/  Data       
   Actn k   Type     Name    Action   Rename   Mask     IMSID    Chg   Check      
   ---- - -------- -------- -------- -------- -------- --------  ---- --------    
   ____ / APPLCTN  &NAM@    ADD      ________ ________   ____                     
   ____ / TRANSACT &NAMT    ADD      ________ ________   ____                     
   ____ / DATABASE &NAMD    ADD      ________ ________   ____                     
   ____ / RTCODE   &NAMR    ADD      ________ ________   ____                     
   ____ / TERMINAL &NAMN    ADD      ________ NODE1      ____                     
   ____ / LTERM    &NAML    ADD      ________ LTERM1     ____                     
   ____ / SUBPOOL  &NAMS    ADD      ________ SUBPL1     ____                     
    ****************************** Bottom of Data ********************************
    F1=Help    F3=Exit    F5=RFnd    F6=RChng   F7=Up      F8=Down   F12=Cancel   
   .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .  .

   Field Name	Description
   DELTA List	contains the DELTA PLUS PDS member name for the DELTA List
   Title	An optional descriptive title of up to 30 characters can be entered in the Title field. The Title field enables you to provide a description for each DELTA List as an aid in DELTA List management. With ISPF Version 2.3 or later, double-byte character set (DBCS) capable terminals (such as the IBM 5550) can edit the Title field in mixed DBCS/SBCS mode. DBCS-capable terminals can display titles that contain both IBM Kanji double-byte characters and standard characters.
   Sorted by	indicates the order by which the elements in the DELTA List are sorted. The following sort orders are available: INSERT_ORDER - Elements are sorted by the order in which they were inserted in the DELTA List. MARK - Elements are sorted with unmarked elements occurring before the marked elements. ELEMENT_TYPE - Elements are sorted by element type. ELEMENT_NAME - Elements are sorted by element name. DELTA_ACTION - Elements are sorted by DELTA action. RENAME - Elements are sorted by the name in the Rename field. MODEL/MASK - Elements are sorted by the value in the Model/Mask field. LIMITING_IMSID - Elements are sorted by the value in the Limiting IMSID field. FND/CHG - Elements are sorted by the value in the Fnd/Chg field. DATA_CHECK - Elements are sorted first by INSERT_ORDER and then by the value in the Data Check field. NOTES - Elements are sorted first by whether or not notes exist for the element and then by INSERT_ORDER. You can change the sort order by moving the cursor to the Sort menu on the action bar and pressing Enter, or by typing the SORT command on the Command line. Select the appropriate sort option. The sort order determines which action codes are available. The INSERT_ORDER sort order must be used for the I(Insert), C(Copy), M(Move), A(After), B(Before), and O(Overlay) action codes to be available.
   Excluded	indicates the number of elements excluded from view
   Marked	indicates the number of elements marked for execution. Elements not marked for execution can be bypassed at execution time by using the option Execute Marked elements only on the DELTA List Execution panel.
   DELTA List is dependent	A mark in this field designates the DELTA List and the changes contained in it as dependent. This designation ensures that all the changes must complete successfully for all the elements in the DELTA List on the target IMS system or none of the changes are applied.
   Variable Definition Set	Specify the name of the member (the Variable Definition Set) in the Variable Definition Library that contains the variable definitions for this DELTA List. The Variable Definition Sets are members that contain the definitions for the symbolic variables used by DELTA PLUS in DELTA List processing. To specify a default Variable Definition Set that will automatically be inserted into this field each time you edit a new DELTA List, enter the PREF command. Note: This value can be overridden at DELTA List execution time.
   Actn	Type one of the following action codes in this field next to one or more of the elements listed on the panel: A - After (only available when the INSERT_ORDER sort order is used) B - Before (only available when the INSERT_ORDER sort order is used) C - Copy (only available when the INSERT_ORDER sort order is used) D - Delete E - Edit the DELTA List I - Insert (only available when the INSERT_ORDER sort order is used) K - Mark M - Move (only available when the INSERT_ORDER sort order is used) O - Overlay (only available when the INSERT_ORDER sort order is used) R - Repeat S - Detail U - Unmark X - Exclude These actions are performed for the element in relation to the DELTA List. See Step 7 for more instructions on using this field.
   Mk	A / in this field indicates that the element is marked for execution. You can also select this option while editing an individual element. An asterisk in this field indicates that the element is a comment element. The remaining fields in the row contain the comment text.
   Element Type	identifies the type of the IMS system resource element in the DELTA List. Possible values are APPLCTN - application programs that run under the control of the IMS DB/DC environment TRANSACT - IMS exclusive, IMS Fast Path potential, or IMS Fast Path exclusive transactions DATABASE - a physical database that IMS manages RTCODE - route codes TERMINAL - IMSGEN-defined terminals LTERM - IMSGEN-defined LTERMs SUBPOOL - IMSGEN-defined subpools COMMAND - selected IMS operator commands DELTALST - a DELTA List nested, or embedded, in the parent DELTA List COMMENT - user comments
   Element Name	identifies the name of the IMS system resource element in the DELTA List
   DELTA Action	identifies the DELTA Action that should be taken against the associated IMS system resource element. Possible values are ADD ADD/REVISE REVISE DELETE RELOAD
   Rename	identifies the new name to which the specified element should be renamed in IMS
   Model/Mask	identifies the name of the existing element on which you want to base, or model, the selected element
   Limiting IMSID	specifies an IMSID that is used to restrict the target IMSID for a DELTA List Check or Execute. When specified, a DELTA List Check or Execute will only be allowed for IMSIDs that match this mask.
   Fnd/Chg	indicates whether the element was found with the FIND command or was changed with the CHANGE command.
   Data Check	indicates if the element contains data errors. An element with errors cannot be executed.

7.  Decide which edit action you want to perform. Perform the appropriate action.

   Activity	Action
   Copy an element within the DELTA List	Type the C action code in the Actn field next to the element that you want to copy. Use the A(after) and B(before) action codes to indicate where in the DELTA List you want the selected element to be copied. Type the A(after) or B(before) action code in the Actn field next to the element where you want the selected element to be copied before or after in the DELTA List. Press Enter. The C, A, and B action codes are only available when the INSERT_ORDER sort order is used.
   Delete an element from the DELTA List	Type the D action code in the Actn field next to the element and press Enter. DELTA PLUS delete element requests can be included in a DELTA List for databases, applications, transactions, and route codes only. When DELTA PLUS is used to delete one of these IMS elements, it does not physically remove the control block from IMS storage; instead, it sets a delete bit on in the control block, thereby making it unavailable for use. The element cannot be displayed or used with IMS; however, it remains in virtual storage. Subsequent attempts to delete these already deleted elements are ignored, no error message is generated, and delete processing continues.
   Edit a DELTA List nested within the DELTA List	Type the E action code in the Actn field next to the DELTA List and press Enter.
   Insert an element in the DELTA List	Type the I action code in the Actn field next to the element and press Enter. See Inserting-a-DELTA-List-element for more instructions. The I action code is only available when the INSERT_ORDER sort order is used.
   Mark an element for execution	Type the K action code in the Actn field next to the element and press Enter.
   Move an element within the DELTA List	Type the M action code in the Actn field next to the element that you want to move. Use the A(after) and B(before) action codes to indicate where in the DELTA List you want the selected element to be moved. Type the A(after) or B(before) action code in the Actn field next to the element where you want the selected element to be moved before or after in the DELTA List. Press Enter. The M, A, and B action codes are only available when the INSERT_ORDER sort order is used.
   Overlay another element in the DELTA List	Type the O action code in the Actn field next to the element that you want replaced. Type the C action code in the Actn field next to the element that you want to replace the other element. Press Enter. The O and C action codes are only available when the INSERT_ORDER sort order is used.
   Repeat an element within the DELTA List	Type the R action code in the Actn field next to the element and press Enter.
   View the details for an element	Type the S action code in the Actn field next to the element and press Enter.
   Unmark an element for execution	Type the U action code in the Actn field next to the element and press Enter.
   Exclude an element and its associated DELTA Action from processing when the DELTA List is executed	Type the X action code in the Actn field next to the element and press Enter.