IDI Data Dictionary:
Sentencing and remand data
August 2015 edition
Crown copyright ©
This work is licensed under the Creative Commons Attribution 3.0 New Zealand licence.
You are free to copy, distribute, and adapt the work, as long as you attribute the work to
Statistics NZ and abide by the other licence terms. Please note you may not use any
departmental or governmental emblem, logo, or coat of arms in any way that infringes any
provision of the Flags, Emblems, and Names Protection Act 1981. Use the wording
‘Statistics New Zealand’ in your attribution, not the Statistics NZ logo.
Liability
While all care and diligence has been used in processing, analysing, and extracting data
and information in this publication, Statistics New Zealand gives no warranty it is error free
and will not be liable for any loss or damage suffered by the use directly, or indirectly, of the
information in this publication.
Citation
Statistics New Zealand (2015). IDI Data Dictionary: Sentencing and remand data (August
2015 edition). Available from www.stats.govt.nz.
ISSN 2463-2694 (online)
Published in August 2015 by
Statistics New Zealand
Tatauranga Aotearoa
Wellington, New Zealand
Contact
Statistics New Zealand Information Centre: [email protected]
Phone toll-free 0508 525 525
Phone international +64 4 931 4600
www.stats.govt.nz
Contents
1 Purpose of this data dictionary ....................................................................................4
Background ......................................................................................................................4
Reference documents......................................................................................................4
2 About the sentencing and remand data ......................................................................5
Coverage .........................................................................................................................5
Methodology ....................................................................................................................6
Quality information ...........................................................................................................6
Privacy, security, or confidentiality issues .......................................................................6
List of datasets.................................................................................................................7
3 Data dictionary for ov_major_mgmt_periods.............................................................8
Dataset description ..........................................................................................................8
Summary table .................................................................................................................8
Detailed information .........................................................................................................8
4 Data dictionary for ov_major_periods.......................................................................12
Dataset description ........................................................................................................12
Summary table ...............................................................................................................12
Detailed information .......................................................................................................13
5 Data dictionary for ov_periods ..................................................................................17
Dataset description ........................................................................................................17
Summary table ...............................................................................................................17
Detailed information .......................................................................................................17
6 Data dictionary for offender_aliases_all ...................................................................21
Dataset description ........................................................................................................21
Summary table ...............................................................................................................21
Detailed information .......................................................................................................22
7 Data dictionary for offenders_all_subset .................................................................26
Dataset description ........................................................................................................26
Summary table ...............................................................................................................26
Detailed information .......................................................................................................26
8 Data dictionary for offender_programme_completions ..........................................31
Dataset description ........................................................................................................31
Summary table ...............................................................................................................31
Detailed information .......................................................................................................31
3
1 Purpose of this data dictionary
IDI Data Dictionary: Sentencing and remand data (August 2015 edition) documents the
content of the convicted offender management datasets the Department of Corrections
provides to Statistics New Zealand to use in the Integrated Data Infrastructure (IDI).
This dictionary gives information on the variables contained in the dataset from 1998 to
2015 – including technical information and descriptions.
Use this data dictionary if you are interested in understanding and accessing sentencing
and remand data in the IDI for your research.
Background
Corrections’ sentencing and remand datasets relate to the Department’s management of
convicted offenders who receive a community sentence or imprisonment, and people
remanded until their trial is completed.
The datasets provide a chronological sequence of events and periods that provide our
best understanding of how each offender is being managed by the Department and what
events have occurred that relate to each management period.
Reference documents
_______________________________________________________
Document name: Sentencing legislation
Document description: Metadata outlining changes to sentencing legislation.
_______________________________________________________
Document name: Types of sentences
Document description: Page on Department of Corrections’ website with descriptions
for each of the COR codes within the IDI.
_______________________________________________________
4
2 About the sentencing and remand data
Coverage
Reference period start: Full information for offenders from 1998 onwards. However, there may
be historic data available for offenders who were already in prison in 1998 or who committed
serious offences.
Reference period end: Ongoing.
Geographic coverage: New Zealand.
Target population: Adult criminal offenders sentenced within New Zealand to a non-monetary
sentence.
Observed population: Anyone who spends time in prison/remand. This is generally adult
criminal offenders that are sentenced in New Zealand to a non-monetary sentence. Some youth
records may be present in the data where youth have been sentenced to an adult prison.
Analysis unit: The analysis unit differs slightly by table:
 offender_aliases_all: analysis unit is one record per alias
 offenders_all_subset: analysis unit is one record per offender (with aliases rolled up to
the offender)
 offender_programme_completions: analysis unit is programme completion date by
