Previous Topic: Major Elements of Your First JCLNext Topic: Try It Yourself!


Step 1: Define a Distribution Identifier

The first step in defining a basic report is to define a distribution identifier for the report recipient.

As you learned earlier, a distribution identifier, or DISTID, is a unique 1- to 32-character string that indicates the report recipient (the individual or location where a report is to be distributed).

Note: To issue commands quickly and easily, you can use wildcards and SPF/ISPF command stacks (if you have SPF/ISPF). For more information, see Tips for Using Commands in the chapter "Basics."

  1. On the command line of the Primary Selection Menu panel, enter D, a space, and D27SYSP4, the distribution identifier you are assigning to yourself).

    CA Deliver - Primary Selection for DELIVER.SYSTEM1 --------------------------- Command ===> D D27SYSPA A Active Display - Display selection list of active reports or bundles. B Bundle Data - Display bundle data. D Distribution Data - Display distribution data. J Job Data - Display job data. R Report Data - Display report data. Operands for A: B - Display selection list of active bundles. R - Display selection list of active reports (default). X - Limit selection list to exceptions. PREV - Display selection list for previous cycle. Operand for B,D,J,R: Omit operand for complete selection list. Specify identifier to display data. Specify generic identifier for limited selection list. L - For D only, display list of distribution lists. Enter END command to terminate this CA Deliver session.

  2. Press Enter to display the Distribution Data for Distid panel for your new distribution identifier.

    CA Deliver - Distribution Data for Distid: D27SYSP4 -------------------------- Command ===> Destination: Dest ===> CA Connect Node ===> NO ( YES or NO ) Writer ===> Class ===> Email ===> EFormat ===> WebSvr ===> Distribute to: ===> ===> ===> ===> ===> ===> ===> ===> ===>

  3. Enter the address information that you want to print on each banner page of the report to be distributed to you, as shown in the next illustration.

    Note: The address data can be 1 to 9 lines, and each line can be 1–72 characters. Lines 1 to 6 print on the banner page for the report; you can modify the banner page to contain all 9 lines.

    CA Deliver - Distribution Data for Distid: D27SYSP4 -------------------------- Command ===> Destination: Dest ===> CA Connect Node ===> NO ( YES or NO ) Writer ===> Class ===> Email ===> EFormat ===> WebSvr ===> Distribute to: ===> DEPT 27 - SYS PROG (GEORGE) ===> GEORGE JONES ===> BLDG A 32 - MS 55 A ===> TEMPLE STREET FACILITY ===> ===> ===> ===> ===>

  4. Enter END on the command line and press Enter to add and save the distribution data.

    The message DISTRIBUTION ID SAVED displays in the short message area.

  5. Enter D on the command line, and press Enter to display the Distribution Selection List panel, which contains a complete list of distribution identifiers.

    CA Deliver ------------ Distribution Selection List (1) ---------------------- Command ===> Scroll ===> PAGE Sel Distribution ID Line 1 List ==> * * * DEPARTMENT 01 PRESIDENT DEPT 01 - PRESIDENT DEPARTMENT 01 VICE PRESIDENT DEPT 01 - VICE PRESIDENT D25FILE DEPT 25 - FILE ROOM D25LIB DEPT 25 - FILE ROOM D25MGR DEPT 25 - MANAGER D25PER1 DEPT 25 - CLERK LEVEL 1 D25PER2 DEPT 25 - CLERK LEVEL 2 D27FILE DEPT 27 - FILE ROOM D27LIST DEPT 27 - DISTRIBUTION GROUP YES D27MGR DEPT 27 - MANAGER D27PROD DEPT 27 - PRODUCTION SUPERVISOR D27SYSP1 DEPT 27 - SYS PROG (BRIAN JAMES) D27SYSP2 DEPT 27 - SYS PROG (MARY BROWN) D27SYSP3 DEPT 27 - SYS PROG (BILL SMITH) D27SYSP4 DEPT 27 - SYS PROG (GEORGE JONES) D28FILE DEPT 28 - FILE ROOM D28LIB DEPT 28 - LIBRARIAN D28MGR DEPT 28 - MANAGER D29ACCT DEPT 29 - ACCOUNTANT

  6. Scan the list for your new distribution identifier D27SYSP4.

    You are now ready to verify the distribution data.

    In the SEL column, move the cursor down to your distribution identifier D27SYSP4 and enter S (for Select).

    CA Deliver ------------ Distribution Selection List (1) ---------------------- Command ===> Scroll ===> PAGE Sel Distribution ID Line 1 List ==> * * * DEPARTMENT 01 PRESIDENT DEPT 01 - PRESIDENT DEPARTMENT 01 VICE PRESIDENT DEPT 01 - VICE PRESIDENT D25FILE DEPT 25 - FILE ROOM D25LIB DEPT 25 - FILE ROOM D25MGR DEPT 25 - MANAGER D25PER1 DEPT 25 - CLERK LEVEL 1 D25PER2 DEPT 25 - CLERK LEVEL 2 D27FILE DEPT 27 - FILE ROOM D27LIST DEPT 27 - DISTRIBUTION GROUP YES D27MGR DEPT 27 - MANAGER D27PROD DEPT 27 - PRODUCTION SUPERVISOR D27SYSP1 DEPT 27 - SYS PROG (BRIAN JAMES) D27SYSP2 DEPT 27 - SYS PROG (MARY BROWN) D27SYSP3 DEPT 27 - SYS PROG (BILL SMITH) S D27SYSP4 DEPT 27 - SYS PROG (GEORGE JONES) D28FILE DEPT 28 - FILE ROOM D28LIB DEPT 28 - LIBRARIAN D28MGR DEPT 28 - MANAGER D29ACCT DEPT 29 - ACCOUNTANT

  7. Press Enter to display the Distribution Data for Distid panel.

    CA Deliver - Distribution Data for Distid: D27SYSP4 -------------------------- Command ===> Destination: Dest ===> CA Connect Node ===> NO ( YES or NO ) Writer ===> Class ===>

    Email ===>

    EFormat ===>

    WebSvr ===> Distribute to:

    ===> DEPT 27 - SYS PROG (GEORGE) ===> GEORGE JONES ===> BLDG A 32 - MS 55 A ===> TEMPLE STREET FACILITY ===> ===> ===> ===> ===>

    See Defining Basic Reports for more information.

Do the following:

  1. Scan the panel for accuracy.

    Note: To edit information on this panel, enter new information over the old information displayed and press Enter.

  2. Enter RETURN on the command line, and press Enter to display the Primary Selection Menu panel.