Control-D Recipient Tree

This chapter includes the following topics:

Overview

The Recipient Tree is a list of users who can receive online reports and/or printed reports. The tree is built in either a basic format or a hierarchical format, according to the requirements of your data center. Considerations on how to build your tree appear in Preparing for Production and in the Control-D and Control-V User Guide.

A sample tree, CTDTREE, has been supplied for the tutorial in this guide. This chapter has you look at the sample tree and see what users are defined.

You must submit the JCL found in member PREPGSD in the IOA INSTWORK library to prepare the Getting Started environment, as described in Before You Begin. When the job has executed successfully, you are ready to proceed.

Entering and Displaying the Recipient Tree

  1. Enter the IOA Primary Option menu (the INCONTROL products main menu), using any online environment supported by Control-D (TSO, TSO/ISPF, ROSCOE, CICS, IMS/DC, VTAM, IDMS, COM-PLETE, and so on).

    Figure 1 IOA Primary Option Menu

    Copy
    ---------------------       IOA PRIMARY OPTION MENU       ------------------
    (1)OPTION ===>                                               USER        N06  
                                                                                  
    IOA                        CONTROL-D/V                CONTROL-O            
                                                                                  
      4  COND-RES                A  MISSION STATUS         OR  RULE DEFINITION 
      5  LOG                     M  MISSION DEF            OM  MSG STATISTICS  
      6  TSO                     R  REPORT DEF             OS  RULE STATUS     
      7  MANUAL COND             T  RECIPIENT TREE         OL  AUTOMATION LOG  
      8  CALENDAR DEF            U  USER REPORTS           OA  AUTOMATION OPTS 
     IV  VARIABLE DATABASE       F  PC PACKET STATUS       OC  COSMOS STATUS   
                                DO  OBJECTS                OK  KOA RECORDER    
                                                                                  
                                                                                  
    CONTROL-M & CTM/Restart    CONTROL-M/Analyzer         CONTROL-M/Tape       
                                                                                  
      2  JOB SCHEDULE DEF       BB  BALANCING STATUS       TR  RULE DEFINITION 
      3  ACTIVE ENV.            BM  MISSION DEF            TP  POOL DEFINITION 
      C  CMEM DEFINITION        BV  DB VARIABLE DEF        TV  VAULT DEFINITION
                                BR  RULE DEFINITION        TI  INQ/UPD MEDIA DB
                                BA  RULE ACTIVITY          TC  CHECK IN EXT VOL
                                                                                  
                                                                                  
    COMMANDS:  X - EXIT, HELP, INFO  OR CHOOSE A MENU OPTION               16.20.21
  2. In the OPTION field, type T and press Enter. The IOA Recipient Tree entry panel is displayed.

    Figure 2 IOA Recipient Tree – Entry Panel

    Copy
    -------------------- IOA RECIPIENT TREE - ENTRY PANEL ----------------------(T)
     COMMAND ===>                                                                  
                                                                                   
     SPECIFY LIBRARY NAME AND MEMBER (TREE) NAME                                   
        LIBRARY ===> CTD.PROD.PARM                                                
        MEMBER  ===> CTDTREE                      BROWSE   (Y/N)                   
                                                                                   
             LEVEL 10       OPERATIONS            ===>                             
                   15       PRESIDENT             ===>                             
                   20       REGNL-MGMT            ===>                            
                   25       BRANCH                ===>                             
                   30       BRANCH-DEPT           ===>                            
                   50       DIVISION              ===>                             
                   55       DEPARTMENT            ===>                             
                   60       SECTION               ===>                             
                   80       WORKERS               ===>                             
                   90       CD-CONTROL            ===>                            
                   95       OP-USER               ===>                            
                                                                                   
                                                                                   
                                                                                   
     FOR DIRECT ACCESS, FILL IN RECIPIENT NAME IN APPROPRIATE LEVEL         11.51.41
  3. If the library name in the LIBRARY field is not the same as your Control-D PARM library name, correct it. The member name should be CTDTREE.

  4. Press Enter. The Control-D Recipient Tree screen is displayed.

    View the user list to familiarize yourself with the tree format.

    Figure 3 Control-D Recipient Tree

    Copy
    -------------------------- CONTROL-D RECIPIENT TREE ------------------------(T) 
    COMMAND ===>                                                    SCROLL===> CRSR
     LEVELS  ===> 10 Y 15 Y 20 Y 25 Y 30 Y 40 Y 50 Y 55 Y 60 Y 80 Y                
         10 CDTREE    CONTROL-D RECIPIENT TREE SAMPLE                              
             20 MGT      MANAGEMENT DEPARTMENT                                     
                       55 MKT      MARKETING DEPARTMENT                            
                       55 DEV      DEVELOPMENT DEPARTMENT                          
                       55 PROD     PRODUCTION DEPARTMENT                           
                       55 WAREHSE  WAREHOUSE                                       
               25 BR129    THE NORTH COUNTY BRANCH                                 
                 30 BR129LO  THE LOANS DEPARTMENT                                  
                 30 BR129FC  THE FOREIGN CURRENCY DEPARTMENT                       
                 30 BR129SA  THE SAVINGS DEPARTMENT                                
                       55 BMIAMI   THE FRIENDLY CONTROL-D USER                     
                             80 PRODCNTL PRODUCTION CONTROL USER                   
                             80 UNIDENT  UNIDENTIFIED REPORTS                      
                             80 NULL     IDENTIFIED REPORTS NOT NEEDED             
      ====== >>>>>>>>>>>>>>>>>>> END OF RECIPIENT TREE <<<<<<<<<<<<<<<<<<<<<< ======
                                                                                   
                                                                                   
                                                                                   
                                                                                   
                                                                                   
     OPTIONS:  D DELETE   I INSERT   S SELECT   P SEE/HIDE PARENT           12.11.50

