Use the GROUP command to enable the GFE Handler to validate the structure of the group before it is displayed. Once the group structure has been validated, the frame ID, offset, and number of characters of each item in a file are displayed or printed. The GROUP command also lists, for each group, the number of items, the total number of bytes, the number of full frames, and the number of bytes used in the last frame.
Format
|
GROUP [DICT] filename [(options)] |
Parameter(s)
|
options |
The following options are supported: |
|
|
P |
Sends the report to the printer. |
|
|
S |
Suppresses the item list. |
|
|
n |
Number (decimal) specifying a single frame to be validated by the GFE Handler and then displayed/printed. |
|
|
n-n |
Numbers (decimal) representing the range frames to be validated by the GFE Handler and then displayed/printed. |
|
Items are listed by groups. Within each group, each item is listed separately (unless the S option is used). Each line of item statistics has the following format:
|
frame-ID |
|
|
|
chars |
FID.offset |
item-ID |
Parameter(s)
|
chars |
(hexadecimal) Number of characters in the item. |
|
FID |
Frame ID of the item. |
|
offset |
(hexadecimal) Displacement from the frame ID. |
|
item-ID |
Item-ID. |
At the end of each group listing, totals are displayed in the following format:
|
n |
ITEMS |
b |
BYTES |
ff/nb |
FRAMES |
Parameter(s)
|
n |
Number (decimal) of items in the group. |
|
b |
Total number of bytes used in the group. |
|
ff |
Number of full frames in the group. |
|
nb |
Number of bytes used in the last frame of the group. |
Listing Group Statistics
The following example shows the first page of group statistics for the file CUSTOMERS:
|
>GROUP CUSTOMERS |
The report displays statistics in the following format:
Suppressing Item Lists
The following example shows the same report, using the S option to suppress the item lists:
|
>GROUP CUSTOMERS (S)
8115 3 ITEMS 206 BYTES 0/206 FRAMES 8116 5 ITEMS 328 BYTES 0/328 FRAMES 8117 3 ITEMS 205 BYTES 0/205 FRAMES > |