user_name

A valid user name (1 through 8 characters for a Recipient name) in the Recipient Tree. A synonym (1 through 20 characters) from the Recipient Tree can also be used. Optionally, an * (asterisk) can be specified; this precludes using an asterisk in the LVL field. Mandatory.

For more information, see Generic User Name.

LVL

A 2-character Recipient Tree level code. Optionally, * (asterisk) can be specified; this precludes using an asterisk in the USER NAME field. Optional.

LINE

A 5-digit number from 00001 though 32768. Leading zeros must be supplied. LINE can be specified only if * is used in the USER NAME or LVL field. Optional.

• If USER is set to * and LINE is blank, the user name is taken from the line containing the WHEN string.
• For ON TRNCLASS or ON TRNDSN the first digit of the line number is set according to the orientation. For more information see Creating a Text Report from the Print Stream Report (Second Temporary Decollation Definition).

Note: If the comparison operator in the STRING subparameter of the WHEN parameter is set to .NE., do not use a blank value for the LINE subparameter. This is because the .NE. setting indicates that a specific line cannot be determined. For more details see Table 242 in General Information.

COL

Column range from which to extract the recipient user ID.

• from_col–A 5-digit number from 00001 though 32768. Leading zeros must be supplied. This parameter is mandatory when * is used.
• to_col–A 5-digit number from 00001 though 32768, which must be greater than or equal to from_col. Leading zeros must be supplied. This parameter is mandatory when * is used.

S

A 1-character search code that indicates where to search for certain decollation information. Valid values:

• A—Search is performed on the Active User Report list. (Installation default. It can be changed by the INCONTROL administrator.)
• P—Search is performed on the Permanent User Report list.
• N—No search is performed.

For more information about parameter S(earch), see "General Information" below.

T

Type code that indicates how to handle report pages if the user is not in the Recipient Tree or if the same pages were sent to the user’s descendants in the Recipient Tree. Valid values:

• U—Unconditional. The user receives the report page if the user’s name is in the Recipient Tree.
• C—Conditional. The user receives the report page if the user’s name is in the Recipient Tree and the user’s descendants do not receive the page.
• A—Accept all users. The user receives the report page even if the user’s name is not in the Recipient Tree. For more information, see Decollation Without the Recipient Tree.
• B—Bypass user examination. The user receives the report without examination of the Recipient Tree
• blank—If USER is set to *, the default is C (Conditional). Otherwise, the default is U (Unconditional).

SYNONYM

Code that indicates whether the report is sent to the first user or to all users with the specified synonym. Optional. Valid values:

• F (First)—Recipient Tree is searched until the first user with the specified synonym is found. Report pages are only sent to that user. Default.
• A (All)—Report pages are sent to all users at the specified level (if any) with the specified synonym.

CONCAT

Yes/No flag that indicates whether or not two or more line or column ranges must be concatenated to produce the user name. Optional. Valid values:

• Y (Yes)—Additional USER lines (for specifying user name strings or line or column ranges) are displayed until a blank USER line is specified.
• N (No)—Concatenation is not required. Default.