The main panel is called the Message Channel List panel; for an example of it, see Figure 51. It has a menu bar with choices you can pull down to reveal the various options you can select for these choices. The work area of the panel is used to present a selection column, and three other columns showing the:
Figure 51. The Message Channel List panel
+--------------------------------------------------------------------------------+
| Selected Edit View Help |
|------------------------------------------------------------------------------ |
|MCSELB IBM WebSphere MQ for z/OS - Message Channel List VICY14 |
| |
|Select a channel name. Then select an action. |
| More: + |
| Channel name Type Sysid |
| VC13.TO.VC14.REQSER REQUESTER VR14 |
| VC13.2.VC14.JAC3 RECEIVER VR14 |
| VC13.2.VC14.MROSER REQUESTER VR14 |
| VC13.2.VC14.REQSEND REQUESTER VR14 |
| VC13.2.VC14.SENDER SENDER VR14 |
| VICY13.TO.VICY14 RECEIVER VR14 |
| VICY13.TO.VICY14.CB REQUESTER VR14 |
| VICY13.TO.VICY14.NS RECEIVER VR14 |
| VICY13.TO.VICY14.NSR RECEIVER VR14 |
| VICY13.TO.VICY14.NS2 RECEIVER VR14 |
| VICY13.TO.VICY14.SER REQUESTER VR14 |
| VICY13.TO.VICY14.SVR REQUESTER VR14 |
| |
|(C) Copyright IBM Corporation 1993, 2002. All rights reserved. |
| |
|F1=Help F3=Exit F5=Refresh now F6=Find F7=Bkwd F8=Fwd F10=Menu Bar |
|F12=Cancel |
+--------------------------------------------------------------------------------+
The following sections describe the function, Enter, and Clear keys, as well as what happens if you press any unassigned keys associated with this panel.
The function keys control the use of the panel. They are listed
below, together with their purpose.
| F1 | Call help panels |
| F3 | Exit from the panel and the program |
| F5 | Refresh the screen fields with current data |
| F6 | Find a particular channel name |
| F7 | Scroll the panel backward to display more channels |
| F8 | Scroll the panel forward to display more channels |
| F10 | Move the cursor to the menu bar |
| F12 | Cancel pull-down menus or secondary windows, if any, otherwise as F3 |
Pressing the Enter key while the cursor is on a menu-bar choice results in the pull-down menu for that choice appearing.
Pressing the Enter key while the cursor is not on a menu-bar choice and a channel selection has been made selects the default option, Display Settings.
Pressing the Enter key while the cursor is not on a menu-bar choice and no channel selection has been made results in the panel being redisplayed.
If you find while typing that what you have typed is not correct, press the Clear key on your terminal to revert all the input fields to their previous state.
For individual fields, use the 'Erase EOF', or 'Ctrl Delete', depending upon the type of terminal you are using.
If you press a function key, or an attention key that has not been assigned an action, a warning message is displayed that states that the key is invalid.
To select a channel, begin at the Message Channel List panel:
If you try to select more than one channel, only the first one you select is valid.
When a channel has been selected, function key F10 moves the cursor to the
menu bar (see Table 36). The menu-bar choices are:
Table 36. Message Channel List menu-bar choices
| Selected | Edit | View | Help |
Selecting each of these choices causes its pull-down menu to be displayed (see Figure 52).
When you select an option that requires further information, such as a channel name, an action window appears with an entry field for the data.
In general, any incorrect input from the keyboard results in a warning message being issued.
Figure 52. The Message Channel List panel pull-down menus
+--------------------------------------------------------------------------------+
| Selected Edit View Help |
| +--------------------------+-------------------------------------------------- |
| | 1. Start |r z/OS - Message Channel List VICY14 |
| | 2. Stop... | |
| | 3. Resync |select an action. |
| | 4. Reset... | More: - + |
| | 5. Resolve... |e Sysid |
| | 6. Display Status |UESTER VR14 |
| | 7. Display Settings |EIVER VR14 |
| | 8. Ping... |UESTER VR14 |
| | 9. Exit F3 |UESTER VR14 |
| +--------------------------+DER VR14 |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
| Selected Edit View Help |
| ------------------ +--------------------------+------------------------------- |
| MCSELB IBM W | 1. Copy... | Channel List VICY14 |
| | 2. Create... | |
| Select a channel n | 3. Alter | |
| | 4. Delete... | More: - + |
| Channel name | 5. Find... F6 | |
| VC13.TO.VC14.SEQ +--------------------------+ |
| VC13.2.VC14.JAC3 RECEIVER VR14 |
| VC13.2.VC14.MROSER REQUESTER VR14 |
| VC13.2.VC14.REQSEND REQUESTER VR14 |
| VC13.2.VC14.SENDER SENDER VR14 |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
| Selected Edit View Help |
| --------------------------------- +------------------------+------------------ |
| MCSELB IBM WebSphere MQ for | 1. Include all | VICY14 |
| | 2. Include... | |
| Select a channel name. Then selec | 3. Refresh now F5 | |
| +------------------------+ More: - + |
| Channel name Type Sysid |
| VC13.TO.VC14.SEQSER REQUESTER VR14 |
| VC13.2.VC14.JAC3 RECEIVER VR14 |
| VC13.2.VC14.MROSER REQUESTER VR14 |
| VC13.2.VC14.REQSEND REQUESTER VR14 |
| VC13.2.VC14.SENDER SENDER VR14 |
+--------------------------------------------------------------------------------+
+--------------------------------------------------------------------------------+
| Selected Edit View Help |
| ----------------------------------------------- +---------------------------+- |
| MCSELB IBM WebSphere MQ for z/OS - Message| 1. Using help | |
| | 2. General help | |
| Select a channel name. Then select an action. | 3. Keys help | |
| | 4. Tutorial | |
| Channel name Type Sysid | 5. Product Info | |
| VC13.TO.VC14.SEQSER REQUESTER VR14 +---------------------------+ |
| VC13.2.VC14.JAC3 RECEIVER VR14 |
| VC13.2.VC14.MROSER REQUESTER VR14 |
| VC13.2.VC14.REQSEND REQUESTER VR14 |
| VC13.2.VC14.SENDER SENDER VR14 |
+--------------------------------------------------------------------------------+
To create a new channel, begin at the Message Channel List panel:
Notes:
You are presented with the appropriate Settings panel for the type of channel you have chosen. Fill in the fields with the information you have gathered previously, and select the Save option from the Channel pull-down menu.
You are provided with help in deciding on the content of the various fields in the descriptions of the channel definition panels in the following sections of this chapter.
To alter an existing channel, begin at the Message Channel List panel:
You are presented with the appropriate Settings panel for the channel you have chosen. Alter the fields with the information you have gathered previously, and select the Save option from the Channel pull-down menu.
You are provided with help in deciding on the content of the various fields in the descriptions of the channel definition panels in the following sections of this chapter, and in the contextual help panels.
To browse the settings of a channel, begin at the Message Channel List panel:
If you try to select more than one channel, only the first one you select is valid.
This results in the respective Settings panel being displayed with details of the current settings for the channel, but with the fields protected against user input.
If the Channel pull-down menu is selected from the menu bar, the Save option is unavailable and this is indicated by an asterisk (*) in place of the first letter, as shown in Figure 53.
Figure 53. The Channel pull-down menu
+--------------------------------------------------------------------------------+
| Channel Help |
| +------------------+---------------------------------------------------------- |
| | 1. *ave |13.2.VC14.SENDER - Settings VICY14 |
| | 2. Exit F3 | |
| +------------------+ |
| More: + |
| Channel type . . . . . . : SENDER |
| |
| Target system id . . . . : |
| Transmission queue name . : JACK |
| Batch size . . . . . . . : 0001 |
| Sequence number wrap . . : 0999999 |
+--------------------------------------------------------------------------------+
To rename a message channel, begin at the Message Channel List panel:
If you decide to rename a message channel, ensure that both ends of the channel are renamed at the same time.
The options available in the Selected pull-down menu are:
| Menu option | Description |
|---|---|
| Start | Starts the selected channel. |
| Stop | Requests the channel to close down, immediately, or controlled. |
| Resync | Requests the channel to re-synchronize with the remote end, and then close. No messages are sent. |
| Reset | Requests the channel to reset the sequence numbers on this end of the link. The numbers must be equal at both ends for the channel to start. |
| Resolve | Requests the channel to resolve in doubt messages without establishing connection to the other end. |
| Display Status | Displays the current status of the channel. |
| Display Settings | Displays the current settings for the channel. |
| Ping | Exchanges a data message with the remote end. |
| Exit | Exits from the program. |
The Start option is available for sender and requester channels, and moreover should not be necessary where a sender channel has been set up with queue manager triggering. For the method of setting up triggering, see How to trigger channels.
When a server channel has been fully defined as a sender, then the same applies as for sender channels.
When you choose the Start option, an EXEC CICS START call is issued to the MCA, which reads the channel definition file and opens the transmission queue. A channel startup sequence is executed which remotely starts the corresponding MCA of the receiver or server channel. When they are running, the sender and server processes await messages arriving on the transmission queue and transmit them as they arrive.
Using the Start option always causes re-synchronization where necessary.
For the start to succeed:
It is not necessary that:
A message is returned to the panel confirming that the request to start a channel has been accepted. For confirmation that the start command has succeeded, check the system console for the CICS system hosting the MCA, or the transient data queue.
The sender, server, and requester channel transactions can be started automatically by CICS, if necessary. This is achieved by arranging for the MCA CICS transaction to be started by the CICS system in the required way. This is similar to the triggering startup in that the MCA is passed the required information in a trigger message. For example, it can be customized to start at a certain time every day, or at regular intervals. When started, it retrieves its channel definition and responds accordingly.
If triggering is to be used to start a channel when messages arrive on the associated transmission queue, use WebSphere MQ for z/OS operations and control panels or MQSC commands to set it up in accordance with the details on triggering in the WebSphere MQ Application Programming Guide, after having collected all the planning data.
Trigger control is exercised by means of the trigger control parameter in the transmission queue definition. You need to set up the transmission queue for the channel, specifying TRIGGER, define an initiation queue, and define a process. For example:
DEFINE QLOCAL(MYXMITQ) USAGE(XMITQ) TRIGGER INITQ(MYINITQ) +
TRIGTYPE(FIRST) PROCESS(MYPROCESS)
DEFINE QLOCAL(MYINITQ)
DEFINE PROCESS(MYPROCESS) APPLTYPE(CICS) APPLICID(CKSG) +
USERDATA(MYCHANNEL)
On the process definition:
Following the definitions, the long-running trigger process, CKTI, must be started to monitor the initiation queue:
CKQC STARTCKTI MYINITQ
CKTI waits for trigger messages from the initiation queue, and starts an instance of CKSG for the sender channel in response to the trigger messages. If the channel experiences problems, the trigger control parameter on the transmission queue definition is set to NOTRIGGER by the MCA, and the transmission queue is set to GET(DISABLED). After diagnosis and correction and before you can restart triggering, you must reset the TRIGGER parameter, for example with the WebSphere MQ for z/OS operations and control panels, and must reset the transmission queue to GET(ENABLED).
Use the Stop option to request the channel to stop activity.
The Stop option presents an action window to allow you to confirm your intention to stop the channel, for all four types of channel. For sender and server channels only, you can select the type of stop you require: IMMEDIATE, or QUIESCE. See Figure 54 and Figure 55.
Figure 54. Sender/server Stop action window
+--------------------------------------------------------------------------------+
| Selected Edit View Help |
| +--------------------------+-------------------------------------------------- |
| | 2 1. Start |r z/OS - Message Channel List VICY03 |
| | 2. Stop... | |
| | 3. Resy +--------------------------------------------------+ |
| | 4. Rese | VC13.2.VC14 - Stop | More: |
| | 5. Reso | | |
| | 6. Disp | Select one. Then press Enter. | |
| | 7. Disp | | |
| | 8. Ping | Channel type . . . : SENDER | |
| | 9. Exit | | |
| +---------- | _ 1. Stop (quiesce) | |
| BREN.VR04 | 2. Stop (immediate) | |
| CRIS.VR01 | | |
| CRIS.VR01 | F1=Help F12=Cancel | |
| CRIS.VR03 +--------------------------------------------------+ |
| CRIS.VR03.TO.VR04 SENDER |
| TEST.REQUESTER REQUESTER |
| TEST.SERVER SERVER |
| |
| |
| |
| F1=Help F3=Exit F5=Refresh now F6=Find F7=Bkwd F8=Fwd F10=Menu Bar |
| F12=Cancel |
| |
| |
+--------------------------------------------------------------------------------+
This choice forces the channel to close down immediately, if necessary, without completing the current batch of messages, but an attempt is made to syncpoint with the other end of the channel.
Stop immediate is implemented by setting the channel's transmission queue to GET DISABLED. This means that if multiple channels are active against a transmission queue, issuing a stop immediate against one of the channels causes all channels to be stopped. You need to reset this queue to GET ENABLED using the WebSphere MQ for z/OS operations and control panels or MQSC commands before you attempt to restart the channels.
For more information, see the Stopping and quiescing channels.
Figure 55. Requester/receiver Stop action window
+--------------------------------------------------------------------------------+
| Selected Edit View Help |
| +--------------------------+-------------------------------------------------- |
| | 2 1. Start |r z/OS - Message Channel List VICY03 |
| | 2. Stop... | |
| | 3. Resy +--------------------------------------------------+ |
| | 4. Rese | VC13.2.VC14 - Stop | More: |
| | 5. Reso | | |
| | 6. Disp | Select one. Then press Enter. | |
| | 7. Disp | | |
| | 8. Ping | Channel type . . . : RECEIVER | |
| | 9. Exit | | |
| +---------- | _ 1. Stop (quiesce) | |
| BREN.VR04 | 2. *top (immediate) | |
| CRIS.VR01 | | |
| CRIS.VR01 | F1=Help F12=Cancel | |
| CRIS.VR03 +--------------------------------------------------+ |
| CRIS.VR03.TO.VR04 SENDER |
| TEST.REQUESTER REQUESTER |
| TEST.SERVER SERVER |
| |
| |
| |
| F1=Help F3=Exit F5=Refresh now F6=Find F7=Bkwd F8=Fwd F10=Menu Bar |
| F12=Cancel |
| |
| |
+--------------------------------------------------------------------------------+
This choice requests the channel to close down in an orderly way; the current batch of messages is completed, and the syncpoint procedure is carried out with the other end of the channel.
For more information, see Stopping and quiescing channels. For information about restarting stopped channels, see Restarting stopped channels.
A message channel is synchronized when there are no in-doubt messages. That is, the sending channel and the receiving channel are agreed on the current unit of work number. The Resync option is valid for sender and server channels, but server channels must be fully defined. The option allows the operator to request the channel to re-synchronize with the remote end by resolving any in-doubt messages.
There is no panel associated with this option.
It is to be used only where the channel is currently inactive and in-doubt messages exist. The channel starts up, resolves the in-doubt messages, and then terminates. It is not intended that the channel should send messages after the resolution has been completed.
If the re-synchronization of a channel is not successful, you may need to examine the content of the system sequence number queue, using the Display Status option from the Selected pull-down menu on the Message Channel List panel. Compare the sequence numbers, or LUWIDs, at the sending and receiving ends of the channel in order to ascertain what needs to be done to restore synchronization.
It may be necessary to reset sequence numbers, or resolve in-doubt message status, if a channel remains out of synchronization.
If a channel terminates abnormally, the sender may be left in doubt as to whether the receiver has received and committed one message, or a batch of messages. When the channel is restarted, the channel program automatically re-synchronizes before sending any new messages.
However, there are times when you may want to re-synchronize the in-doubt messages, but not send any new ones. For example:
The channel program started by this option establishes a session with a partner. It then exchanges the re-synchronization flows. Then, instead of starting new message traffic, it sends a disconnect flow. The result is that the channel terminates normally, without any in-doubt messages. It is ready to be restarted or reset, as required.
For the re-synchronization to succeed:
A message is returned to the panel indicating whether the request to re-synchronize a channel has succeeded. If the Resync process was not successful, check the system console, or transient data queue (TDQ), for the CICS system hosting the MCA for error messages.
Use the Reset option to request the channel to reset the sequence number. For a view of the Reset Channel Sequence Number action window, see Figure 56. The change must be made separately on each end of the link, with care, and can be done only on inactive channels that have no in-doubt units of work outstanding.
The current sequence number is retrieved and changed to the value requested by the user.
For the reset to succeed:
Notes:
Figure 56. The Reset Channel Sequence Number action window
+--------------------------------------------------------------------------------+
| Selected Edit View Help |
| +--------------------------+-------------------------------------------------- |
| | 4 1. Start |r z/OS - Message Channel List VICY14 |
| | 2. Stop... | |
| | 3. Resy +------------------------------------------------------+ |
| | 4. Rese | Reset Channel Sequence Number |More: + |
| | 5. Reso | | |
| | 6. Disp | Type new sequence number. Then press Enter. | |
| | 7. Disp | | |
| | 8. Ping | Channel name . . . : VC13.2.VC14.SENDER | |
| | 9. Exit | Channel type . . . : SENDER | |
| +---------- | | |
| VC13.2.VC | Sequence number . . . _______ | |
| VC13.2.VC | | |
| VC13.2.VC | F1=Help F12=Cancel | |
| / VC13.2.VC +------------------------------------------------------+ |
| VC14.2.VC13 SENDER VR14 |
+--------------------------------------------------------------------------------+
Use the Resolve option to request a channel to commit or back out in-doubt messages. This may be used when the other end of the link has terminated, and there is no prospect of it returning. Any outstanding units of work need to be resolved with either backout or commit. Backout restores messages to the transmission queue, while Commit discards them.
The Resolve option is needed when the Resync option is not available, or not effective, and messages are held in doubt by a sender or server. The option accepts one of two parameters: Backout or Commit. See Figure 57.
The channel program does not try to establish a session with a partner. Instead, it determines the logical unit of work identifier (LUWID) which represents the in-doubt messages. It then issues, as requested, either:
For the resolution to succeed:
See In-doubt channels for more information.
Figure 57. The Resolve Channel action window
+--------------------------------------------------------------------------------+
| Selected Edit View Help |
| +--------------------------+-------------------------------------------------- |
| | 5 1. Start |r z/OS - Message Channel List VICY14 |
| | 2. Stop... | |
| | 3. Resy +------------------------------------------------------+ |
| | 4. Rese | Resolve Channel |More: - + |
| | 5. Reso | | |
| | 6. Disp | Select one. Then press Enter. | |
| | 7. Disp | | |
| | 8. Ping | Channel name . . . : VC14.2.VC13 | |
| | 9. Exit | Channel type . . . : SENDER | |
| +---------- | | |
| / VC14.2.VC | _ 1. Backout (Restore messages to queue ) | |
| VICY13.TO | 2. Commit (Delete messages from queue) | |
| VICY13.TO | | |
| VICY13.TO | F1=Help F12=Cancel | |
| VICY13.TO +------------------------------------------------------+ |
| VICY13.TO.VICY14.NS2 RECEIVER VR14 |
+--------------------------------------------------------------------------------+
Use the Display Status option to display the current status of the channel. The following information is displayed:
That is, the LUWID number is not available for sender and server channels when sequence numbering is not in effect and the channel is not in doubt
For an example of sender and server status panels, see Figure 58, and for an example of receiver and requester status panels, see Figure 59.
'Not available' status is acceptable when:
Otherwise, if a 'Not available' status is shown in any of the fields, this indicates that an error has occurred, and you should refer to the console log to find the error messages associated with this problem.
Figure 58. An example of a sender channel Display Channel Status window. The server channel Display Channel Status panel looks the same, except that the Channel type field is changed to SERVER.
+--------------------------------------------------------------------------------+
| Selected Edit View Help |
| +--------------------------+-------------------------------------------------- |
| | 6 1. Start |r z/OS - Message Channel List VICY13 |
| | 2. Stop... | |
| | 3. Resy +--------------------------------------------------+ |
| | 4. Rese | Display Channel Status | More: - + |
| | 5. Reso | | |
| | 6. Disp | Channel name . . . : VICY13.TO.VICY14 | |
| | 7. Disp | Channel type . . . : SENDER | |
| | 8. Ping | | |
| | 9. Exit | Status . . . . . . : Inactive | |
| +---------- | Indoubt status . . : Not in-doubt | |
| VICY13.TO | Sequence Number | |
| VICY13.TO | Last sent . . . . : 0001046 | |
| VICY13.TO | Last LUWID . . . . : A81D750042ECAD05 | |
| VICY13.TO | | |
| VICY13.TO | F1=Help F12=Cancel | |
| VICY13.TO.+--------------------------------------------------+ |
| VICY13.TO.VICY15 SERVER VR13 |
| |
| |
| |
| F1=Help F3=Exit F5=Refresh now F6=Find F7=Bkwd F8=Fwd F10=Menu Bar |
| F12=Cancel |
+--------------------------------------------------------------------------------+
Figure 59. An example of a receiver channel Display Channel Status window. The requester channel Display Channel Status window looks the same, except that the Channel type field is changed to REQUESTER.
+--------------------------------------------------------------------------------+
| Selected Edit View Help |
| +--------------------------+-------------------------------------------------- |
| | 6 1. Start |r z/OS - Message Channel List VICY13 |
| | 2. Stop... | |
| | 3. Resy +--------------------------------------------------+ |
| | 4. Rese | Display Channel Status | More: - + |
| | 5. Reso | | |
| | 6. Disp | Channel name . . . : VC14.2.VC13 | |
| | 7. Disp | Channel type . . . : RECEIVER | |
| | 8. Ping | | |
| | 9. Exit | Status . . . . . . : Inactive | |
| +---------- | Sequence Number | |
| VICY13.TO | Last sent . . . . : Not in effect | |
| VICY13.TO | Last LUWID . . . . : A81D750042ECAD05 | |
| VICY13.TO | | |
| VICY13.TO | F1=Help F12=Cancel | |
| VICY13.TO +--------------------------------------------------+ |
| VICY13.TO.VICY14 REQUESTER VR13 |
| VICY13.TO.VICY15 SERVER VR13 |
| |
| |
| |
| F1=Help F3=Exit F5=Refresh now F6=Find F7=Bkwd F8=Fwd F10=Menu Bar |
| F12=Cancel |
+--------------------------------------------------------------------------------+
Use the Display Settings option to display the current definitions for the channel. This choice displays the appropriate panel for the type of channel with the fields displaying the current values of the parameters, and protected against user input:
Protected input is shown with colon characters (:) at the end of field descriptions, and the Save option is not available on the Channel pull-down menu.
You can select this choice from the Message Channel List panel by choosing a channel and pressing Enter, without using the menu bar, ensuring that the cursor is not on the menu bar.
Use the Ping option to exchange a data message with the remote end. This gives you some confidence that the link is available and functioning. It can be issued from sender and server channels only, but server channels must be fully defined.
Ping does not involve the use of transmission queues and target queues. It uses channel definitions, the related CICS communication link, the network setup, and the queue managers at both ends.
The corresponding channel is started at the far side of the link, and performs the startup parameter negotiation.
If an error occurs, an error message is displayed on the panel, and additional messages may be written to the console, or the CICS transient data queue.
The Ping panel offers you the opportunity to enter a message of up to 20 characters to be exchanged across the link. If you do not make use of this, a default message is used.
The result of the message exchange is presented in the Ping panel for you, and this is the returned message text, together with the time the message was sent, and the time the reply was received.
Installations may supply their own applications to exchange particular information, such as system identifiers. Figure 60 shows a view of the Ping action window.
Figure 60. The Ping action window
+--------------------------------------------------------------------------------+
| Selected Edit View Help |
| +--------------------------+-------------------------------------------------- |
| | 1. Start |r z/OS - Message Channel List VICY14 |
| | 2. Stop... | |
| | 3. Resy +--------------------------------------------------+ |
| | 4. Rese | VC14.2.VC13 - Ping | More: - + |
| | 5. Reso | | |
| | 6. Disp | Type ping data. Then press Enter. | |
| | 7. Disp | | |
| | 8. Ping | Ping data . . . . . . TESTING PING | |
| | 9. Exit | | |
| +---------- | Time sent . . . . . : 11:29:37 | |
| / VC14.2.VC | Time received . . . : 11:29:37 | |
| VICY13.TO | | |
| VICY13.TO | F1=Help F12=Cancel | |
| VICY13.TO +--------------------------------------------------+ |
| VICY13.TO.VICY14.NSR RECEIVER VR14 |
+--------------------------------------------------------------------------------+
Use the Exit option to exit the current function: channel settings, help, or message channel list.
A secondary window appears when you try to exit a channel settings panel without first saving any changed definitions. This is a safe exit to prevent inadvertent loss of data. The secondary window is shown in Figure 61.
Figure 61. The Exit confirmation secondary window
+--------------------------------------------------------------------------------+
| Channel Help |
| +------------------+---------------------------------------------------------- |
| | 1. Save |13.2.VC14.SENDER - Settings VICY14 |
| | 2. Exit F3 | |
| +---------- +--------------------------------------------------+ |
| | VC13.2.VC14.SENDER - Exit | More: + |
| Channel typ | | |
| | Channel type . . . : SENDER | |
| Target syst | | |
| Transmissio | The updated channel definition has | |
| Batch size | not been saved. | |
| Sequence nu | | |
| Max message | 2 1. Save and exit. | |
| Max transmi | 2. Exit without saving. | |
| Disconnect | | |
| Transaction | F1=Help F12=Cancel | |
| Connection +--------------------------------------------------+ |
| CICS profile name . . . . . |
+--------------------------------------------------------------------------------+
The options available in the Edit pull-down menu are:
In any of the action windows and settings panels associated with Edit, you can type the channel name in uppercase or lowercase, but it may be converted to uppercase when you press the Enter key, depending upon your Typeterm definition.
Use the Copy option to copy an existing channel. The Copy action window (see Figure 62) enables you to define the new channel name. You can use the characters shown in Create in the name.
Press the Enter key on the Copy action window to display the channel settings panel with details of current system values. You can change any of the new channel settings. You save the new channel definition by selecting Channel from the menu bar, and selecting the Save option from the pull-down menu.
Figure 62. The Copy action window
+--------------------------------------------------------------------------------+
| Selected Edit View Help |
| ------------------ +--------------------------+------------------------------- |
| MCSELB IBM W | 1 1. Copy... | Channel List VICY14 |
| | 2. Create... | |
| Select a ch +------------------------------------------------------+ |
| | VC13.2.VC14.SENDER - Copy |More: - + |
| Channel n | | |
| VC13.TO.V | Type name of new channel. Then press Enter. | |
| VC13.2.VC | | |
| VC13.2.VC | Channel type . . . : SENDER | |
| VC13.2.VC | | |
| / VC13.2.VC | Channel name . . . . ____________________ | |
| VC14.2.VC | | |
| VICY13.TO | F1=Help F12=Cancel | |
| VICY13.TO +------------------------------------------------------+ |
| VICY13.TO.VICY14.NS RECEIVER VR14 |
+--------------------------------------------------------------------------------+
Use the Create option to create a new channel definition from a screen of fields filled with default values supplied by WebSphere MQ for z/OS. Figure 63 shows you where to type the name of the channel, and how to select the type of channel you are creating.
When you press the Enter key, the appropriate channel settings panel is displayed. Type information in all the necessary fields in this panel and then save the definition by selecting Channel from the menu bar, and selecting the Save option from the pull-down menu.
The channel name must be the same at both ends of the channel, and unique
within the network. You can use the following characters in the
name:
| Uppercase | A-Z |
| Lowercase | a-z |
| Numerics | 0-9 |
| Period | '.' |
| Forward slash | '/' |
| Underscore | '_' |
| Percentage sign | '%' |
Figure 63. The Create action window
+--------------------------------------------------------------------------------+
| Selected Edit View Help |
| ------------------ +--------------------------+------------------------------- |
| MCSELB IBM W | 2 1. Copy... | Channel List VICY14 |
| | 2. Create... | |
| Select a ch +------------------------------------------------------+ |
| | Create |More: - + |
| Channel n | | |
| VC13.TO.V | Type name of channel. Select channel type. | |
| VC13.2.VC | Then press Enter. | |
| VC13.2.VC | | |
| VC13.2.VC | Channel name . . . . ____________________ | |
| / VC13.2.VC | | |
| VC14.2.VC | Channel type . . . . _ 1. Sender | |
| VICY13.TO | 2. Server | |
| VICY13.TO | 3. Receiver | |
| VICY13.TO | 4. Requester | |
| VICY13.TO | | |
| VICY13.TO | F1=Help F12=Cancel | |
| VICY13.TO +------------------------------------------------------+ |
| |
+--------------------------------------------------------------------------------+
All panels have default values supplied for some fields. You can change the values when you are creating or copying channels. For examples of the channel definition panels showing the default values, see Figure 64.
Press the Enter key on the Create action window to display the channel settings panel with details of default values.
You can create your own set of channel default values by setting up dummy channels with the required defaults for each channel type, and copying them each time you want to create new channel definitions.
Figure 64. Example of default values during Create for a channel. The values supplied cannot be customized.
+--------------------------------------------------------------------------------+
| Channel Help |
| ------------------------------------------------------------------------------ |
| MCATTB1 TEST.CHANNEL - Settings VICY13 |
| |
| |
| More: + |
| Channel type . . . . . . . SENDER |
| |
| Target system id . . . . . ____ |
| Transmission queue name . . _______________________________________________ |
| Batch size . . . . . . . . 0001 |
| Sequence number wrap . . . 0999999 |
| Max message size . . . . . 0032000 |
| Max transmission . . . . . 32000 |
| Disconnect interval . . . . 0001 |
| Transaction id . . . . . . CKSG |
| Connection name . . . . . . ____ |
| CICS profile name . . . . . ________ |
| LU 6.2 TP name . . . . . . ________________________________ |
| ________________________________ |
| |
| |
| F1=Help F3=Exit F5=Refresh now F7=Bkwd F8=Fwd F10=Menu Bar |
| F12=Cancel |
+--------------------------------------------------------------------------------+
Use the Alter option to change an existing channel definition, except for the channel name. Simply type over the fields to be changed in the channel definition panel, and then save the updated definition by selecting Channel from the menu bar, and selecting the Save option from the pull-down menu.
Use the Delete option to delete the selected channel. For the secondary window requesting confirmation of your intention, see Figure 65.
Figure 65. The Delete action window
+--------------------------------------------------------------------------------+
| Selected Edit View Help |
| ------------------ +--------------------------+------------------------------- |
| MCSELB IBM W | 4 1. Copy... | Channel List VICY14 |
| | 2. Create... | |
| Select a ch +------------------------------------------------------+ |
| | VC13.2.VC14.SENDER - Delete |More: - + |
| Channel n | | |
| VC13.TO.V | The channel definition will be deleted. | |
| VC13.2.VC | | |
| VC13.2.VC | Channel type . . . : SENDER | |
| VC13.2.VC | | |
| / VC13.2.VC | _ 1. Keep channel | |
| VC14.2.VC | 2. Delete channel | |
| VICY13.TO | | |
| VICY13.TO | F1=Help F12=Cancel | |
| VICY13.TO +------------------------------------------------------+ |
| VICY13.TO.VICY14.NSR RECEIVER VR14 |
+--------------------------------------------------------------------------------+
Use the Find option to locate a particular channel name from the list of available channels. If the name of the channel you want is found, it is placed at the top of the list on the Message Channel List panel. The Find a Channel action window is shown in Figure 66.
Figure 66. The Find a Channel action window
+--------------------------------------------------------------------------------+
| Selected Edit View Help |
| ------------------ +--------------------------+------------------------------- |
| MCSELB IBM W | 5 1. Copy... | Channel List VICY14 |
| | 2. Create... | |
| Select a ch +--------------------------------------------------+ |
| | Find a Channel | More: - + |
| Channel n | | |
| VC13.TO.V | Type name of channel. Then press Enter. | |
| VC13.2.VC | | |
| VC13.2.VC | Channel name . . . ____________________ | |
| VC13.2.VC | | |
| / VC13.2.VC | | |
| VC14.2.VC | F1=Help F12=Cancel | |
| VICY13.TO +--------------------------------------------------+ |
| VICY13.TO.VICY14.CB REQUESTER VR14 |
+--------------------------------------------------------------------------------+
You can partially define the channel name using a terminating asterisk, for example, channel.lon*. This results in the first channel name to be found with these initial letters being placed at the top of the list.
The options available in the View pull-down menu change the current view of the list shown on the Message Channel List panel; see Figure 67.
You can partially define the channel name using a terminating asterisk, for example, channel.lon*. This results in channel names found with these initial letters being included in the list.
Also in the action window is a field to allow you to specify a channel type, or all types of channel.
Figure 67. The Include search criteria action window
+--------------------------------------------------------------------------------+
| Selected Edit View Help |
| --------------------------------- +------------------------+------------------ |
| MCSELB IBM WebSphere MQ for | 2 1. Include all | VICY13 |
| | 2. Include... | |
| Select a ch +------------------------------------------------------+ |
| | Include search criteria |More: + |
| Channel n | | |
| TEST.CHAN | Type name of channel (use * for generic.) | |
| VC13.TO.V | Select channel type. Then press Enter | |
| VC13.2.VC | | |
| VC13.2.VC | Channel name . . . . vi* | |
| VC13.2.VC | | |
| VC13.2.VC | Channel type . . . . 5 1. Sender | |
| VC13.2.VC | 2. Server | |
| VC13.2.VC | 3. Receiver | |
| VICY13.TO | 4. Requester | |
| VICY13.TO | 5. All channel types | |
| VICY13.TO | | |
| VICY13.TO | F1=Help F12=Cancel | |
| +------------------------------------------------------+ |
| |
| |
| F1=Help F3=Exit F5=Refresh now F6=Find F7=Bkwd F8=Fwd F10=Menu Bar |
| F12=Cancel |
+--------------------------------------------------------------------------------+
The Help pull-down menu is shown in Figure 68.
Figure 68. The Help pull-down menu
+--------------------------------------------------------------------------------+
| Selected Edit View Help |
| ----------------------------------------------- +---------------------------+- |
| MCSELB IBM WebSphere MQ for z/OS - Message| _ 1. Using help | |
| | 2. General help | |
| Select a channel name. Then select an action. | 3. Keys help | |
| | 4. Tutorial | |
| Channel name Type Sysid | 5. Product Info | |
| VC13.TO.VC14.SEQSER REQUESTER VR14 +---------------------------+ |
| VC13.2.VC14.JAC3 RECEIVER VR14 |
+--------------------------------------------------------------------------------+