WRKMQMSVC (Work with MQ Service object)

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

Table 1. Command 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.

You 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:

*DFT: Use the default queue manager.
queue-manager-name: The name of a message queue manager.

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.