home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Global Amiga Experience
/
globalamigaexperience.iso
/
graphic
/
cad
/
xcad3000
/
xcdoc
/
listcomp
< prev
next >
Wrap
Text File
|
1995-07-10
|
6KB
|
154 lines
? LIST COMPONENT
LIST COMPONENT is used to extract a Component listing generated as a list of
fixed-format records. The layout and contents of the output listing is
driven by a parameter file specified with the PFILE modifier. For each
valid Symbol identified in a drawing, a record is written to the text window
or output file.
The PFILE contains a set of instructions that must obey the format described
below. Comment lines in the PFILE are indicated by an asterisk in the first
column. Each line in the PFILE starts with one of 5 keywords that must be
entered in upper-case text. These are:
ITEM Describes a data-field in the output record.
INCLUDE Lists attribute that must be present on a Symbol for it
to be included in the report.
EXCLUDE Lists attributes that must not be present on a Symbol for
it to be included in the report.
HEADER Describes the format of the header to be generated at the
top of every page in the output report.
PAGE Indicates that maximum page length in the report.
The ITEM instruction is made up of 9 fields including the ITEM keyword
itself. All text fields in an ITEM line must be entered in upper-case text.
ITEM key source attribute row col width just prec
For example:
ITEM 1 SYM_TNODE_TEXT COMPNAME 1 30 20 L 0
"key" is entered as an integer number whose value must be unique for all
ITEM lines in the PFILE. Note, the output report is sorted in ascending
order on the field described by the first ITEM line encountered.
The "source" field contains one of 7 keywords which describe where the data
for the field is to be found. These keywords are:
SYM_TNODE_TEXT The data is obtained as the value of a Text
entity related to a Tnode related to the Symbol.
The required Tnode is identified by the
"attribute" field.
SYM_TERM_TEXT The data is obtained as the value of a Text
entity related to a Terminal related to the
Symbol. The required Terminal is identified by
the "attribute" field.
SYM_ATTR_VAL The data is obtained as the value of a specified
attribute found on the Symbol. The required
attribute is defined by the "attribute" field.
SYM_NAME The data is obtained as the name of the Symbol.
SYM_FIRST_TEXT The data is obtained as the value of a Text
entity related to the first Tnode found on the
Symbol. For this case an attribute is not
specified.
SYM_NET_LABEL The data is obtained as the name of the network
to which the Symbol is related.
TNODE_TEXT The data is obtained as the value of a Text
entity related to any Tnode in the drawing that
has the attribute specified in the "attribute"
field.
The "attribute" field is used to enter an attribute name for "source" fields
that require it. If an attribute name is not valid, the keyword NOVAL must
be entered.
"row" specifies the row number in the output record at which this data item
is placed.
"col" specifies the column in the output record at which this data item is
placed.
"width" specifies the maximum width of the data item field.
"just" is used to specify the justification of the data item within its
field. This can be one of 3 values:
L For left justification.
C For centre justification.
R For right justification.
"prec" specifies the number of places of precision for data field that
contain real numbers. Enter a zero if this field is not applicable.
The INCLUDE instruction can be entered one or more times to specify which
Symbols are to be included in the report by specifying a list of attributes
that must be present on the symbol. The format for the INCLUDE line is:
INCLUDE attribute1 attribute2 ... attributeN
INCLUDE instructions are processed in the order they are found in the PFILE.
If any INCLUDE instructions are found in the PFILE, then the starting point
is to exclude all Symbols. As each INCLUDE line is found, any Symbol that
meets the specified criteria is included. Thus each separate INCLUDE line
acts as an "or" instruction in that so long as a Symbol meets the
specification of any of the INCLUDE lines, it will be included in the
report.
If an INCLUDE instruction contains more that one attribute name, then for a
Symbol to be included, it must have all of the attributes listed. Thus this
acts as an "and" instruction.
EXCLUDE instructions act in the same was as INCLUDE instructions with the
exception that they are used to exclude symbols from the report. EXCLUDE
instructions are always processed after INCLUDE instructions and only
operate on included Symbols.
The HEADER instruction is used to indicate that the following set of lines
delimited by the ENDHEAD keyword forms a header to be included at the top of
each page. For example:
HEADER
Name Type Description Drawing
---- ---- ----------- -------
ENDHEAD
The 4 lines between the HEADER and ENDHEAD line form the page header.
The PAGE instruction is followed by a single integer specifying the number
of lines that make a single page.
COMMAND FORMAT
#LIST COMPONENT modifiers :Symbol d1 ... dn
One or more Symbol entities are identified via IDENTS.
MODIFIERS
TO Specifies the name of the output file to which the network
and component schedule is written. If this modifier is
not used, the schedule is printed to the text window.
PFILE Specifies the name of the parameter file containing a
description of the output record, exclusion parameters and
pagination etc.