Edit and view resource definition attributes in TOURDEVT

  1. Enter S next to one of the resource definitions in the list.

    An edit panel appears, showing the attributes of the selected resource definition.

    Figure 1. Guided tour: Viewing or editing the attributes of a resource definition
       File  Menu  Settings  Help 
     ──────────────────────────────────────────────────────────────────────────────
     Edit                             Transaction                        
     Command ===>                                                                  
     
         Transaction . : CIRP                                                    
         Group . . . . : TOURCCM                                                 
         Location  . . : CCVCICS.TOUR.DEVT.DFHCSD                                
         Change Date . : 2006/05/29 11:40:14                                     
         Description . . Default CICS IIOP Request Processor transaction           
                                                                        More:     + 
                                        Default       Alternative Values
         Program . . . . DFJIIRP  
         TWAsize . . . . 0              0             1-32767
         Profile . . . . DFHCICST       DFHCICST
         PartitionSet             
         Status  . . . . ENABLED   +    ENABLED       DISABLED
         TaskDataLoc . . ANY    +       BELOW         ANY
         TaskDataKey . . USER  +        USER          CICS
         StorageClear    NO   +         NO            YES
         Runaway . . . . SYSTEM         SYSTEM        0 500-2700000
         Shutdown  . . . DISABLED  +    DISABLED      ENABLED
         Isolate . . . . YES  +         YES           NO
         BRexit  . . . .          
     

    If you are familiar with the CEDA transaction supplied with CICS®, then you will notice that the layout of this panel is similar. However, this CICS Configuration Manager panel contains several improvements.

  2. Press the PrevPage key (F10) or the NextPage key (F11) to choose the information displayed next to each attribute:
    • Default and alternative values

      or

    • A one-line description

      or

    • Nothing (for a "cleaner-looking" panel)
  3. Move the cursor to an attribute field that is marked with a prompt sign (+), and then press the Prompt key (F4).

    A pop-up list of valid attribute values appears. Press the Cancel key (F12) to close the list.

  4. With the cursor in an attribute field, press the Help key (F1).

    A description of the attribute and its values appears in a pop-up window.

    Figure 2. Guided tour: Detailed online help for resource definition attributes and their values
                              PartitionSet - Help 
                                                                More:     + 
     PARTITIONSET( partitionset KEEP OWN ) 
     
     This attribute specifies the name of the partition set that is to be    
     the default application partition set. The name can be up to eight      
     characters in length.                                                   
     
     Acceptable characters for PARTITIONSET are: A-Z 0-9 $ @ #               
     
     If you do not specify a partition set name or either of the reserved    
     names, CICS destroys existing partitions before the first BMS output    
     to the terminal from the transaction.                                   
     
       KEEP          The transaction uses the application partition set for  
                     this terminal, whatever it may be. This option is       
                     normally used for successor transactions in a chain of  
                     pseudoconversational transactions.                      
     
       OWN           The transaction performs its own partition management.  
     
       partitionset  CICS destroys existing partitions and loads the named   
                     partition set before the first BMS output to the        
                     terminal from the transaction. (Existing partitions     
     
  5. Press the Zoom key (F6) to toggle the size of the pop-up window.
  6. Press the Cancel key (F12) to close the pop-up window.
  7. Scroll to the top of the attribute list.
  8. On the command line, enter L attribute_name

    where attribute_name is the name of a resource definition attribute, or the leading characters of an attribute name, such as Wait or Task.

    The panel scrolls to the first attribute that matches the name you specified.

  9. Press the Repeat Locate key (F5) to locate any subsequent matches.
  10. Move the cursor to the command line, press Enter, and then press the Help key (F1).

    A pop-up help window appears, describing the panel, its fields, and the commands that you can perform. (If you did not press Enter before pressing the Help key (F1), a pop-up window appears describing the previous Repeat Locate action.)

    Figure 3. Guided tour: Detailed online help for each panel
                          Transaction Edit/View - Help 
                                                                More:     + 
     The Transaction panel allows you to edit or view a CICS Transaction     
     resource definition. The mode (EDIT or VIEW) is displayed in the top    
     left-most corner of the panel. EDIT allows you to change and save       
     Transaction attribute values, whereas VIEW imposes confirmation         
     prompts to save any changes.                                            
     
     For general information regarding CICS Transaction resource             
     definitions, tab to the following topics and press HELP:                
     
       > Transaction resource definitions             
     
     The panel displays a list of attributes, grouped into categories. You   
     may scroll up and down (default is F7 and F8 respectively) to view      
     more attributes. A prompt sign (+) following an input field indicates   
     that a pop-up list of field values may be obtained via the PROMPT key   
     (default is F4). A zoom sign (>) following an input field indicates     
     that an alternative input/display panel for the field may be obtained   
     via the ZOOM key (default is F6).                                       
     
     Descriptions or sample values appear on the right of the attribute      
     value field. You may toggle between descriptions, sample values or      
     no-display using the PREV and NEXT commands (default is F10 and F11     
     
  11. Press the Forwards key (F8) to scroll down to the list of attributes in the help window.
  12. Move the cursor to an attribute name in the help window, and then press the Help key (F1).

    The pop-up help window for the attribute appears.

  13. Press the Cancel key (F12) twice to close the pop-up help windows, and return to the edit panel.
  14. Move the cursor to an attribute field that is marked with a prompt sign (+), and then enter an invalid value in that field. (For example, if the valid values for an attribute are YES or NO, enter X in that field.)

    Notice the "Invalid value" message: the panel protects you from entering invalid attribute values.

  15. Press the Help key (F1) to see an expanded message describing the valid values for this attribute.
  16. Change the attribute to a valid value.
  17. Edit some other attribute values.
  18. On the command line, enter SAVE to save these edits.