DISPLAY GROUP command

From m204wiki
Jump to navigation Jump to search

Summary

Privileges
Any user
Function
Displays information about a Model 204 permanent or temporary file group

Syntax

DISPLAY [PERM | TEMP] GROUP [(display-option)] {ALL |groupname [,groupname]...}

Where:

display-option is one of the following:

Option

Displays...

DEFINITIONS Group name, the group's permanent or temporary status, and the names of all member files; this is the default.

NAMES

Group name and its permanent or temporary status.

NOUSE

Group output on your terminal even if a USE command precedes the DISPLAY command. Any alternate device remains open, but is not used.

groupname is the name of an existing Model 204 temporary or permanent group. If neither PERM or TEMP is specified, Model 204 searches for a temporary group having the specified name. If a temporary group cannot be found, Model 204 searches for a permanent group.

Syntax notes

NOUSE can be specified with either DEFINITIONS or NAMES. The NAMES display option is generally used in conjunction with ALL.

The display options must be enclosed in parentheses and separated by commas or by one or more blanks.

Group names must be separated by commas or by one or more blanks.

Example

DISPLAY GROUP (NAMES) ALL LEG3 (TEMP), PEOPLEG1 (PERM), PEOPLEG2 (PERM) DISPLAY GROUP (DEFINITIONS) PEOPLEG1 PEOPLEG1 (PERM): PEOPLE1 PEOPLE2 PEOPLE4 PROCFILE = PEOPLE4, BLDGFT = YES, PRIVDEF = X'3FFF', PUBLIC DISPLAY GROUP (DEFINITIONS) PEOPLEG1 WIDGETG (PERM): WIDG01 WIDG02 WPROC1 WPROC2 WPROC3 PROCFILE = *, BLDGFT = YES, PRIVDEF = X 'BFFF', PUBLIC

Usage notes

The DISPLAY GROUP command displays information about a user's permanent or temporary groups, including the name of a group, its status (permanent or temporary), and its member files. Model 204 lists information about each of the specified groups, or about all of a user's groups, if ALL is specified. Group information is listed in the format specified by the display options.

If multiple procedure files have been specified for a group, then

'PROCFILE = *' is displayed, as in the third example above. File names appear in the search order determined by the CREATE GROUP command.

For Parallel Query Option/204 users, DISPLAY GROUP can display the name and member files of any or all locally created scattered groups. It does not display definitions for groups that were created on other nodes.

The names of remote files displayed are their file synonyms or remote file specifications (filename AT location).

In addition, the display might include:

  • The word OPTIONAL (in parentheses) following each optional member. MANDATORY is not displayed if the member is mandatory.

  • The MAXFAIL parameter (CREATE GROUP command) value, if it has a value other than asterisk (*).

  • The UPDTFILE parameter value, including the update file's location, if its location was used in the CREATE GROUP definition.

Processing when CCAGRP is unavailable

The DISPLAY GROUP command generates the following message when CCAGRP is unavailable:

M204.0824: PERMANENT GROUPS NOT AVAILABLE