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
-
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 -
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 -
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.
-
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
-
Locate recipient PROD (Production Department) by using the FIND command as follows:
-
Position the cursor at the top of the list, in the COMMAND field.
-
Type F PROD and press Enter.
The cursor is positioned on the word PROD in the following line:
55 PROD PRODUCTION DEPARTMENT
-
-
Position the cursor at the far left of this line.
-
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 -
Exit the Recipient Tree facility. by pressing PF03/PF15 twice.
-
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 -
Press PF03/PF15 to return to the IOA Primary Option menu.
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.