Space banner

   

This space provides the same content as before, but the organization of the home page has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

Printing logged messages

You can print or write journal message information that is collected in the MainView Logger when you specify MVLOG=JRNL in BBPARM member BBISSPxx.

To do so, use the BBSAMP member PLOGJRNL to set up a started task.

You can schedule the started task on a regular basis such as printing all the journal messages for a specific time period to a flat file that can be retained and searched as needed.

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 to the following table which describes the additional parameters you can use with the START PLOGJRNL 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:

    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

    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.

Was this page helpful? Yes No Submitting... Thank you

Comments