GetBenefitGroupCategoryDescripti

Get Benefit Group/Category Description

Minor Business Rule

Object Name: N0800070

Parent DLL: CHRM

Location: Client/Server

Language: NER

Functional Description
This function is used to retrieve the description for the Benefit Group (DIVC), Benefit Category
(SBGR) or both.
Purpose

Setup Notes and Prerequisites

Special Logic

Technical Specification
ERROR CODES
0 = No Errors
1 = Benefit Group not in F00191
2 = Benefit Group Category not in F00191
3 = Benefit Group and Category not in F00191

Get the length of the data item KEY

If the Benefit Group Description is requested (Description to Fetch is 1 or 3)

• Get the Code Length from F0019
• Right Pad the szBenefitGroupCode to the Code Length
• Left Pad the szBenefitGroupCode to the length of the data item KEY
• Assign the Benefit Group System Code, Report Type, and Key (SY=06, RT=BG, KY=BF szBenefitGroupCode)
• Use the padded szBenefitGroupCode to fetch the description from F00191.

If the Benefit Category Description is requested (Description to Fetch is 2 or 3)

• Get the Code Length from F0019
• Right Pad the szBenefitGroupCategory to the Code Length
• Left Pad the szBenefitGroupCategory to the length of the data item KEY
• Assign the Benefit Category System Code, Report Type, and Key (SY=08, RT=SG, KY=BF
szBenefitGroupCategory)
• Use the padded szBenefitGroupCategory to fetch the description from F00191.

Data Structure

DN0800070 - Get Benefit Group/Category Description

Parameter Name	Data Item	Data Type	Req/Opt	I/O/Both
szBenefitGroupCode	DIVC	char	OPT	INPUT
The benefit group to which the employee is assigned. Benefit groups facilitate employee enrollment by categorizing benefit plans and allowing enrollment rules for those categories. For example, assigning an employee to an executive (EXEC) benefit group automatically links the employee to the benefits available to executives in your organization.
szBenefitGroupCategory	SBGR	char	OPT	INPUT
The category of a benefit group. The category is used to group benefit plans according to the type and/or rule. For example: MEDICAL Required Medical Selections DENTAL Optional Dental Selections LIFE Required Life Ins Selections Valid categories are set up in the Generic Rate and Message table (F00191) for system 08/type SG. Associated text for categories is stored in the General Message Detail table (F00192). For more information, see program P00191.
szBenefitGroupDescription	DL01	char	OPT	OUTPUT
A user defined name or remark.
szBenefitCategoryDescription	DL01	char	OPT	OUTPUT
A user defined name or remark.
cErrorCode	ERRC	char	OPT	OUTPUT
Significant Data Values The cErrorCode values are as follows: 0. No Errors 1. Benefit Group passed does not exist in F00191 2. Benefit Category passed does not exist in F00191 3. Neither the Benefit Group nor the Benefit Category exist in F00191 ^
cDescriptionToFetch	EV01	char	REQ	INPUT
Significant Data Values The cDescriptionToFetch values are as follows: 1 = Fetch the Benefit Group Description Only 2 = Fetch the Benefit Category Description Only 3 = Fetch both the Benefit Group and Benefit Category Descriptions ^

Related Functions

None

Related Tables

None