INGHIST

Purpose

The INGHIST command shows history information about the work item processed by the automation manager. It also lets you display messages that the manager issues to the system logger.

Parameters

REQ

Specifies the request to be performed. It can have the following keywords:

HISTORY

Displays the work item history. This is the default.

LOG

Retrieves the messages written to the system logger by the automation manager.

RESOURCE

Specifies the name of the resource to be displayed. The format is name/type[/system]. The RESOURCE parameter can only be specified if REQ=HISTORY.

START

Is the start date and, optionally, time for the display of the history data. The format is yyyy-mm-dd [hh:mm:ss]. If omitted, the history data from the last hour will be displayed, unless another limiting parameter (resource name) is specified. If you specify more than one value, they must be enclosed with parentheses, or separated by a period (.), for example:

inghist resource=stdt000an1x start=(2000-03-10 08:00:00)

or

inghist resource=stdt000an1x start=2000-03-10.08:00:00

END

Is the end date and, optionally, time for the display of the history data. The format is yyyy-mm-dd [hh:mm:ss]. If you specify more than one value, they must be enclosed with parentheses, or separated by a period (.).

MAX

Specifies the maximum number of work items to be shown. Use this parameter to limit the output if many work items exist within the specified time period.

WIMAX

Specifies the maximum number of work item records to be shown after work item expansion. The value can be * to indicate unlimited or a value to limit expansion. The default is 10000. If the report becomes truncated then the message "***OUTPUT TRUNCATED***" will appear.

OUTDSN

For information on the OUTDSN parameter, see OUTDSN Parameter.

TARGET

For information on the TARGET parameter, see TARGET Parameter.

OUTMODE

For information on the OUTMODE parameter, see OUTMODE Parameter.

Restrictions and Limitations

To use INGHIST system operations does not have to be initialized.

Usage

The INGHIST command operates sysplexwide. For an overview see Overview of Commands that Operate Sysplexwide.

Depending on the amount of history data, INGHIST can take up to minutes or hours to complete. In this case, you can filter the output by specifying the RESOURCE, START, END, MAX, or WIMAX parameters according to your needs.

Time-interval search criteria are entered in local time. However, because the history data is stored using GMT time stamps, it is necessary for INGHIST to convert the local-time search criteria to GMT before retrieving the data. This may make it necessary for the operator to make a manual adjustment to the time-interval search criteria after a daylight-saving-time change has been set. The local-time-to-GMT conversion calculation will be one hour different after a daylight-saving-time change. Data written after a daylight-saving-time change will be retrieved as expected but data written before will be offset by one hour.