Printing LOGJRNL records

Use the following procedure to set up a started task procedure for MainView Logger.

To create the started task procedure

  1. Copy BBSAMP member PLOGJRNL to SYS1.PROCLIB to a JES PROCLIB data set and make the following changes to the JCL in the PROC statement:
    • change PLOGJRNL to a name you want to use for the procedure

    • change the PREFIX parameter to the high-level qualifier that you used to load the product to DASD.

  2. Refer toTable 1 which describes the additional parameters you can use with the START PLOGJRNL command.

    Table 1. Valid parameters for the START command

    Parameter

    Required

    Specified as one of the following options

    Description

    SSID=

    no

    • a substitution value for the PROC statement

    • directly in the PARM= value of the JCL step card as the first positional parameter; do not include the characters 'SSID='

    specifies the SSID of the MV Logger SSID (if you do not want the default) to connect to.

    If no value is specified, the SSID of the default MainView Logger in the LPAR is used.

    STRT=

    yes

    • a substitution value for the PROC statement

    • directly in the PARM= value of the JCL step card as the second positional parameter; do not include the characters 'STRT='

    specifies the time and date where the search begins

    This parameter is required and you must enclose the value in single quotation makes if it is passed to the PROC statement from a START command. You do not need to use single quotation marks if you specify the value with the PARM statement in the JCL.

    Valid formats are as follows:

    • hh:mm:ss/yyyymmdd

    • YESTERDAY

    When you are not using the value YESTERDAY, the value you specify must be 17 characters long; for example:

    12:39:21/20111201

    16:00:00/20110305

    05:15:36/20111205

    When you specify YESTERDAY for the STRT value, the system computes yesterday's date and creates a STRT value string in the form: '00:00:00/yesterday's date'. You can use this when you want to run the job daily and dump all of 'yesterday's' data using a DURA value of 1D.

    RECS=

    no

    • a substitution value for the PROC statement

    • directly in the PARM= value of the JCL step card as the third positional parameter (do not include the characters 'RECS=')

    specifies the number of records to be printed

    Specify a numeric value between 1 to 7-numbers long between 1-9999999; for example:

    • 100

    • 10

    • 50000

    You must specify either the RECS= or the DURA= parameter.

    When you specify both RECS and DURA parameters, whichever criteria completes first will end the output. For example, if you specify RECS=100 and DURA=1D, either 100 records or 1 day of records will be output, whichever comes first.

    ORIG=

    no

    • a substitution value for the PROC statement

    • directly in the PARM= value of the JCL step card as the fourth positional parameter (do not include the characters 'ORIG=')

    specifies an origin value that is used to filter the records

    Specify a 1-8 alphanumeric value. An asterisk (*) is supported as a wild card character; for example:

    • AAODL71

    • AAODL* (any origin whose name begins with the characters AAODL)

    DURA=

    no

    • a substitution value for the PROC statement

    • directly in the PARM= value of the JCL step card as the fifth positional parameter (do not include the characters 'DURA=')

    specifies a period of time for the records to be printed

    Specify 1 to 3-digit number followed by a alphabetic value that defines the unit of time; valid alphabetic values are as follows:

    • M: minutes

    • H: hours

    • D: days

    For example:

    • to print out 10 minutes of data beginning at the time specified by the STRT parameter, specify 10M

    • to print out 1 day’s worth of data beginning at the time specified by the STRT parameter, specify 1D

    • to output 8 hours of data beginning at the time specified by the STRT parameter, specify 8H

    You must specify either the RECS= or the DURA= parameter.

    When you specify both RECS and DURA parameters, whichever criteria completes first will end the output. For example, if you specify RECS=100 and DURA=1D, either 100 records or 1 day of records will be output, whichever comes first.

This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Comments