ShowOcc Function

Format

b = showocc(roster_name ‖ form_nameʃ(occurrence_number)ʅʃ,show_conditionʅ);

Description

The showocc function shows an occurrence of a roster or form in the mobile CSEntry case tree. It will also show the row on a roster on desktop CSEntry. If no numeric occurrence_number is supplied, then the current occurrence for the roster or form will be shown.

By default, all occurrences of a roster and form are shown by CSEntry, but occurrences may be hidden with the hideocc function. Alternatively, an optional numeric argument show_condition, allows the showocc function to conditionally hide occurrences, based on whether the condition is true. The occurrence will be hidden if show_condition is 0; the occurrence will be shown for any other value.

Return Value

The function returns a logical value 1 (true) if successful and 0 (false) otherwise.

Example

PROC MYSURVEY_QUEST

preproc

// fill in and potentially hide occurrence labels for the household roster
do numeric ctr = 1 while ctr <= totocc(PERSON_ROSTER)
showocc(PERSON_ROSTER(ctr),KEEP_PERSON(ctr));
setocclabel(PERSON_ROSTER(ctr),strip(NAME(ctr)));
enddo;