Jane.doe at 09:14, 26 November 2019

2019-11-26T09:14:32Z

← Older revision		Revision as of 09:14, 26 November 2019
Line 5:		Line 5:

	==Item==		==Item==
	Corresponds to a [[$GETQUI output item codes\|$GETQUI system service output item code]]. The ~~item argument specifies~~ the ~~kind~~ of ~~information you want returned about~~ a ~~particular queue~~, ~~job~~, ~~file~~, ~~form, or characteristic.~~		Corresponds to a [[$GETQUI output item codes\|$GETQUI system service output item code]]. The following items are valid for DISPLAY_CHARACTERISTIC:
			* CHARACTERISTIC_NAME: the name of the characteristic (for example, for a characteristic defined with DEFINE/CHARACTERISTIC BLUEINK 5, CHARACTERISTIC_NAME is "BLUEINK")
			* CHARACTERISTIC_NUMBER: the number of the characteristic (for example, for a characteristic defined with DEFINE/CHARACTERISTIC BLUEINK 5, CHARACTERISTIC_NUMBER is "5")

	==Object Id==		==Object Id==

Jane.doe: Created page with "DISPLAY_CHARACTERISTIC is an operation that can be specified in the function field of the F$GETQUI() lexical function. It returns information about a specific characterist..."

2019-11-26T09:10:09Z

Created page with "DISPLAY_CHARACTERISTIC is an operation that can be specified in the function field of the F$GETQUI() lexical function. It returns information about a specific characterist..."

New page

DISPLAY_CHARACTERISTIC is an operation that can be specified in the function field of the [[F$GETQUI()]] lexical function. It returns information about a specific characteristic definition or the next characteristic definition in a wildcard operation. A characteristic is any attribute of a print or batch job that is relevant to your environment. For example, characteristics for a printer could refer to the color of the ink, the type of paper, or the location of the printer. Characteristics are created with DEFINE/CHARACTERISTIC, assigned to queues with SET QUEUE/CHARACTERISTIC and to jobs with PRINT/CHARACTERISTIC.

=Syntax=
F$GETQUI("DISPLAY_CHARACTERISTIC", <nowiki>[</nowiki>[[#Item|item]]<nowiki>]</nowiki>,[[#Object Id|object-id]],<nowiki>[</nowiki>[[#Flags|flags]]<nowiki>]</nowiki>)

==Item==
Corresponds to a [[$GETQUI output item codes|$GETQUI system service output item code]]. The item argument specifies the kind of information you want returned about a particular queue, job, file, form, or characteristic.

==Object Id==
Corresponds to the $GETQUI system service QUI$SEARCH_NAME, QUI$_SEARCH_NUMBER, and QUI$_SEARCH_JOB_NAME input item codes. The object-id argument specifies either the name or the number of an object (for example, a specific queue name, job name, or form number) about which F$GETQUI is to return information. The asterisk (*) and the percent sign (%) wildcard characters are allowed.

==Flags==
Flags allowed for DISPLAY_CHARACTERISTIC:
* FREEZE_CONTEXT: when in wildcard mode, prevents advance of wildcard context to the next object. If you do not specify this flag, the context is advanced to the next object.
* WILDCARD: establishes and saves a context. Because the context is saved, the next operation can be performed based on that context.

=Example=
<nowiki>
SMAN43$ define/characteristic redink 3
SMAN43$ s = f$getqui("DISPLAY_CHARACTERISTIC","CHARACTERISTIC_NAME",-
_SMAN43$ "3")
SMAN43$ sh sym s
S = "REDINK"
</nowiki>

DISPLAY CHARACTERISTIC - Revision history

Jane.doe at 09:14, 26 November 2019

Jane.doe: Created page with "DISPLAY_CHARACTERISTIC is an operation that can be specified in the function field of the F$GETQUI() lexical function. It returns information about a specific characterist..."