DISPLAY SERVICE on Multiplatforms

Use the MQSC command DISPLAY SERVICE to display information about a service.


Use MQSC commands

For information on how we use MQSC commands, see Performing local administration tasks using MQSC commands.

Synonym:

DISPLAY SERVICE

DISPLAY SERVICE ( generic-service-name ) WHERE(FilterCondition) ALL requested attrsRequested attrsALTDATEALTTIMECONTROLDESCRSERVTYPESTARTARGSTARTCMDSTDERRSTDOUTSTOPARGSTOPCMD


Keyword and parameter descriptions for DISPLAY SERVICE

You must specify a service for which you want to display information. We can specify a service by using either a specific service name or a generic service name. By using a generic service name, we can display either:

  • Information about all service definitions, by using a single asterisk (*), or
  • Information about one or more service that match the specified name.

    ( generic-service-name )
    The name of the service definition for which information is to be displayed. A single asterisk (*) specifies that information for all service identifiers is to be displayed. A character string with an asterisk at the end matches all services with the string followed by zero or more characters.

    WHERE
    Specify a filter condition to display information for those listeners that satisfy the selection criterion of the filter condition. The filter condition is in three parts: filter-keyword, operator, and filter-value:

      filter-keyword
      Any parameter that can be used to display attributes for this DISPLAY command.
      operator
      This is used to determine whether a listener satisfies the filter value on the given filter keyword. The operators are:

        LT
        Less than

        GT
        Greater than

        EQ
        Equal to

        NE
        Not equal to

        LE
        Less than or equal to

        GE
        Greater than or equal to

        LK
        Matches a generic string that you provide as a filter-value

        NL
        Does not match a generic string that you provide as a filter-value

      filter-value
      The value that the attribute value must be tested against using the operator. Depending on the filter-keyword, this can be:

      • An explicit value, that is a valid value for the attribute being tested.

        We can use operators LT, GT, EQ, NE, LE or GE only. However, if the attribute value is one from a possible set of values on a parameter (for example, the value MANUAL on the CONTROL parameter), we can only use EQ or NE.

        .
      • A generic value. This is a character string. with an asterisk at the end, for example ABC*. If the operator is LK, all items where the attribute value begins with the string (ABC in the example) are listed. If the operator is NL, all items where the attribute value does not begin with the string are listed.

        We cannot use a generic filter-value for parameters with numeric values or with one of a set of values.

    ALL
    Specify this to display all the service information for each specified service. If this parameter is specified, any parameters that are requested specifically have no effect; all parameters are still displayed.

    This is the default if we do not specify a generic identifier, and do not request any specific parameters.

    On z/OS® this is also the default if you specify a filter condition using the WHERE parameter, but on other platforms only requested attributes are displayed.


Requested parameters

Specify one or more attributes that define the data to be displayed. The attributes can be specified in any order. Do not specify the same attribute more than once.

    ALTDATE
    The date on which the definition was last altered, in the form yyyy-mm-dd.

    ALTTIME
    The time at which the definition was last altered, in the form hh.mm.ss.

    CONTROL
    How the service is to be started and stopped:

      MANUAL
      The service is not to be started automatically or stopped automatically. It is to be controlled by use of the START SERVICE and STOP SERVICE commands.
      QMGR
      The service is to be started and stopped at the same time as the queue manager is started and stopped.
      STARTONLY
      The service is to be started at the same time as the queue manager is started, but is not requested to stop when the queue manager is stopped.

    DESCR
    Descriptive comment.

    SERVTYPE
    Specifies the mode in which the service is to run:

      COMMAND
      A command service object. Multiple instances of a command service object can be executed concurrently. We cannot monitor the status of command service objects.
      SERVER
      A server service object. Only one instance of a server service object can be executed at a time. The status of server service objects can be monitored using the DISPLAY SVSTATUS command.

    STARTARG
    Specifies the arguments to be passed to the user program at queue manager startup.

    STARTCMD
    Specifies the name of the program which is to run.

    STDERR
    Specifies the path to the file to which the standard error (stderr) of the service program is to be redirected.

    STDOUT
    Specifies the path to the file to which the standard output (stdout) of the service program is to be redirected.

    STOPARG
    Specifies the arguments to be passed to the stop program when instructed to stop the service.

    STOPCMD
    Specifies the name of the executable program to run when the service is requested to stop.

For more details of these parameters, see DEFINE SERVICE on Multiplatforms.