DISPLAY MANAGER
DISPLAY_MANAGER is a F$GETQUI() function that returns information about a specific 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 queues.
Format
F$GETQUI("DISPLAY_MANAGER", [item],object-id,[flags])
Item
Corresponds to a $GETQUI system service output item code. The following items are valid for DISPLAY_MANAGER:
| Item | Type Returned | Description | Example |
|---|---|---|---|
| MANAGER_NAME | String | The queue manager name |
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" |
| MANAGER_NODES | String | The names of the nodes on which the queue manager may run. |
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 = "*" |
| 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:
|
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" |
| QUEUE_DIRECTORY | String | The device and directory specification of the queue database directory for the queue manager. |
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]" |
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.