PCON(1)

NAME

pcon - Print the operator console log of a given duration.

SYNOPSIS

pcon [-hjJv] [-adlmrwy*]
pcon [-hjJv] -s <yyddd hh:mm:ss>
pcon [-hjJv] -t MINUTES

-a
-*
    Print the entire console log.

-d
    Print the previous 24 hours (day) of the console log.

-h
    Print syntax help.

-j
    Print output in JSON format with this structure:
    {
        "data": {
                "content": "...",
                "content_length": 3,
                "records": 1
            },
            "program": "pcon",
            "options": "-J ",
            "rc": "0"
    }

    If the log is empty for the time frame requested, the value for
    "content" is a single space " " and "content_length" is 0.

-J
    Print JSON output in a readable format.
    This option forces -j if it was not set.

-l
    Print the previous 60 minutes (last hour) of the console log.

-m
    Print the previous 30 days (month) of the console log.

-r
    Print the previous 10 minutes (recent) of the console log.

-s
    Print the console log starting from a given Julian date (yyddd) and
    time (hh:mm:ss). If the seconds are omitted, 00 is the default.

-t
    Print the console log starting from a specified number of minutes ago.
    For example, to print the log from 45 minutes ago up to the present,
    enter 'pcon -t 45'. To print from 5.5 hours ago to the present, enter
    'pcon -t 330'.

-v
    Print verbose and debug information.

-w
    Print the previous 7 days (week) of the console log.

-y
    Print the previous 365 days (year) of the console log.

DESCRIPTION

pcon prints the operator console log to the terminal. Starting from the current time, the previous 10 minutes of the log are printed by default. Alternatively, you can specify the following options:

• A particular date and time.

• A relative duration.

• The entire log.

To specify a particular date, you must use the Julian date format, which is the day-of-year number. For example, to specify a date of February 15, use day-of-year number "046".

The console output format is described in the z/OS documentation for HCL Programming Interface Information and SYSLOG records.

NOTES

The utility pcon requires that the system maintains a SYSLOG in its JESPLEX.

EXAMPLES

Print the entire console log:

pcon -a

Print the last hour of the console log:

pcon -l

Print the last two minutes of the console log. This can be useful for systems with large amounts of log activity.

pcon -t 2

Print the console log from 22:17 on 03/23/21. This is the 82nd day of 2021.

pcon -s 21082 22:17

Print the console log from 22:17:33 on 03/23/21.

pcon -s 21082 22:17:33

EXIT VALUES

0
    pcon completed successfully.

2
    Syntax error. Correct the pcon syntax and resubmit the command.

4
    An invalid argument was specified.  Examine the error message,
    correct the argument, and resubmit the command.

8
    An error ocurred when retrieving the log information. Examine the
    error message for details.