Task history collection - MASHIST

The CICS region history collection (MASHIST) view displays information about the status of CICSPlex SM history recording for CICS regions. Support for historical task data builds upon CICSPlex SM resource monitoring. It requires monitor definitions to be installed with a monitoring resource class of MTRAN to specify the IDs of the transactions for which you wish to save historical task data. Additionally VSAM data sets must be defined and allocated to the MAS region by means of DD cards, and the desired monitoring facility parameters set.

Supplied views

To access from the main menu, click:

History views > History Views > Task history collection

Table 1. Views in the supplied MAS history (MASHIST) view set
View Notes
MAS history

EYUSTARTMASHIST.DETAILED

Detailed information about the current status of history recording for CICS regions.
MAS history

EYUSTARTMASHIST.RESUME

Resume CICSPlex SM history recording for the CICS region. If history recording for the CICS region is currently suspended, it will now resume and become active again.
MAS history

EYUSTARTMASHIST.SUSPEND

Suspend CICSPlex SM history recording for the CICS region. No further historical task records will be collected until an action is taken to resume history recording for the region.
MAS history

EYUSTARTMASHIST.TABULAR

Tabular information about the current status of history recording for CICS regions.

Actions

Table 2. Actions available for MASHIST views
Action Description
RESUME Resume CICSPlex SM history recording for the CICS region. If history recording for the CICS region is currently suspended, it will now resume and become active again.
SUSPEND Suspend CICSPlex SM history recording for the CICS region. No further historical task records will be collected until an action is taken to resume history recording for the region.

Fields

Table 3. Fields in MASHIST views
Field Attribute name Description
Current data set suffix CDSSUF The suffix of the current VSAM KSDS data set containing historical data for the CICS region
Number of records on current data set CRECCNT The number of records in the current history data set.
Number of times current data set has wrapped CWRAPCNT The number of times the current history data set has wrapped. The data set wraps when it is full.
Number of History data sets HDSCOUNT The number of history data sets available.
History reason code REASON Reason code from the historical data recorder task. Values are:
  • IOERROR - An unexpected error occurred while reading from the EYUHISTx datasets. This may be because of a problem with the file definitions, or because of a problem with a query to the CICSPlex SM EYUPARMs relating to the MAS history recorder function.
  • INVALIDFILE - One or more attributes for the EYUHISTx datasets are unacceptable for the MAS history recorder function.
  • OK - The MAS history recorder is operational.
  • NOTAVAILABLE - The MAS history recorder requires at least two EYUHISTx history datasets before becoming available for history recording.
History recorder status STATUS Identifies whether or not the historical data recorder task is in any of the following states:
  • ACTIVE - The MAS history recorder is available to record task records.
  • INACTIVE - The MAS history recorder is not available to record task records.
  • SUSPEND - The MAS history recorder has been temporarily prevented from recording task records.
  • SUSPENDING - The MAS history recorder is going into a SUSPEND status. Task records are no longer being recorded. The recorder STATUS field will change to SUSPEND when the recorder receives the next task record.
  • RESUMING - The MAS history recorder is starting to record task records again. The recorder STATUS field will change to ACTIVE when the recorder receives the next task record.
Task ID of Current Recorder TASKNO The ID of the history recorder task .


eyuabc0051.html | Timestamp icon Last updated: Sunday, 4 June 2017