Tabular Reports › Specify Variables › Use ID Options with Variables

Use ID Options with Variables

Use of ID options with variables lets you limit the range of the variable to a specific resource or group of resources.

To limit the range of a variable, specify an ID option and one or more identifiers following the variable. The use of ID options with variables is explained in detail in the chapter “ID Options.”

Note: Not all ID options can be used with all variables. For information about which ID options you can use with each variable class, see the description of the variable class in the chapter “Variables.”

This example uses the ID option JOBNAME to generate a single report containing information about two systems:

EACH 1 DAY
TAB DATE TRAN USE                     HDR1(-TOTAL-) HDR2(TRAN USE) AND,
         TERM RESP                    HDR1(-TOTAL-) HDR2(TERMRESP) AND,
         TRAN USE   JOBNAME(CICS1)    HDR1(-CICS1-) HDR2(TRAN USE) AND,
         TRAN USE  JOBNAME(CICS1) PCT HDR1(-CICS1-) HDR2(%USE)     AND,
         TERM RESP JOBNAME(CICS1)     HDR1(-CICS1-) HDR2(TERMRESP) AND,
         TRAN USE  JOBNAME(CICS2)     HDR1(-CICS2-) HDR2(TRAN USE) AND,
         TRAN USE  JOBNAME(CICS2) PCT HDR1(-CICS2-) HDR2(%USE)     AND,
         TERM RESP JOBNAME(CICS2)     HDR1(-CICS2-) HDR2(TERMRESP)
 END
RUN

A report like the following is generated:

-TOTAL-  -TOTAL-  -CICS1-  -CICS1-  -CICS1-  -CICS2-  -CICS2-  -CICS2-
DATE    TRAN USE TERMRESP TRAN USE   %USE   TERMRESP TRAN USE   %USE   TERMRESP
--------  -------- -------- -------- -------- -------- -------- -------- ------
02/01/08    1134    2.342      761     67.1    1.445      307     27.1    4.844
02/08/08    2067    1.047      693     33.5    0.762      723     35.0    1.221
02/08/08    1893    1.758      730     38.6    1.942      463     24.5    2.008
02/04/08    1872    1.039      790     42.2    1.126      484     25.9    0.901
02/05/08    1061    0.772      665     62.7    0.794      143     13.5    1.066
02/06/08    1297    1.526      350     27.0    1.420      271     20.9    3.054
--------  -------- -------- -------- -------- -------- -------- -------- ------
 PERIOD     9324    1.602     3989     39.8    1.443     2391     24.7    2.280
--------  -------- -------- -------- -------- -------- -------- -------- ------

Changing Column Headings

Each variable is assigned an abbreviation that is used by default as the heading for columns containing data about the variable. You can use the HDR1 and HDR2 operands to replace the top and bottom lines of the heading, respectively.

Changing headings is especially useful when you:

• Change the type of data that a variable represents (for example, from a count to a rate). For an example, see the example in RATE OPTION-Display a Rate Instead of a Count in this chapter.
• Use an ID option and identifiers to restrict the scope of a variable to particular resources, as shown in the following example.
• Shorten the column headings to gain space.

You have no restrictions on the characters used in a heading.