ARRAY (AR)

The ARRAY command (synonym OCCURS) controls whether the array declaration information for PL/I data is displayed.

The command is available in the Browse, Edit, and Selection Criteria functions in Formatted mode.

image2021-6-3_9-50-39.png

ON

Displays an array definition line for each subscripted item in a record layout.

OFF

Does not display an array definition line.

Selection Criteria Functionality

ANY, EVERY and ALL are only available in Formatted Selection Criteria.

ALL

Displays all occurrences separately with the subscript(s) and any criteria entered on a specific occurrence will only be applied to that occurrence. Display of PL/I Refers defaults to 1 occurrence unless changed by the “DISPLAY MAXREFER” command.

ANY

Displays a single entry for the occurrences and any criteria entered for the ANY occurrence will be applied to all occurrences. The record will meet the Selection Criteria if any of the occurrences meet the specified criteria. ANY is applied for initial display of a new Selection Criteria set.

Important

When applying 2 or more criteria in the same subset, all have to be true in the same occurrence to be selected.
When entered individually in different subsets, they don’t have to be true in the same occurrence to be selected.

EVERY

Displays a single entry for the occurrences and any criteria entered for the EVERY occurrence will be applied to all occurrences. The record will meet the Selection Criteria if all of the occurrences meet the specified criteria.

Guidelines

  • Use the PROFILE command to display the current ARRAY ON or OFF value. Only ON or OFF are saved in the profile.
  • The array line contains the name of the array followed by the word ARRAY and the subscript bounds in standard PL/I format. If any of the subscripts are defined by a REFER clause, additional lines that follow the ARRAY line describe each REFER variable.
  • ANY, EVERY or ALL is applied per set or subset if any. Each set or subset may have a different array setting.
  • You cannot switch ANY, EVERY or ALL to another if the criteria is specified on any occurrence field in a single set or single subset.
  • In ANY or EVERY mode, the SHOW OFFSET command shows the offsets of the first occurrence.
  • ALL must be active before the DISPLAY MAXREFER command can be issued (see also DISPLAY-MAXREFER-DIS-MAXREFER).

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*