File Data Items

Long-Term Report Generation
Extended Time Period Reports
Year-to-Date Totals Reports

JOBSUMMARY File Data Items through FILEIODATA File Data Items describe all the file data items present in the JOBSUMMARY, STATISTICS, and FILEIODATA files. DRCDATA File Data Items describes the file data items present in the DRCDATA files.

Table 45. JOBSUMMARY File Data Items

Item

Type

Description

ACCESSCODE

string

Accesscode (without password) of the entry

AVGCORECODE

integer

Average core usage for job or task (code)

AVGCOREDATA

integer

Average core usage for job or task (data)

CARDSPUNCHED

integer

0 (zero)

CARDSREAD

integer

Number of cards read

CHARGECODE

string

Chargecode for this entry (limited to 10 characters)

CHARGES

charge

Billing charges for this entry

CODEFILE

string

Code file name for job or task

DATE

string

Date of entry in form mm/dd/yyyy

DESTMCS

integer

Destination MCS number for job or task

DESTUNIT

string

Destination unit for job or task

ELAPSEDTIME

real

Elapsed time in minutes

INITPBITS

integer

Number of initial presence bit operations (job or task only)

INITPBITTIME

real

Process time for initial presence bit operations

IOTIME

real

I/O time in seconds

JOBENTRYTIME

string

Time job entered system

JOBNO

string

Job number of entry

JOBQUEUEDTIME

real

Time job in queue

LINES

integer

Number of lines printed

LOGOFFREASON

string

Reason for log-off (session only)

LOGONREASON

string

Reason for log-on such as hello or split (session only)

LSN

string

Station number (session only). The LSN data item is always three digits long, and is padded with leading zeros if necessary.

MCSNAME

string

MCS number (session only)

MEMINTCODE

real

Memory integral for job or task (code)

MEMINTDATA

real

Memory integral for job or task (data)

MIXNO

string

Mix number of entry.

NAME

string

Job or task name. -MCS SESSION- for MCS session

ORGMCS

integer

Originating MCS number for job or task

ORGUNIT

string

Originating unit number for job or task

OTHERPBITS

integer

Number of other presence-bit operations (job or task only)

OTHERPBITTIME

real

Process time for other presence bit operations

PRIORITY

integer

Priority

PROCESSTIME

real

Processor time in seconds

QUEUE

string

Queue number. The QUEUE data item is always three digits long, and is padded with leading zeros if necessary.

STANAME

string

Station name (session only)

STARTTIME

string

Time of program initiation in the form hh:mm:ss

STOPTIME

string

Time of program termination in the form hh:mm:ss

TERMCOND

string

Termination condition for job or task

TYPE

string

J for job, T for task, and S for MCS session

USERCODE

string

Usercode

Notes:

  • String items cannot be totaled or averaged; however, all other items can.

  • LOGGER computes the ELAPSEDTIME value for RESTART MCS sessions from the LOGON and LOGOFF log records instead of using the ELAPSEDTIME value in the LOGOFF record.

  • The CHARGECODE as reported by LOGGER is limited to 10 characters. The first 10 characters are used. CHARGECODEs longer than 10 characters are truncated in the printed report.

  • LOGGER computes the USERCODE value from the Major Type 1, Minor Type 2 (EOJ) or 4 (EOT) log entry for the process.

Table 46. STATISTICS File Data Items

Item

Type

Description

DATE

string

Date of log entry in the form mm/dd/yyyy

DISK

integer

Number or disk file opens during interval

HL

integer

Number of halt/loads

JOBS

integer

Number of jobs initiated

MAXJOBS

integer

Maximum number of jobs running at one time

MAXTASKS

integer

Maximum number of tasks running at one time

MISCFILES

integer

Number of file opens not included in the other file open counts

PACK

integer

Number of pack file opens

READER

integer

Number of card reader file opens

REMOTE

integer

Number of remote file opens

SESSIONS

integer

Number of MCS sessions initiated

TAPE

integer

Number of tape file opens

TASKS

integer

Number of tasks initiated

TIME

string

Time of day in the form hh:mm:ss at the beginning of the 15-minute interval

