Concept: Immigrant family status and family linkage
Last Updated: 2026-07-16
As part of MCHP’s efforts to analyze family structure, we have developed a methodology to identify spouses and children in Immigration, Refugees and Citizenship Canada (IRCC) Registry Permanent Resident Data (IRCC-PR), using techniques similar to the %RegRelation macro which finds these relationships in the Manitoba Health Insurance Registry. The %ircc_relation macro links family members who arrived as landed immigrants in Canada on a shared application. They are linked via a common application number, and the individual relationships within the applicant family are established by the family status variables for each member of the family. Unlike the insurance registry, which can provide a longitudinal view of the dynamics of family structure, tracking not only marriages and children, but also new births and separations over time, the relationships identified by IRCC-PR data are more of a one-time snapshot, taken when the family immigrated to Canada.
%ircc_relation(cohort=, acqdt=, acqset=, debug=, fstlanddt=, lstlanddt=, lib=);
It uses named parameters, so you only need to specify the ones that do not define the value you want to use by default.
The macro produces a PRRELCA dataset ifcohortspecifies dataset with scrphin values for whom to extract data, or you can usecohort=Canadato get all landing records, even if not linked by scrphin. By default, all linkable scrphin values are read.
acqdtspecifies the exact acqdt value to use in the IRCC datasets. The default value is latest current date,25aug2025as of this writing.
acqsetspecifies the exact acqset value to use in the IRCC datasets, which overrides the acqdt value if one is given. Only one of acqdt or acqset should be specified.
debugspecifies (via1ordebug) whether to output debug information. By default, no debugging data is shown.debug=noteswill leave SAS options as they are, usually allowing notes in the listing. debug=stats is like debug=notes, but the macro will also output stats as it does in debug mode.
fstlanddtspecifies the earliest landing_dt value to be read from the data. There is no lower limit by default, so the earliest dates available in the data will be used.
lstlanddtspecifies the most recent landing_dt value to be read. No upper limit by default.
libspecifies an alternate library name from which the IRCC-PR datasets are read, rather than theregistrylibrary.
cohort=Canada
was specified, yielding relationship data for all immigrants to Canada, and a PRRELMB dataset in any case, for linked immigrants to Manitoba. These datasets contain variables similar to the ALLREL dataset produced by %RegRelation: RELATION and RELTYPE show relationship type, RELUCID shows the IRCC UCI value for the identified relative, and RELPHIN shows the scrambled PHIN of the identified relative if linked in the Manitoba insurance registry.