Displaying Additional Information on Recipients

  1. Locate recipient PROD (Production Department) by using the FIND command as follows:

    1. Position the cursor at the top of the list, in the COMMAND field.

    2. Type F PROD and press Enter.

      The cursor is positioned on the word PROD in the following line:

      55 PROD PRODUCTION DEPARTMENT

  2. Position the cursor at the far left of this line.

  3. Type S and press Enter.

    The Recipient Definition screen for recipient PROD (Production Department) is displayed. At this stage, just examine the parameter fields. A detailed description of the fields appears in the Control-D and Control-V User Guide.

    Figure 4 Recipient Definition Screen

    Copy
    ----------------------- CONTROL-D RECIPIENT DEFINITION -------------------(T.S) 
    COMMAND ===>                                                    SCROLL===> CRSR
     +-----------------------------------------------------------------------------+
       RECIPIENT  PROD      RECIPIENT LEVEL 55   PARENT MGT        PARENT LEVEL 20 
       DESC       PRODUCTION DEPARTMENT                                            
       DESC                                                                        
       =========================================================================== 
       SYNONYM    PRODUCTION                                                       
       SYNONYM                                                                     
       AUTHORIZE            $SYSDATA                                               
       ADDRESS                                                                     
       =========================================================================== 
       INDEX    Y           USER BANNER Y                    REPORT BANNER Y       
       DEF DEST                                                                    
       =========================================================================== 
                              P C   P A R A M E T E R S                            
        AUTHORIZED Y                                                               
        PC PATH                                                                    
        PC RETAIN 006       (days)       MF RETAIN 006       (days)                
        MAX SIZE  00056000  (lines)      TRANSMIT FROM 0300 TO 0600  (hhmm)        
     ======= >>>>>>>>>>>> END OF RECIPIENT DEFINITION PARAMETERS <<<<<<<<<<<< ======
       
     FILL IN RECIPIENT DEFINITION.                                          12.29.20
  4. Exit the Recipient Tree facility. by pressing PF03/PF15 twice.

  5. If you made any modifications to the Recipient Tree, when exiting the Recipient Tree facility the Exit Option window is displayed. This window allows you to save or ignore any modifications made to the tree.

    Figure 5 Recipient Definition Screen - Exit

    Copy
    -------------------------- CONTROL-D RECIPIENT TREE ------------------------(T) 
    COMMAN   +-------------------------------------------------------+  LL===> CRSR
     LEVELS  |                PLEASE SELECT EXIT OPTION              |            
         10  |                                                       |            
             |   SAVE         CREATE                                 |            
             |                                                       |            
             |   CHECK Y                                             |            
             |                                                       |            
             |   LIBRARY CTD.PROD.PARM                               |            
             |   MEMBER  CTDTREE                                     |            
             |                                                       |            
             +-------------------------------------------------------+            
                 30 BR129SA  THE SAVINGS DEPARTMENT                                
                       55 BMIAMI   THE FRIENDLY CONTROL-D USER                     
                             80 PRODCNTL PRODUCTION CONTROL USER                   
                             80 UNIDENT  UNIDENTIFIED REPORTS                      
                             80 NULL     IDENTIFIED REPORTS NOT NEEDED             
      ====== >>>>>>>>>>>>>>>>>>> END OF RECIPIENT TREE <<<<<<<<<<<<<<<<<<<<<< ======
                                                                                   
                                                                                   



     OPTIONS:  D DELETE   I INSERT   S SELECT   P SEE/HIDE PARENT           12.35.14
  6. Type N in the SAVE field and press Enter.

    N stands for NO SAVE, so that the sample tree required for the tutorial is not accidentally change.

  7. Press PF03/PF15 to return to the IOA Primary Option menu.