offender.
The following three tables contain information about sentencing and remand periods:
 ov_major_management_periods: analysis unit is by offender. This table shows what
is experienced by the offender. The most serious sentence is prioritised
 ov_major_periods: analysis unit is by offender, but has all of the start periods for new
events (unlike ov_major_management_periods). However, there is still some
prioritisation. That is, for any individual, only the most serious sentences are shown at
any given point in time, so lower severity sentences tend to be underreported in this
table
 ov_periods: analysis unit is by event. This table shows the start and end points for all
events for an offender.
Figure 1 shows a hypothetical person’s interactions with Corrections across various life events
and how these periods would be recorded in each table.
5
IDI Data Dictionary: Sentencing and remand data (August 2015 edition)
Figure 1
How life events are recorded in the sentencing and remand periods tables
Methodology
Type of data: administrative data capture.
Data collector: Department of Corrections. Data is collected from the courts, Ministry of
Justice, and Police to provide information about legal warrants, sentences and releases.
Frequency of data collection: daily, but is supplied to the IDI twice a year.
Quality information
Missing data: From June 2014, records from the offender_aliases_all and
offenders_all_subset tables were removed where an individual did not have any records on any
of the periods tables. These are individuals who had been charged with fines or restitutions (so
will be in the Ministry of Justice Charges dataset) and therefore not managed by the
Department of Corrections.
Other quality issues: A few of the sentence types have changed in usage over time.
See Sentencing legislation for some of this history.
Privacy, security, or confidentiality issues
The sentencing and remand tables that are accessible to researchers do not contain any name
or address information to identify an individual. All personal identifiers have been encrypted. All
researchers who have access to Corrections data have had their research proposals assessed
6
IDI Data Dictionary: Sentencing and remand data (August 2015 edition)
using Statistics NZ’s microdata access protocols and only approved researchers who have
been granted access by Statistics NZ may view the sentencing and remand data.
Read Statistics NZ’s microdata access protocols.
All outputs produced from Corrections data must be aggregated and counts suppressed if the
underlying unrounded count is fewer than 6.
List of datasets
ov major mgmt periods
ov_major_periods
ov_periods
offender_aliases_all
offenders_all_subset
offender_programme_completions
7
3 Data dictionary for ov_major_mgmt_periods
Dataset description
Contents of dataset: In this dataset, individual periods for an offender are rolled up into a
single chronological view. If periods occur concurrently, trumping rules apply so that the most
serious sentences are prioritised.
Summary table
IDI variable name
Mandatory
Format
Classification
name
Source variable
name
snz_uid
Y
N
snz_jus_uid
Y
N
snz_cor_track_uid
N
N
cor_mmp_event_type_code
Y
8A
ov_events_dim
event_type_code
cor_mmp_event_id_code
Y
16A
event_id
cor_mmp_period_nbr
Y
3N
period_number
cor_mmp_max_period_nbr
Y
3N
max_period_num
ber
cor_mmp_period_start_date
Y
YYYY-MMDD
period_start_date
cor_mmp_period_end_date
Y
YYYY-MMDD
period_end_date
cor_mmp_mmc_code
Y
10A
ov_mmc_dim
mmc_code
cor_mmp_prev_mmc_code
Y
10A
ov_mmc_dim
prev_period_code
cor_mmp_next_mmc_code
Y
10A
ov_mmc_dim
next_mmc_code
cor_mmp_index_offence_code
N
5A
ov_offence_dim
index_offence_co
de
cor_mmp_imposed_sentence_length_nbr
N
5N
imposed_sentenc
e_length
cor_mmp_modified_date
Y
YYYY-MMDD
dw_modified_date
cor_mmp_sentence_location_text
N
30A
location
Detailed information
_______________________________________
Table name: ov_major_mgmt_periods
_______________________________________
Variable name: snz_uid
Definition: A global unique identifier created by Statistics NZ. There is a snz_uid for each
distinct identity in the IDI. This identifier is changed and reassigned each refresh.
8
IDI Data Dictionary: Sentencing and remand data (August 2015 edition)
Format: Numeric
Name of classification:
Notes:
_______________________________________
Variable name: snz_jus_uid
Definition: A local unique identifier derived by Statistics NZ from the source agency’s unique
identifier(s). This identifier will remain the same for an identity across refreshes. Where we
receive more information during a subsequent refresh that indicates that two or more identities
represent the same identity, the identifier may change.
Format:
Name of classification:
Notes:
_____________________________________
Variable name: snz_cor_track_uid
Definition:
Format: Numeric
Name of classification:
Notes:
_______________________________________
Variable name: cor_mmp_event_type_code
Definition: Type of event, for example, ‘Birth’, ‘Deceased’, ‘Aggregate Sentence’, ‘Board
Hearing Order Release’
Format: Character, 8
Name of classification: ov_events_dim
Notes:
_______________________________________
Variable name: cor_mmp_event_id_code
Definition: Identifier for event, for example, remand_warrant_id, aggregate_sentence_id,
board_hearing_order_id, recall_id, termination_id.
Format: Character, 16
Name of classification:
Notes:
_______________________________________
Variable name: cor_mmp_period_nbr
Definition: A number sequence starting from 1 for the earliest period through to the latest.
Format: Numeric, 3
9
IDI Data Dictionary: Sentencing and remand data (August 2015 edition)
Name of classification:
Notes: The number reflects the order of periods in time.
_______________________________________
Variable name: cor_mmp_max_period_nbr
Definition: The number referencing the latest (max) period number which may be itself.
Format: Numeric, 3
Name of classification:
Notes: The max period number is cumulative for a person over their offending history.
_______________________________________
Variable name: cor_mmp_period_start_date
Definition: Date period starts.
Format: Date, YYYY-MM-DD
Name of classification:
Notes: In the IDI refresh archives up to 20MAR2014, data included future start dates. These
were removed in later supplies.
_______________________________________
Variable Name: cor_mmp_period_end_date
Definition: Date period ends.
Format: Date, YYYY-MM-DD
Name of classification:
Notes: Proxy date 9999-12-31 exists for periods with no legal end date (such as life
imprisonment). End dates in the future are an approximation, whereas end dates in the past
accurately reflect the end date of the sentence.
_______________________________________
Variable Name: cor_mmp_mmc_code
Definition: Category of management period.
Format: Character, 10
Name of classification: ov_mmc_dim
Notes:
_______________________________________
Variable name: cor_mmp_prev_mmc_code
Definition: Category of management period for previous period in sequence.
Format: Character, 10
Name of classification: ov_mmc_dim
Notes:
_______________________________________
10
IDI Data Dictionary: Sentencing and remand data (August 2015 edition)
Variable name: cor_mmp_next_mmc_code
Definition: Category of management period for next period in sequence.
Format: Character, 10
Name of classification: ov_mmc_dim
Notes:
_______________________________________
Variable name: cor_mmp_index_offence_code
Definition: Offence defined for remand periods by most serious offence code and for
aggregate sentences by longest sentence.
Format: Character, 5
Name of classification: ov_offence_dim
Notes:
_______________________________________
Variable name: cor_mmp_imposed_sentence_length_nbr
Definition: Directive sentence length in days or hours.
Format: Numeric, 5
Name of classification:
Notes:
_______________________________________
Variable Name: cor_mmp_modified_date
Definition: Created or modified date of when the record was written into the table.
Format: Date, YYYY-MM-DD
Name of classification:
Notes:
_______________________________________
Variable Name: cor_mmp_sentence_location_text
Definition: The prison where the offender was released from or the district office where the
community sentence was served.
Format: Character, 30
Name of classification:
Notes:
_______________________________________
11
4 Data dictionary for ov_major_periods
Dataset description
Contents of dataset: In this dataset, individual periods for an offender are rolled up into a
single chronological view. If periods occur concurrently, trumping rules apply so that the most
serious sentences are prioritised. Unlike the ov_major_mgmt_periods table, this dataset shows
the start of each period, but does not necessarily show the end of the period (as it may be
obstructed by the start of a new period).
Hence, a single view may contain repeated prison, community work or remand periods as the
directive for those periods may change from one to the next.
This allows for accurate point in time analysis of management activity and the reasons
associated with it.
Summary table
IDI variable name
Mandatory
Format
snz_uid
Y
N
snz_jus_uid
Y
N
snz_cor_track_uid
Y
N
cor_mpe_period_start_date
Y
YYYY-MM-DD
period_start_date
cor_mpe_period_end_date
Y
YYYY-MM-DD
period_end_date
cor_mpe_period_code
Y
8A
cor_mpe_event_id_code
Y
16A
cor_mpe_event_type_code
Y
8A
cor_mpe_period_nbr
Y
3N
period_number
cor_mpe_max_period_nbr
Y
3N
max_period_number
cor_mpe_prev_period_code
Y
8A
ov_periods_dim
prev_period_code
cor_mpe_next_period_code
Y
8A
ov_periods_dim
next_period_code
cor_mpe_mmc_code
Y
10A
ov_mmc_dim
mmc_code
cor_mpe_prev_mmc_code
Y
10A
ov_mmc_dim
prev_mmc_code
cor_mpe_next_mmc_code
Y
10A
ov_mmc_dim
next_mmc_code
cor_mpe_index_offence_code
N
5A
ov_offence_dim
index_offence_code
cor_mpe_imposed_sentence_lengt
h_nbr
N
5N
imposed_sentence_lengt
h
cor_mpe_modified_date
Y
YYYY-MM-DD
dw_modified_date
12
Classification
name
ov_periods_dim
Source variable name
period_code
event_id
ov_events_dim
event_type_code
IDI Data Dictionary: Sentencing and remand data (August 2015 edition)
Detailed information
_______________________________________
Table name: ov_major_periods
_________________________________________
Variable name: snz_uid
Definition: A global unique identifier created by Statistics NZ. There is a snz_uid for each
distinct identity in the IDI. This identifier is changed and reassigned each refresh.
Format: Numeric
Name of classification:
Notes:
_______________________________________
Variable name: snz_jus_uid
Definition: A local unique identifier derived by Statistics NZ from the source agency’s unique
identifier(s). This identifier will remain the same for an identity across refreshes. Where we
receive more information during a subsequent refresh that indicates that two or more identities
represent the same identity, the identifier may change.
Format:
Name of classification:
Notes:
_____________________________________
Variable name: snz_cor_track_uid
Definition:
Format: Numeric
Name of classification:
Notes:
_________________________________________
Variable name: cor_mpe_period_start_date
Definition: Date period starts.
Format: Date, YYYY-MM-DD
Name of classification:
Notes:
_________________________________________
13
IDI Data Dictionary: Sentencing and remand data (August 2015 edition)
Variable name: cor_mpe_period_end_date
Definition: Date period ends.
Format: Date, YYYY-MM-DD
Name of classification:
Notes: Proxy date 9999-12-31 exists for periods with no legal end date (such as life
imprisonment). End dates in the future are an approximation, whereas end dates in the past
accurately reflect the end date of the sentence.
_________________________________________
Variable name: cor_mpe_period_code
Definition: Type of management period.
Format: Character, 8
Name of classification: ov_periods_dim
Notes:
_________________________________________
Variable name: cor_mpe_event_id_code
Definition: Identifier for event, for example, remand_warrant_id, aggregate_sentence_id,
board_hearing_order_id, recall_id, termination_id.
Format: Character, 16
Name of classification:
Notes:
_________________________________________
Variable name: cor_mpe_event_type_code
Definition: Type of event, for example, ‘Birth’, ’Deceased’, ’Aggregate Sentence’, ’Board
Hearing Order Release’
Format: Character, 8
Name of classification: ov_events_dim
Notes:
_________________________________________
Variable name: cor_mpe_period_nbr
Definition: A number sequence starting from 1 for the earliest period through to the latest.
Format: Numeric, 3
Name of classification:
Notes: The number reflects the order of periods in time.
14
IDI Data Dictionary: Sentencing and remand data (August 2015 edition)
_________________________________________
Variable name: cor_mpe_max_period_nbr
Definition: The number referencing the latest (max) period number which may be itself.
Format: Numeric, 3
Name of classification:
Notes: The max period number is cumulative for a person over their offending history.
_________________________________________
Variable name: cor_mpe_prev_period_code
Definition: Type of management period for previous period in sequence.
Format: Character, 8
Name of classification: ov_periods_dim
Notes:
_________________________________________
Variable name: cor_mpe_next_period_code
Definition: Type of management period for next period in sequence.
Format: Character, 8
Name of classification: ov_periods_dim
Notes:
_________________________________________
Variable name: cor_mpe_mmc_code
Definition: This indicates the offender's current activity, eg in remand, in prison.
Format: Character, 10
Name of classification: ov_mmc_dim
Notes:
_________________________________________
Variable name: cor_mpe_prev_mmc_code
Definition: This indicates the offender's previous activity, eg in remand, in prison.
Format: Character, 10
Name of classification: ov_mmc_dim
Notes:
_________________________________________
15
IDI Data Dictionary: Sentencing and remand data (August 2015 edition)
Variable name: cor_mpe_next_mmc_code
Definition: This indicates the offender's next activity, eg in remand, in prison.
Format:
Name of classification: ov_mmc_dim
Notes:
_________________________________________
Variable name: cor_mpe_index_offence_code
Definition: Offence defined for remand periods by most serious offence code and for
aggregate sentences by longest sentence.
Format: Character, 5
Name of classification: ov_offence_dim
Notes:
_________________________________________
Variable name: cor_mpe_imposed_sentence_length_nbr
Definition: Directive sentence length in days or hours.
Format: Numeric, 5
Name of classification:
Notes:
_________________________________________
Variable name: cor_mpe_modified_date
Definition: Created or modified date of when the record was written into the table.
Format: Date, YYYY-MM-DD
Name of classification:
Notes:
_________________________________________
16
5 Data dictionary for ov_periods
Dataset description
Contents of dataset: Multiple tracks of chronological periods with start/end events that relate
to the individual track. Tracks are constructed independently. A track can be any of the
following:




An offender identity keeping track of birth, deportation and death events. An offender
can only have one identity track.
An aggregate sentence.
A board order.
A remand warrant.
Periods from different tracks overlap in this dataset. This allows for analysis on concurrency of
management directives, such as concurrent aggregate sentences.
Summary table
IDI variable name
Mandatory
Format
Classification
name
Source variable name
snz_uid
Y
N
snz_jus_uid
Y
N
snz_cor_track_uid
Y
N
cor_per_start_event_type_code
Y
8A
ov_events_dim
start_event_type_code
cor_per_start_record_id_code
Y
16A
cor_per_period_code
Y
8A
cor_per_period_start_date
Y
YYYY-MM-DD
period_start_date
cor_per_period_end_date
Y
YYYY-MM-DD
period_end_date
cor_per_mmc_code
Y
10A
mmc_code
cor_per_end_event_type_code
Y
8A
cor_per_end_record_id_code
Y
16A
end_record_id
cor_per_index_offence_code
Y
5A
index_offence_code
cor_per_imposed_sentence_length
Y
5A
imposed_sentence_length
cor_per_in_muster_flag
Y
1A
in_muster_flag
cor_per_modified_date
Y
YYYY-MM-DD
dw_modified_date
start_record_id
ov_periods_dim
ov_events_dim
period_code
end_event_type_code
Detailed information
_______________________________________
Table name: ov_periods
_______________________________________
Variable name: snz_uid
Definition: A global unique identifier created by Statistics NZ. There is a snz_uid for each
distinct identity in the IDI. This identifier is changed and reassigned each refresh.
17
IDI Data Dictionary: Sentencing and remand data (August 2015 edition)
Format: Numeric
Name of classification:
Notes:
_______________________________________
Variable name: snz_jus_uid
Definition: A local unique identifier derived by Statistics NZ from the source agency’s unique
identifier(s). This identifier will remain the same for an identity across refreshes. Where we
receive more information during a subsequent refresh that indicates that two or more identities
represent the same identity, the identifier may change.
Format:
Name of classification:
Notes:
_____________________________________
Variable name: snz_cor_track
Definition:
Format: Numeric
Name of classification:
Notes:
_________________________________________
Variable name: cor_per_start_event_type_code
Definition: Type of event at the beginning of the period, for example,
‘Birth’,’Deceased’,’Aggregate Sentence’,’Board Hearing Order Release’
Format: Character, 8
Name of classification: ov_events_dim
Notes:
__________________________________
Variable name: cor_per_start_record_id_code
Definition: Identifier for event at the start of the period, for example, remand_warrant_id,
aggregate_sentence_id, board_hearing_order_id, recall_id, termination_id.
Format: Character, 16
Name of classification:
Notes:
__________________________________
Variable name: cor_per_period_code
18
IDI Data Dictionary: Sentencing and remand data (August 2015 edition)
Definition: Type of management period.
Format: Character, 8
Name of classification: ov_periods_dim
Notes:
__________________________________
Variable name: cor_per_period_start_date
Definition: Date period starts.
Format: Date, YYYY-MM-DD
Name of classification:
Notes: From June 2014, records with future period start dates are no longer being supplied.
__________________________________
Variable name: cor_per_period_end_date
Definition: Date period ends.
Format: Date, YYYY-MM-DD
Name of classification:
Notes: Proxy date 9999-12-31 exists for periods with no legal end date (such as life
imprisonment). End dates in the future are an approximation, whereas end dates in the past
accurately reflect the end date of the sentence.
__________________________________
Variable name: cor_per_mmc_code
Definition: This indicates the offender's current activity, eg in remand, in prison.
Format: 10A
Name of classification:
Notes:
__________________________________
Variable name: cor_per_end_event_type_code
Definition: Type of event at the end of the period, for example, ‘Birth’, ’Deceased’, ’Aggregate
Sentence’, ’Board Hearing Order Release’.
Format: Character, 8
Name of classification: ov_events_dim
Notes:
__________________________________
19
IDI Data Dictionary: Sentencing and remand data (August 2015 edition)
Variable name: cor_per_end_record_id_code
Definition: Identifier for event at the end of the period, for example, remand_warrant_id,
aggregate_sentence_id, board_hearing_order_id, recall_id, termination_id.
Format: Character, 16
Name of classification:
Notes:
__________________________________
Variable name: cor_per_index_offence_code
Definition: The most serious offence an offender has been charged with.
Format: Character, 5
Name of classification:
Notes:
__________________________________
Variable name: cor_per_imposed_sentence_length
Definition: The length of the sentenced issued by the judge.
Format: Character, 5
Name of classification:
Notes:
__________________________________
Variable name: cor_per_in_muster_flag
Definition: Whether an offender is currently held in prison or is on remand.
Format: Character, 1
Name of classification:
Notes:
__________________________________
Variable name: cor_per_modified_date
Definition: Created or modified date of when the record was written into the table.
Format: Date, YYYY-MM-DD
Name of classification:
Notes:
__________________________________
20
6 Data dictionary for offender_aliases_all
Dataset description
Contents of dataset: Offender_aliases_all table links all the known identities for the same
offender to an offender_id (Department of Corrections creation). Different organisations (Police,
Courts, Corrections) may use different identification numbers to identify the same offender. This
table lists the external reference type where Corrections has been able to match an identity
across organisations.
The analysis unit is one record per alias.
Summary table
IDI variable name
Primary
key
Mandatory
Format
snz_uid
Y
Y
N
snz_jus_uid
Y
Y
N
snz_cor_identity_uid
N
N
cor_ali_name_type_code
Y
5A
cor_ali_birth_year_nbr
Y
N
Year of birth
N
Month of birth
5A
external_reference_ty
pe
cor_ali_birth_month_nbr
Classification name
Source variable
name
alias_source_dim
name_type_code
cor_ali_external_ref_type_
code
Y
cor_ali_sex_snz_code
Y
30A
gender
cor_ali_homeless_ind
Y
1A
homeless_flag
cor_ali_source_agency_co
de
Y
cor_ali_birthplace_country
_code
Y
cor_ali_birthplace_city_cod
e
Y
Y
cor_ali_from_date
cor_ali_ps_primary_identit
y_ind
Y
cor_ali_cps_primary_identi
ty_ind
Y
cor_ali_deleted_ind
Y
source_agency_code
5A
5A
20A
YYYYMM-DD
country_dim
birthplace_country_co
de
town_city_dim
birthplace_city_code
date_from
1A
ps_primary_identity_fl
ag
1A
cps_primary_identity_
flag
1A
deleted_flag
21
IDI Data Dictionary: Sentencing and remand data (August 2015 edition)
Detailed information
_______________________________________
Table name: offender_aliases_all
_______________________________________
Variable name: snz_uid
Definition: A global unique identifier created by Statistics NZ. There is a snz_uid for each
distinct identity in the IDI. This identifier is changed and reassigned each refresh.
Format: Numeric
Name of classification:
Notes:
_______________________________________
Variable name: snz_jus_uid
Definition: A local unique identifier derived by Statistics NZ from the source agency’s unique
identifier(s). This identifier will remain the same for an identity across refreshes. Where we
receive more information during a subsequent refresh that indicates that two or more identities
represent the same identity, the identifier may change.
Format:
Name of classification:
Notes:
_____________________________________
Variable name: snz_cor_identity_uid
Definition: Uniquely identifies the offender identity (aliases).
Format: Numeric
Name of classification:
Notes:
__________________________________
Variable name: cor_ali_name_type_code
Definition: Name type, eg ALI - alias, MAS - master, DRL - drivers licence, FCN - fine
collection number etc.
Format: Character, 5
Name of classification: alias_source_dim
Notes:
__________________________________
Variable name: cor_ali_birth_year_nbr
22
IDI Data Dictionary: Sentencing and remand data (August 2015 edition)
Definition: Year that the offender was born in.
Format: Numeric
Name of classification:
Notes:
__________________________________
Variable name: cor_ali_birth_month_nbr
Definition: Month that the offender was born in.
Format: Numeric
Name of classification:
Notes:
__________________________________
Variable name: cor_ali_external_reference_type
Definition: The type of external reference, either a PRN, or a drivers licence.
Format: Character, 5
Name of classification:
Notes:
__________________________________
Variable name: cor_ali_sex_snz_code
Definition: Gender of the offender provided by an external agency, ie, male, female,
indeterminate, or unknown.
Format: Character, 30
Name of classification:
Notes:
__________________________________
Variable name: cor_ali_homeless_ind
Definition: Flag identifying the offender has no fixed abode, eg Y/N.
Format: Character, 1
Name of classification:
Notes:
__________________________________
Variable name: cor_ali_source_agency_code
Definition: Source the identity has been received from.
23
IDI Data Dictionary: Sentencing and remand data (August 2015 edition)
Format: Character, 5
Name of classification:
Notes:
__________________________________
Variable name: cor_ali_birthplace_country_code
Definition: Country of birth for this identity.
Format: Character, 5
Name of classification: country_dim
Notes:
__________________________________
Variable name: cor_ali_birthplace_city_code
Definition: The town or city of birth for this Identity.
Format: Character, 20
Name of classification: town_city_dim
Notes:
__________________________________
Variable name: cor_ali_date_from
Definition: Date the record was received / created / edited
Format: Date, YYYY-MM-DD
Name of classification:
Notes:
__________________________________
Variable name: cor_ali_ps_primary_identity_ind
Definition: This flag determines whether an Identity is PS Primary Identity or not. It is set to 'Y'
when the identity is the Primary PS identity and 'N' when it is not.
Format: Character, 1
Name of classification:
Notes:
__________________________________
Variable name: cor_ali_cps_primary_identity_ind
Definition: This flag determines whether an Identity is CPS Primary Identity or not. It is set to
'Y' when the identity is the Primary CPS identity and 'N' when it is not.
24
IDI Data Dictionary: Sentencing and remand data (August 2015 edition)
Format: Character, 1
Name of classification:
Notes:
__________________________________
Variable name: cor_ali_deleted_ind
Definition: Flag identifying the offender identity has been deleted from IOMS, eg Y/N.
Format: Character, 1
Name of classification:
Notes:
__________________________________
25
7 Data dictionary for offenders_all_subset
Dataset description
Contents of dataset: Offenders_all_subset contains personal information on all offenders, both
active and historical, who are currently in IOMS. There is one row for every offender. The table
holds the latest details for every offender.
The analysis unit is one record per offender (aliases are not shown here).
Summary table
IDI variable name
Mandatory
Format
Classification
name
snz_uid
Y
N
snz_jus_uid
Y
N
cor_off_birth_year_nbr
N
N
Year of birth
cor_off_birth_month_nbr
N
N
Month of birth
cor_off_external_ref_type_code
N
5A
external_reference_type
cor_off_sex_snz_code
N
100A
gender
cor_off_birthplace_country_code
N
5A
cor_off_pref_ethnicity_code
N
3A
pref_ethnicity_code
cor_off_active_gang_member_ind
Y
1A
active_gang_member_flag
cor_off_ever_gang_member_ind
Y
1A
ever_gang_member_flag
cor_off_ethnic_snz_code
N
2A
cor_off_ethnic_grp1_snz_ind
Y
1N
cor_off_ethnic_grp2_snz_ind
Y
1N
cor_off_ethnic_grp3_snz_ind
Y
1N
cor_off_ethnic_grp4_snz_ind
Y
1N
cor_off_ethnic_grp5_snz_ind
Y
1N
cor_off_ethnic_grp6_snz_ind
Y
1N
country_dim
Source variable name
birthplace_country_code
Detailed information
_______________________________________
Table name: offenders_all_subset
_______________________________________
Variable name: snz_uid
Definition: A global unique identifier created by Statistics NZ. There is a snz_uid for each
distinct identity in the IDI. This identifier is changed and reassigned each refresh.
Format: Numeric
Name of classification:
26
IDI Data Dictionary: Sentencing and remand data (August 2015 edition)
Notes:
_______________________________________
Variable name: snz_jus_uid
Definition: A local unique identifier derived by Statistics NZ from the source agency’s unique
identifier(s). This identifier will remain the same for an identity across refreshes. Where we
receive more information during a subsequent refresh that indicates that two or more identities
represent the same identity, the identifier may change.
Format:
Name of classification:
Notes:
_______________________________________
Variable name: cor_off_birth_year_nbr
Definition: Year the offender was born in.
Format: Numeric
Name of classification:
Notes:
__________________________________
Variable name: cor_off_birth_month_nbr
Definition: Month the offender was born in.
Format: Numeric
Name of classification:
Notes:
__________________________________
Variable name: cor_off_external_ref_type_code
Definition: The type of external reference, either a PRN, or a drivers licence.
Format: Character, 5
Name of classification:
Notes:
__________________________________
Variable name: cor_off_sex_snz_code
Definition: Sex of the offender provided by an external agency, ie, male, female, indeterminate,
or unknown.
Format: Character, 100
27
IDI Data Dictionary: Sentencing and remand data (August 2015 edition)
Name of classification:
Notes:
__________________________________
Variable name: cor_off_birthplace_country_code
Definition:
Format: Character, 5
Name of classification: country_dim
Notes:
__________________________________
Variable name: cor_off_pref_ethnicity_code
Definition:
Format: Character, 3
Name of classification:
Notes:
__________________________________
Variable name: cor_off_active_gang_member_ind
Definition: A flag to indicate if the offender has a current gang relationship with a status that is
'In Good Standing', 'Active', 'Suspected' or 'Under Review'.
Format: Character, 1
Name of classification:
Notes:
__________________________________
Variable name: cor_off_ever_gang_member_ind
Definition: A flag to indicate if the offender has any former or current relationship with a gang
that had a status of 'In Good Standing', 'Active', 'Suspected' or 'Under Review'.
Format: Character, 1
Name of classification:
Notes:
__________________________________
Variable name: cor_off_ethnic_snz_code
Definition: Ethnicity variable concorded to the Statistics NZ standard.
1 = European
2 = Māori
28
IDI Data Dictionary: Sentencing and remand data (August 2015 edition)
3 = Pacific Peoples
4 = Asian
5 = Middle Eastern/Latin American/African
6 = Other Ethnicity
9 = Residual
Format: Character, 1
Name of classification:
Notes:
__________________________________
Variable name: cor_off_ ethnic_grp1_snz_ind
Definition: European ethnicity indicator.
Format: Numeric, 1
Name of classification:
Notes:
__________________________________
Variable name: cor_off_ ethnic_grp2_snz_ind
Definition: Māori ethnicity indicator.
Format: Numeric, 1
Name of classification:
Notes:
__________________________________
Variable name: cor_off_ ethnic_grp3_snz_ind
Definition: Pacific peoples ethnicity indicator.
Format: Numeric, 1
Name of classification:
Notes:
__________________________________
Variable name: cor_off_ ethnic_grp4_snz_ind
Definition: Asian ethnicity indicator.
Format: Numeric, 1
Name of classification:
Notes:
__________________________________
29
IDI Data Dictionary: Sentencing and remand data (August 2015 edition)
Variable name: cor_off_ ethnic_grp5_snz_ind
Definition: Middle Eastern/Latin American/African ethnicity indicator.
Format: Numeric, 1
Name of classification:
Notes:
__________________________________
Variable name: cor_off_ ethnic_grp6_snz_ind
Definition: Other ethnicity indicator.
Format: Numeric, 1
Name of classification:
Notes:
__________________________________
30
8 Data dictionary for
offender_programme_completions
Dataset description
Contents of dataset: The offender_programme_completions dataset contains information on
Department of Corrections community- and prison-based educational and rehabilitative
programme completions at the offender level. Data includes programme locations, completion
dates and completion years.
Summary table
IDI variable name
Primary
key
Mandatory
Format
Source variable
name
snz_uid
Y
Y
N
snz_jus_uid
Y
Y
N
cor_pro_completion_date
Y
YYYY-MM-DD
completion_date
cor_pro_completion_year_nbr
Y
N
competion_year
cor_pro_programme_type_text
Y
80A
programme_type
cor_pro_location_text
Y
A50
location
Detailed information
_______________________________________
Table name: offender_programme_completions
_________________________________________
Variable name: snz_uid
Definition: A global unique identifier created by Statistics NZ. There is a snz_uid for each
distinct identity in the IDI. This identifier is changed and reassigned each refresh.
Format: Numeric
Name of classification:
Notes:
_______________________________________
Variable name: snz_jus_uid
Definition: A local unique identifier derived by Statistics NZ from the source agency’s unique
identifier(s). This identifier will remain the same for an identity across refreshes. Where we
receive more information during a subsequent refresh that indicates that two or more identities
represent the same identity, the identifier may change.
Format:
Name of classification:
Notes:
31
IDI Data Dictionary: Sentencing and remand data (August 2015 edition)
_______________________________________
Variable name: cor_pro_completion_date
Definition:
Format: Date, YYYY-MM-DD
Name of classification:
Notes:
_______________________________________
Variable name: cor_pro_completion_year_nbr
Definition:
Format: Numeric
Name of classification:
Notes:
_______________________________________
Variable name: cor_pro_programme_type_text
Definition:
Format: Character, 80
Name of classification:
Notes:
_______________________________________
Variable name: cor_pro_location_text
Definition:
Format: Character, 50
Name of classification:
Notes:
_______________________________________
32