START LISTENER

---

Use START LISTENER to start a channel listener.

Notes:

1. On UNIX systems, the command is valid only for AIX, HP-UX, Linux, and Solaris.

2. This command is valid only for channels for which the transmission protocol (TRPTYPE) is TCP.

Synonym: STA LSTR

START LISTENER
 
                   .-CMDSCOPE(' ')------------. (1)
>>-START LISTENER--+--------------------------+----------------->
                   |                     (4)  |
                   '-CMDSCOPE(qmgr-name)------'
 
   .-INDISP(QMGR)-------. (1)
>--+--------------------+--------------------------------------->
   |               (4)  |
   '-INDISP(GROUP)------'
 
>--+---------------------------------+-------------------------->
   |                     (1) (3)     |
   '---IPADDR(ip-address---------)---'
 
>--+-----------------------------+------------------------------>
   |                 (1) (2)     |
   '---LUNAME(string---------)---'
 
                (1) (3)                           (1)
   .-PORT(1414)-----------------.  .-TRPTYPE(TCP)-------.
>--+----------------------------+--+--------------------+------><
   |                   (1) (3)  |  |               (1)  |
   '-PORT(port-number)----------'  '-TRPTYPE(LU62)------'
 
 

Notes:

1. Valid only on z/OS.

2. Valid only for TRPTYPE(LU62).

3. Valid only for TRPTYPE(TCP).

4. Valid only on full function WebSphere MQ for z/OS when the queue manager is a member of a queue-sharing group.

 

Parameter descriptions

CMDSCOPE

This parameter applies to z/OS only and specifies how the command is executed when the queue manager is a member of a queue-sharing group.

' '

The command is executed on the queue manager on which it was entered. This is the default value.

qmgr-name

The command is executed on the queue manager you specify, providing the queue manager is active within the queue-sharing group.

You can specify a queue manager name, other than the queue manager on which the command was entered, only if you are using a queue-sharing group environment and if the command server is enabled.

INDISP

Specifies the disposition of the inbound transmissions that are to be handled. The possible values are:

QMGR

Listen for transmissions directed to the queue manager. This is the default.

GROUP

Listen for transmissions directed to the queue-sharing group. This is allowed only if there is a shared queue manager environment.

IPADDR

IP address for TCP/IP specified in dotted decimal or alphanumeric form. This is valid only if the transmission protocol (TRPTYPE) is TCP/IP.

LUNAME(string)

The symbolic destination name for the logical unit as specified in the APPC side information data set. (This LU must be the same LU that is specified in the channel initiator parameters to be used for outbound transmissions.)

This parameter is valid only for channels with a transmission protocol (TRPTYPE) of LU 6.2. A START LISTENER command that specifies TRPTYPE(LU62) must also specify the LUNAME parameter.

This parameter is supported only on z/OS.

PORT(port-number)

Port number for TCP. This is valid only if the transmission protocol (TRPTYPE) is TCP.

This parameter is supported only on z/OS.

TRPTYPE

Transport type to be used. This is optional.

TCP

TCP. This is the default if TRPTYPE is not specified.

LU62

SNA LU 6.2.

This parameter is supported only on z/OS.

 

WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.

 

IBM is a trademark of the IBM Corporation in the United States, other countries, or both.