Local files - MLOCFILE

The Monitor data for local files (MLOCFILE) views display information about monitored local files.

Supplied views

To access from the main menu, click:

Monitoring views > File monitoring views > Local files

Table 1. Views in the supplied Monitor data for local files (MLOCFILE) view set
View Notes
Monitor data for local files

EYUSTARTMLOCFILE.DETAILED

Detailed information about monitored local files.
Monitor data for local files

EYUSTARTMLOCFILE.DISCARD

Removes a local file from CICSPlex SM monitoring for the current sample interval and discards its accumulated statistics.
Monitor data for local files

EYUSTARTMLOCFILE.RESET

Resets the CICSPlex SM statistics counters associated with a local file to 0.
Monitor data for local files

EYUSTARTMLOCFILE.TABULAR

Tabular information about monitored local files.

Actions

Table 2. Actions available for MLOCFILE views
Action Description
DISCARD Removes a local file from CICSPlex SM monitoring for the current sample interval and discards its accumulated statistics.
RESET Resets the CICSPlex SM statistics counters associated with a local file to 0.

Fields

Table 3. Fields in MLOCFILE views
Field Attribute name Description
Access method ACCESSMETHOD The access method used for the file (BDAM or VSAM).
Number of WRITE requests ADDCNT The number of WRITE requests issued against the file.
Block size (BDAM only) BLOCKSIZE For BDAM files, the length of a block in bytes. If the blocks are variable-length or are undefined, the value displayed is the maximum block size.

A value of N/A means the file is not a BDAM file.

The number of READNEXT and READPREV requests BROWSECNT The number of READNEXT and READPREV requests issued against the file.
Number of browse for update requests BROWUPDCNT The number of READNEXT, READPREV, and REWRITE requests issued against the file. This is only valid for RLS files.
Rate of data I/O operations for current sample CURDEXCPRATE The rate of I/O operations for data records during the last sample period.
Rate of index I/O operations for current sample CURIEXCPRATE The rate of I/O operations for index records during the last sample period.
Request rate for current sample CURREQRATE The rate at which API requests (READ, READ UPDATE, READNEXT, READPREV, WRITE, REWRITE and DELETE) were issued against the file during the last sample period.
Number of I/O operations for data records DEXCPCNT For VSAM files, the number of I/O operations for data records.
Data set name DSNAME The 44-character name of the data set associated with the file, as defined to the access method and to the operating system.
Enabled status ENABLESTATUS Indicates whether the file is available for access by application programs. The status is one of the following:
  • ENABLED - Available for access.
  • DISABLED - Unavailable for access as a result of a SET DISABLED command.
  • DISABLING - Still being accessed after a SET DISABLED or SET CLOSED command.
  • UNENABLED - Unavailable for access as a result of a SET CLOSED command.
File ID FILE The ID of the file.
Number of READ requests GETCNT The number of READ requests issued against the file.
Number of READ UPDATE requests GETUPDCNT The number of READ UPDATE requests issued against the file.
Number of I/O operations against index component IEXCPCNT For VSAM files, the number of I/O operations for index records.
Rate of data I/O operations for monitor interval INTDEXCPRATE The average rate of I/O operations for data records over the monitor interval.
Interval ID INTERVALID The ID of the monitor interval.
Rate of index I/O operations for monitor interval INTIEXCPRATE The average rate of I/O operations for index records over the monitor interval.
Request rate for monitor interval INTREQRATE The average rate at which API requests (READ, READ UPDATE, READNEXT, READPREV, WRITE, REWRITE and DELETE) were issued against the file over the monitor interval.
Number of DELETE requests LOCDELCNT The number of DELETE requests issued against the file.
LSR Pool number LSRPOOLID For VSAM files, the number of the LSR pool associated with the file.
A value of N/A means one of the following:
  • the file is not a VSAM file
  • the file is not associated with an LSR pool
Number of active strings NUMACTSTRING The current number of requests against the file.
Number of data buffers NUMDATBUFF The number of buffers to be used for data.
Number of index buffers NUMINDEXBUFF The number of buffers to be used for the index.
Current number of string waits NUMSTRINGWT The current number of VSAM active string waits.
Data set type (base or path) OBJECT For VSAM files, indicates whether the file is related to a base data set (BASE) or is defined as a path that is accessed by means of an alternate index (PATH).
Open status OPENSTATUS Indicates whether the file is open, closed, or in transition.
Record size RECORDSIZE For fixed-length records, the actual size of a record. For variable-length records, the maximum size of a record.

A value of 0 is returned if the file is not open.

Record level sharing (RLS) request wait timeouts RLSREQWTTO The number of RLS file requests that have timed out while awaiting request completion from the VSAM RLS server.
Number of strings STRINGS For VSAM files, the number of concurrent operations that can be performed on the file.

A value of N/A means the file is not a VSAM file.

Local time file was closed TIMECLOSE The local time at which the file was closed.
Local time file was opened TIMEOPEN The local time at which the file was opened.
Total number of all requests TOTLREQCNT The total number of API requests (READ, READ UPDATE, READNEXT, READPREV, WRITE, REWRITE and DELETE) issued against the file.
Number of REWRITE requests UPDATECNT The number of REWRITE requests issued against the file.
VSAM file type VSAMTYPE Indicates how the records are organized in the data set associated with the file.

For VSAM files, the type is identified as one of the following:

  • ESDS - Entry-sequenced data set
  • KSDS - Key-sequenced data set
  • RRDS - Relative record data set

For BDAM files, the type is either KEYED or NOTKEYED.

A value of NOTAPPLIC is returned if the file is not open.

Peak number of tasks waiting for a string WSTRCCURCNT The maximum number of requests that were queued at any one time because all the strings available to the file were in use.
Total requests queued because all strings in use WSTRCNT The total number of requests that were queued because all the strings available to the file were in use.


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