Jane.doe: Created page with "'''DISPLAY_MANAGER''' is a F$GETQUI() function that returns information about a specific queue manager or the next queue manager in a wildcard operation...."

2019-11-26T13:25:49Z

Created page with "'''DISPLAY_MANAGER''' is a F$GETQUI() function that returns information about a specific queue manager or the next queue manager in a wildcard operation...."

New page

'''DISPLAY_MANAGER''' is a [[F$GETQUI()]] function that returns information about a specific [[Queue manager|queue manager]] or the next queue manager in a wildcard operation. A queue manager is a process that controls the activity of one or more [[Queue|queues]].

=Format=
F$GETQUI("DISPLAY_MANAGER", <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 following items are valid for DISPLAY_MANAGER:

{| class="wikitable"
! colspan="col" | Item
! colspan="col" | Type Returned
! colspan="col" | Description
! colspan="col" | Example
|-
| MANAGER_NAME
| String
| The queue manager name
|
<nowiki>
SMAN43$ a = f$getqui("DISPLAY_MANAGER","MANAGER_NAME","SYS$QUEUE_MANAGER")
SMAN43$ show sym a
A = "SYS$QUEUE_MANAGER"
SMAN43$ a = f$getqui("DISPLAY_MANAGER","MANAGER_NAME","MYQUEUE_MANAGER")
SMAN43$ show sym a
A = "MYQUEUE_MANAGER"
</nowiki>
|-
| MANAGER_NODES
| String
| The names of the nodes on which the queue manager may run.
|
<nowiki>
SMAN43$ a = f$getqui("DISPLAY_MANAGER","MANAGER_NODES","SYS$QUEUE_MANAGER")
SMAN43$ show sym a
A = "SMAN43,SMAN45,*"
SMAN43$ a = f$getqui("DISPLAY_MANAGER","MANAGER_NODES","MYQUEUE_MANAGER")
SMAN43$ show sym a
A = "*"

</nowiki>
|-
| MANAGER_STATUS
| Integer
| The specified queue manager's status flags. To find the settings of each bit in the field, use one of the following items in place of MANAGER_STATUS:
* MANAGER_FAILOVER
* MANAGER_RUNNING
* MANAGER_START_PENDING
* MANAGER_STARTING
* MANAGER_STOPPED
* MANAGER_STOPPING
|
<nowiki>
SMAN43$ SH QUEUE/MANAGER SYS$QUEUE_MANAGER /FULL
Master file: CLUSTER$FILES:[CLUSTER_FILES]QMAN$MASTER.DAT;

Queue manager SYS$QUEUE_MANAGER, running, on SMAN43::
/ON=(SMAN43,SMAN45,*)
Database location: CLUSTER$FILES:[CLUSTER_FILES]

SMAN43$ a = f$getqui("DISPLAY_MANAGER","MANAGER_STATUS","SYS$QUEUE_MANAGER")
SMAN43$ show sym a
A = 4 Hex = 00000004 Octal = 00000000004
SMAN43$ a = f$getqui("DISPLAY_MANAGER","MANAGER_FAILOVER","SYS$QUEUE_MANAGER")
SMAN43$ show sym a
A = "FALSE"
SMAN43$ a = f$getqui("DISPLAY_MANAGER","MANAGER_RUNNING","SYS$QUEUE_MANAGER")
SMAN43$ SHOW SYM A
A = "TRUE"
SMAN43$ a = f$getqui("DISPLAY_MANAGER","MANAGER_START_PENDING","SYS$QUEUE_MANAGER")
SMAN43$ SHOW SYM A
A = "FALSE"
SMAN43$ a = f$getqui("DISPLAY_MANAGER","MANAGER_STARTING","SYS$QUEUE_MANAGER")
SMAN43$ SHOW SYM A
A = "FALSE"
SMAN43$ a = f$getqui("DISPLAY_MANAGER","MANAGER_STOPPING","SYS$QUEUE_MANAGER")
SMAN43$ SHOW SYM A
A = "FALSE"
SMAN43$ a = f$getqui("DISPLAY_MANAGER","MANAGER_STOPPED","SYS$QUEUE_MANAGER")
SMAN43$ SHOW SYM A
A = "FALSE"
</nowiki>
|-
| QUEUE_DIRECTORY
| String
| The device and directory specification of the queue database directory for the queue manager.
|
<nowiki>

SMAN43$ SH QUEUE/MANAGER SYS$QUEUE_MANAGER /FULL
Master file: CLUSTER$FILES:[CLUSTER_FILES]QMAN$MASTER.DAT;

Queue manager SYS$QUEUE_MANAGER, running, on SMAN43::
/ON=(SMAN43,SMAN45,*)
Database location: CLUSTER$FILES:[CLUSTER_FILES]

SMAN43$ a = f$getqui("DISPLAY_MANAGER","QUEUE_DIRECTORY","SYS$QUEUE_MANAGER")
SMAN43$ SHOW SYM A
A = "CLUSTER$FILES:[CLUSTER_FILES]"

SMAN43$ sh queue/manager MYQUEUE_MANAGER /full
Master file: CLUSTER$FILES:[CLUSTER_FILES]QMAN$MASTER.DAT;

Queue manager MYQUEUE_MANAGER, stopped
/ON=(*)
Database location: SYS$COMMON:[SYSEXE]

SMAN43$ a = f$getqui("DISPLAY_MANAGER","QUEUE_DIRECTORY", "MYQUEUE_MANAGER")
SMAN43$ SHOW SYM A
A = "SYS$COMMON:[SYSEXE]"
</nowiki>
|}

==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==
The following flags are available for DISPLAY_MANAGER:
* 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.

DISPLAY MANAGER - Revision history

Jane.doe: Created page with "'''DISPLAY_MANAGER''' is a F$GETQUI() function that returns information about a specific queue manager or the next queue manager in a wildcard operation...."