DISPLAY MANAGER

From VSI OpenVMS Wiki
Jump to: navigation, search

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:
  • MANAGER_FAILOVER
  • MANAGER_RUNNING
  • MANAGER_START_PENDING
  • MANAGER_STARTING
  • MANAGER_STOPPED
  • MANAGER_STOPPING

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.