Notes:

  • String items cannot be totaled or averaged; however, all other items can.

  • The MAXJOBS and MAXTASKS items counts are obtained by counting beginning of tasks (BOTs) and beginning of jobs (BOJs) and subtracting end of tasks (EOTs) and end of jobs (EOJs). Therefore, missing log entries cause errors in these data.

Table 47.  FILEIODATA File Data Items

Item

Type

Description

ACCESSCODE

string

Accesscode (without password) for this entry

AREASIZE

integer

Area size

ASSOCIATION

string

ASSOCIATION of file close

BLOCKSIZE

integer

Block size in words (value is rounded up if units equal characters)

BUFFERSIZE

integer

BUFFERSIZE file attribute

BUFFSOURCE

string

Buffer size source. The possible values are

  • BLOCKSIZE, indicating that the buffer size of the file was based on the BLOCKSIZE file attribute because the BUFFERSIZE file attribute is not applicable to this file.

  • BUFFERSIZE, indicating that the buffer size of the file was specified through an assignment to the BUFFERSIZE file attribute.

  • BUFFERGOAL, indicating that the buffer size of the file was based on the BUFFERGOAL memory management parameter of the SF (Set Factors) system command.

CCSVERSION

string

CCSVERSION file attribute (disk and CD files)

CHARGECODE

string

Chargecode for this entry (limited to 10 characters)

CHARGES

charge

Billing charges for this entry

CLOSETYPE

string

Type of close

CREATIONDATE

string

Creation date in mm/dd/yyyy

DENSITY

string

DENSITY file attribute

DISPOSITION

string

DISPOSITION of file close

DUMMYFILE

string

DUMMYFILE if attribute is true, otherwise blank

EXTMODE

string

EXTMODE file attribute

EXTNAME

string

External name of the file

FAMILYNAME

string

FAMILYNAME file attribute (disk files)

FILEKIND

string

FILEKIND file attribute

FILESTRUCTURE

string

FILESTRUCTURE file attribute (disk files)

FRAMESIZE

integer

FRAMESIZE file attribute

INTMODE

string

INTMODE file attribute

IOTIME

real

I/O time used in seconds

INTNAME

string

Internal name of the file

JOBNO

string

Job number of entry

KIND

string

KIND file attribute

MAXRECSIZE

integer

Maximum record size in words (value is rounded up if units equal characters).

MIXNO

string

Mix number of entry

REELNO

string

Reel number for tape files. The REELNO data item is always six digits long, and is padded with leading zeros if necessary.

RETENTION

string

SCRATCH, PERMANENT, or none

SAVEFACTOR

string

SAVEFACTOR

SERIALNO

string

Serial number

TIME

string

Time of file close as hh:mm:ss

UNITNO

string

Unit number. The UNITNO data item is always five digits long, and is padded with leading zeros if necessary.

UNITS

string

Units

Note: The UNITS item is scheduled for deimplementation in a future release. The FRAMESIZE and INTMODE items can be used instead to provide the same information.

USE

string

IN, OUT, or I/O

USERCODE

string

Usercode

Notes:

  • String items cannot be totaled or averaged; however, all other items can.

  • For information about the file attributes corresponding to FILEIODATA items, refer to the File Attributes Programming Reference Manual.

Table 48. DRCDATA File Data Items

Item

Type

Description

ACCESSCODE

string

The first of the values defined for the ACCESSCODELIST usercode attribute in the USERDATAFILE

CHARGECODE

string

Chargecode for this entry

CHARGES

charge

Billing charges for this entry

DISKINUSE

real

Disk space currently in use by the specified user on the specified pack. This value is reported in megabytes.

MBYTEDAYS

real

The disk integral value for the specified user on the specified pack. This value is reported in megabyte-days, which is the number of megabytes used multiplied by the number of days the pack is used. For example, if a user stores one megabyte on a pack for one day, the MBYTEDAYS value is one. The value is recalculated by the DRC system every time the amount of space in use by the specified user is changed.

PACKNAME

string

The family name of the disk for this entry

USEDATE

string

The date that the system last updated the DRC disk usage for this entry, in the format mm/dd/yyyy

USERCODE

string

The usercode for this DRC entry

USETIME

real

The time that the system last updated the DRC disk usage for this entry

Prev  Up  Next
Report-Specification Command Examples  Home  Long-Term Report Generation