REPORT CONTROL & INFORMATION

REPORT CONTROL & INFORMATION - Ultramarine.com REPORT CONTROL & INFORMATION

When obtaining written information about the system, the user has control over the extent of information provided. This control is exercised by using a set of selectors which can be defined as options on the report generating command, or on an internal command, &REP_SELECT. Once one of these options has been specified, it remains in effect until it is explicitly redefined on either an &REP_SELECT command or on a reporting command.

The form of the command is:


     &REP_SELECT, -OPTIONS

and the available options are:



     -BODY, :BODY_SEL


     -PART, :PART_SEL


     -LGROUP, :LG_SEL


     -COMPARTMENT, :CMP_SEL

     -CLASS, :CLS_SEL

     -NODE, :NODE_SEL(1), :NODE_SEL(2), :NODE_SEL(3), :NODE_SEL(4)

     -TAG, :TAG_SEL

     -ELEMENT, :ELE_SEL


     -PANEL, :PAN_SEL


     -MAP, :MAP_SEL


     -DATA, :DATA_SEL

     -SELALL

Here, :BODY_SEL, :PART_SEL, :LG_SEL, :CMP_SEL, :CLASS_SEL, :NODE_SEL(i), :ELE_SEL, :MAP_SEL, :PAN_SEL, :DATA_SEL and :TAG_SEL define the manner in which quantities are selected. They can be either selection criteria, simple names, or names containing wild characters. If one of these options is not selected, then the selector defined by the last use of the corresponding option will govern.

Node selection is more complicated than that of class or element. Suppose that an element has two vertices. Then for the element to be selected, both nodes must match either :NODE_SEL(1) or :NODE_SEL(2). Thus, to select all elements connected to a given node, one should set :NODE_SEL(1) to be the specified node and the remaining node selectors to be @. Alternately, to select a single element, one can set :NODE_SEL(1) and :NODE_SEL(2) to be the end nodes of the element.

In general, the selectors define the things which will be reported. However, when one asks for a report of elements, the report will be restricted as follows:

The class name of the element must match the class selector defined by the last -CLASS option,

The nodes which form the vertices of the element all must match a node selector defined by the last -NODE option,

The element tag must match the tag selector defined by the last -TAG option, and

The element name must match the element selector defined by the last -ELEMENT option.

The -TAG option restricts only on the class of item being reported; e.g. if one is reporting properties of elements, then only elements whose "tag" matches :TAG_SEL will be reported or if one is reporting classes then only those tag matches :TAG_SEL will be reported.

Occasionally, one does not want the last selection criteria to remain active. This is achieved with the -SELALL option, which resets all previous selection criteria, and selects everything in the database.