Work with MQ Service object (WRKMQMSVC)

    Where allowed to run
    All environments (*ALL)

    Threadsafe
    Yes

The Work with MQ Service objects (WRKMQMSVC) command allows you to work with multiple service objects that are defined on the local queue manager.

This enables you to start, stop, change, copy, create, delete, display, and display and change authority to an MQ service object.


Parameters

Keyword Description Choices Notes
SVCNAME Service name Character value, *ALL Optional, Positional 1
MQMNAME Message Queue Manager name Character value, *DFT Optional, Positional 2
WHERE Filter command Single values: *NONE Other values: Element list Optional, Positional 3
Element 1: Filter keyword *ALTDATE, *ALTTIME, *CONTROL, *ENDARG, *ENDCMD, *STDERR, *STDOUT, *STRARG, *STRCMD, *TEXT, *TYPE
Element 2: Filter operator *GT, *LT, *EQ, *NE, *GE, *LE, *LK, *NL, *CT, *EX, *CTG, *EXG
Element 3: Filter value Character value


Service name (SVCNAME)

>

The name or names of the service objects.

The possible values are:

    *ALL or *
    All service objects are selected.

    generic-service-name
    The generic name of the service objects. A generic name is a character string followed by an asterisk (*). For example ABC*, it selects all service objects having names that start with the character string.

    You are recommended to specify the name required within quotation marks. Using this format ensures that your selection is precisely what you entered.

    We cannot select all the uppercase and lowercase versions of a generic name on a single panel, without requesting all the names.

    service-name
    Specify the name of a single service object.


Message Queue Manager name (MQMNAME)

>

Specifies the name of the queue manager.

The possible values are:


Filter command (WHERE)

>

This parameter can be used to selectively display only those service objects with particular service attributes.

The parameter takes three arguments, a keyword, an operator and a value.

Generic strings are allowed for values which are names.

The operator can take one of the following values:

    *GT
    Greater than.

    Applicable to integer and non-generic string values.

    *LT
    Less than.

    Applicable to integer and non-generic string values

    *EQ
    Equal to.

    Applicable to integer and non-generic string values.

    *NE
    Not equal to.

    Applicable to integer and non-generic string values.

    *GE
    Greater than or equal to.

    Applicable to integer and non-generic string values.

    *LE
    Less than or equal to.

    Applicable to integer and non-generic string values.

    *LK
    Like.

    Applicable to generic string values.

    *NL
    Not like.

    Applicable to generic string values.

    *CT
    Contains.

    Applicable to non-generic list values.

    *EX
    Excludes.

    Applicable to non-generic list values.

    *CTG
    Contains generic.

    Applicable to generic list values.

    *EXG
    Excludes generic.

    Applicable to generic list values.

The keyword can take one of the following values:

    *ALTDATE
    The date on which the definition or information was last altered.

    The filter value is the date in the form yyyy-mm-dd.

    *ALTTIME
    The time at which the definition or information was last altered.

    The filter value is the time in the form hh:mm:ss.

    *CONTROL
    Whether the service is started and stopped with the queue manager.

    The filter value is one of the following:

      *MANUAL
      The service is not automatically started or stopped.

      *QMGR
      The service is started and stopped as the queue manager is started and stopped.

      *STARTONLY
      The service is started as the queue manager is started, is not be requested to stop when the queue manager is stopped.

    *ENDARG
    The arguments passed to the end program when the service is requested to stop.

    The filter value is the arguments string.

    *ENDCMD
    The name of the executable to run when the service is requested to stop.

    The filter value is the program name string.

    *STDERR
    The standard error path.

    The filter value is the path name.

    *STDOUT
    The standard output path.

    The filter value is the path name.

    *STRARG
    The arguments passed to the program at startup.

    The filter value is the arguments string.

    *STRCMD
    The name of the program to run.

    The filter value is the program name string.

    *TEXT
    Descriptive comment.

    The filter value is the text description of the service.

    *TYPE
    Mode in which to run service.

    The filter value is one of the following:

      *CMD
      When started the command is executed but no status is collected or displayed.

      *SVR
      The status of the executable started is monitored and displayed.


Examples

>

None


Error messages

>

Unknown

Parent topic: CL commands reference for IBM i