Use the ITEM command to enable the GFE Handler to validate the structure of the group before it is displayed. Once the group is validated, the frame ID, offset, and number of characters of each item in a file are displayed or printed. The ITEM command also lists statistics for all other items stored in the same group, the total number of items, the total number of bytes, the number of full frames, and the number of bytes used in the last frame of the group.
Format
ITEM [DICT] filename item-ID [(options)] |
Parameter(s)
DICT |
Specifies the file dictionary. |
|
filename |
Name of the file. |
|
item-ID |
Item-ID of the item whose group statistics you want. |
|
options |
The following options are supported: |
|
P |
Sends the report to the printer. |
|
S |
Suppresses the item list. |
|
Description
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 the item 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 group statistics for item JBUCK26STO in the file CUSTOMERS:
>ITEM CUSTOMERS JBUCK26STO |
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:
>ITEM CUSTOMERS JBUCK26STO (S)
JBUCK26STO 8116 5 ITEMS 328 BYTES 0/328 FRAMES
> |