ACCOUNTING

#### Search Results

Search

# ACCOUNTING

File | 34
Op-Sys | z/OS
Statement | `FIND`
Task | Read from SMF records.

## Common Fields for all Operating Systems

Dictionary Field Name | F/L | Mu | DE | Remarks
--- | --- | --- | --- | ---
`ERROR-CODE` | N3 |  |  |
`ERROR-TEXT` | A58 |  |  |
`NODE` | N5 |  | D |
`NODE-NAME` | A16 |  | D |
`ACTIVE` | A3 |  | D | Relevant with `FILE-ID='LIST'`.
`DATE` | N5 |  | D |
`DATX` | D |  | D |
`DIRECTION` | A1 |  | D |
`DSNAME` | A44 |  | D | Required unless `FILE-ID='LIST'`.
`FILE-ID` | A8 |  | D | Required.
`JOB-NAME` | A8 |  | D |
`RBA` | N9 |  | D |
`RECORD-LENGTH` | N5 |  | D |
`RECORD-TYPE` | N3 |  | D | Required.
`RECORD` | A253 |  | D |
`SEGMENT-LENGTH` | B2 |  | D |
`SEGMENT-NUMBER` | N5 |  | D |
`START-RBA` | N9 |  | D |
`SUB-TYPE` | N3 |  | D |
`SYSTEM-ID` | A4 |  | D |
`TIME` | N6 |  | D |
`TIMX` | T |  | D |
`TOTAL-BLOCKS` | N7 |  | D | Relevant with `FILE-ID='LIST'`.
`USED-BLOCKS` | N7 |  | D | Relevant with `FILE-ID='LIST'`.
`VOLSER` | A6 |  | D | Relevant with `FILE-ID='LIST'`.

## Relevant Error Codes

Code | Text | z/OS
--- | --- | ---
640 | Error generating VSAM control blocks. | X
641 | Error :1: while opening SMF or VSAM file. | X
642 | Error :1: while reading SMF or VSAM file. | X
643 | SMF not active / not recording. | X
644 | Invalid file ID. | X
645 | Invalid RBA was specified. | X
650 | Invalid sequential file. | X
701 | `DSNAME` missing. | X
781 | Unable to obtain storage for work area extension. | X
902 | Dynamic allocation failed. | X
990 | Field record not found in format buffer. | X
993 | Cannot open file. | X

## Field Descriptions

Field Name | Type/Length | Operating System
--- | --- | ---
`ACTIVE` | (A3) |

Relevant for `FILE-ID='LIST'`. Possible options:

Option | Explanation
--- | ---
`NO` | This is not the active SMF file.
`YES` | This is the active SMF file.

The individual types, lengths and operating systems for the fields are as follows:

Field Name | Type/Length | Operating System
--- | --- | ---
`DATE` | (N5) |

The date of the record in the format `YYDDDD`, taken from the SMF record prefix.

Field Name | Type/Length | Operating System
--- | --- | ---
`DATX` | (D) |

The date in internal format, taken from the SMF record prefix.

Field Name | Type/Length | Operating System
--- | --- | ---
`DIRECTION` | (A1) |

Retrieval direction. Possible values:

Value | Explanation
--- | ---
`F` | Read forward (default).
`B` | Read backwards.

The individual types, lengths and operating systems for the fields are as follows:

Field Name | Type/Length | Operating System
--- | --- | ---
`DSNAME` | (A44) |

- For `FILE-ID='LIST'`, the names of the SMF data sets are returned in this field.

- For `FILE-ID='MANX'`, specify the name of the SMF data set from which the SMF records are to be read.

- For `FILE-ID='LOGS'`, specify the name of the SMF log stream from which the SMF records are to be read.

- For `FILE-ID='SEQ'`, specify the name of the sequential data set from which the SMF records are to be read.

Field Name | Type/Length | Operating System
--- | --- | ---
`FILE-ID` | (A8) |

Possible values:

Value | Explanation
--- | ---
`LIST` | Return a list of SMF data sets and other relevant data.
`MANX` | Read records from the SMF data set specified in `DSNAME`.
`LOGS` | Read records from the SMF log stream specified in `DSNAME`.
`SEQ` | Read dumped SMF records from the sequential data set specified in `DSNAME`.

The individual types, lengths and operating systems for the fields are as follows:

Field Name | Type/Length | Operating System
--- | --- | ---
`JOB-NAME` | (A8) |

This field follows the SMF record prefix. For most record types, it contains the job name.

Field Name | Type/Length | Operating System
--- | --- | ---
`RBA` | (N9) |

Relative byte address of the record.

Field Name | Type/Length | Operating System
--- | --- | ---
`RECORD` | (A253) |

The SMF record / segment.

Field Name | Type/Length | Operating System
--- | --- | ---
`RECORD-LENGTH` | (N5) |

Length of the entire record (not the segment length).

Field Name | Type/Length | Operating System
--- | --- | ---
`RECORD-TYPE` | (N3) |

The type of the record, taken from the SMF record prefix.

Field Name | Type/Length | Operating System
--- | --- | ---
`SEGMENT-NUMBER` | (N5) |

Segment number within the record.

Field Name | Type/Length | Operating System
--- | --- | ---
`SEGMENT-LENGTH` | (B2) |

Length of the segment.

Field Name | Type/Length | Operating System
--- | --- | ---
`START-RBA` | (N9) |

The relative byte address of the first record to be read. If omitted, the file is read from the start or end, depending on the setting of `DIRECTION`.

Field Name | Type/Length | Operating System
--- | --- | ---
`SUB-TYPE` | (N3) |

SMF subtype.

Field Name | Type/Length | Operating System
--- | --- | ---
`SYSTEM-ID` | (A4) |

System ID, taken from the SMF record prefix.

Field Name | Type/Length | Operating System
--- | --- | ---
`TIME` | (N6) |

The time of the record in the format `HH:MM:SS`, taken from the SMF record prefix.

Field Name | Type/Length | Operating System
--- | --- | ---
`TIMX` | (T) |

The time of the record in the format `YYDDDD`, taken from the SMF record prefix.

Field Name | Type/Length | Operating System
--- | --- | ---
`TOTAL-BLOCKS` | (N7) |

Relevant when `FILE-ID='LIST'`. Number of blocks allocated to the SMF file.

Field Name | Type/Length | Operating System
--- | --- | ---
`USED-BLOCKS` | (N7) |

Relevant when `FILE-ID='LIST'`. Number of blocks used in the SMF file.

Field Name | Type/Length | Operating System
--- | --- | ---
`VOLSER` | (A6) |

Relevant when `FILE-ID='LIST'`. Volume serial number of the SMF file.

### On this page

- Common Fields for all Operating Systems
- Relevant Error Codes
- Field Descriptions