Using positional parameters


When you use positional parameters, you supply values for the parameters in a predetermined order.

To find out the parameters and their order for a given view, display the view’s online Help, place the cursor on the highlighted term positional parameters, and then press Enter.

To use positional parameters example

Suppose you want to use the JFLOW view to display only those jobs that are experiencing a delay higher than 5 percent.

  1. Display the online Help for JFLOW.
  2. Hyperlink to the PARAMETERS topic by placing the cursor on the highlighted term positional parameters and pressing Enter. This topic tells you that the parameters for the JFLOW view are [Jobname =], [Delay % >], and Status. The Jobname column is in the first parameter position, Delay % > is in the second position, and Status is in the third position.Next, you want to display all active jobs with a delay higher than 5 percent.
  3. Type JFLOW * 5.An altered version of JFLOW is displayed, as shown in following figure.

    >W1 =JFLOW=============SJSCXTSM=*========DDMMMYYYY==HH:MM:SS====MVMVS====D===12
    C Jobname  JES Job  T SrvClass       Workflow %           Delay %        Main R
    - -------- Number   - --------       0.....50...100       0.....50...100 ------
      DC$SVIEW STC01250 S STCSYS                        100.0 ************** Enqueu
      CTSACS   STC01136 S STCNRM                        100.0 ************** Enqueu
      CTSACD   STC01192 S STCNRM                        100.0 ************** Enqueu
      CTSGATE  STC01199 S STCNRM                        100.0 ************** Enqueu
      BOLGBG3  TSU01285 T TSONRM     0.5                 99.5 ************** Enqueu
      I6AM2ACT STC01216 B BATNRM     0.2                 98.4 ************** Enqueu
      BSDBBJ1B STC01189 B BATNRM                         25.0 ***            Wait f
      I6ARCHIV STC01231 B BATNRM                         25.0 ***            Wait f
      MMLKXBP  TSU01233 S STCPAS    84.4 ***********     15.6 **             Wait f
      CNMPROCC STC01228 S STCLOW    35.2 ****             8.4 *              Wait f
      I6A3PASB STC01241 B BATNRM    19.2 **               6.6                Wait f
      IMS71X   STC01146 B BATNRM     8.6 *                5.0                Wait f

    Even though Delay % > is the sixth column, it was defined as the second parameter. Thus, a 5 was entered in the second position after JFLOW (JFLOW * 5).

    When you specify a value for any view parameter other than the first parameter, all preceding parameters must be accounted for by the wildcard character, * (asterisk). Therefore, an asterisk was placed in the first position. This wildcard character does not affect the view output but serves as a placeholder so that you can use the view’s positional parameters correctly.

    Important

    If a column is not defined as a parameter by default, you can make it a parameter by typing CUST on the COMMAND line, and then choosing the (Filter) and P (Parameters) options.

    For more information, type HELP CUSTOM on the command line.


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*