Building a command set using the interactive method
Use the following procedure to build a command set. To display the list of command set samples, use one of the following methods:
- Selecting a sample
- Creating a command set and storing it in your request library
The samples are templates that allow you to copy the sample without removing it from MAQSAMP.
To build a command set
- Display the list of samples by performing the following steps:
Select the Samples pull-down menu from the action bar.
File Options Samples Session Display Help
-------------- .---------------------------------------. ---------------------
| _ 1. List samples... |
| 2. Set alternate sample library... |
'---------------------------------------'
S=Update member Q=Execute interactively D=Delete B=Browse
A=Add new member X=Execute in batch R=Rename E=Edit
More: +
Act Name Prompt Size Created Changed ID
_ A ________ 4 2001/07/30 2001/07/30 14:16:43 USERID2
**END**- Type 1 to select List samples, and press Enter.The Sample List pop-up panel is displayed (as shown in Allocating-a-request-library-using-the-interactive-method).
- Determine whether one of the sample command sets performs the functions that you require by performing one of the following actions:
Type a slash (/) next to the sample command set that meets your needs, and press Enter.The Command Sets panel is displayed. For example, the following figure shows a sample command set for requeueing all messages after a cold start.
File Options Session Display Help
------------------------------------------------------------------------------
Command Sets - bmcnode.MAQ.REQUEST
Member ________
Title. . AUTOMATIC REQUEUE COMMAND SET, ALL KEYWORDS SET TO DEFAULTS___________
Type one or more action codes. Then press Enter.
S=Select for update I=Insert D=Delete Line 000 of 001
Action Command Set Description
_ ***************************** TOP OF DATA *****************************
_ REQUEUE AUTOMATIC REQUEUE (MESSAGE ADVISOR SELECTS THE CHECKPOINT)
Command ===> ________________________________________________ Scroll ===> PAGE- Build your own command set without using a template by performing the following steps:
Type a slash (/) next to (None - create a new request), and press Enter.The Insert Command Set pop-up panel is displayed.
Insert Command Set
Select one of the following
Message Advisor command sets.
Then press Enter.
_ 1. REQUEUE
2. DEQUEUE
3. UNLOAD
4. DISPLAYType the number of the command set that you want to build, and press Enter.A series of pop-up panels for the command that you selected are displayed. Use these pop-up panels to rename the command set, and accept or change the title describing it.
For more information about using Message Advisor ISPF panels to build command sets, see the following topics:
- For information about building DISPLAY commands, see Displaying-IMS-message-queues.
- For information about building DEQUEUE commands, see Dequeueing-messages.
- For information about building UNLOAD commands, see Unloading-messages.
- For more information about building REQUEUE commands, see Requeueing-messages.
- Name the command set, and accept or change the command description by performing the following steps:
- In the Member field, type the name for the command set.
Accept the description in the title field by pressing Enter, or type you description, and press Enter.The Confirm Save pop-up panel is displayed.
File Options Samples Session Display Help
------------------------------------------------------------------------------
Member List - bmcnode.MAQ.REQUEST
.---------------------------------------------------.
T | Confirm Save | Row 0001 of 0020
| | =Browse
| Select one of the following. Then press Enter. | =Edit
| | More: +
Ac | 2 *. Replace member (unavailable) | anged ID
_ | 2. Create new member . . . REQUEUE1 | 30 14:16:43 USERID2
_ | 3. Do not save changes (CANCEL) | 24 15:51:07 USERID2
_ | | 29 16:13:46 USERID2
_ | | 18 15:06:13 USERID2
_ | | 18 15:23:49 USERID2
_ | | 23 16:26:34 USERID3
_ | | 23 10:35:34 USERID2
_ | Command ===> ___________________________________ | 29 09:23:36 USERID2
_ '---------------------------------------------------' 02 16:43:35 USERID2
_ DEFAULT ________ 13 2001/05/14 2001/05/14 10:19:35 USERID2
_ DEQUEUE ________ 10 2001/07/03 2001/07/03 18:00:17 USERID2
_ DIS0016 ________ 8 2001/05/29 2001/05/29 16:17:25 USERID2
_ INTERVAL ________ 8 2001/03/26 2001/04/02 17:21:26 USERID2
_ MUN0015 ________ 5 2001/07/18 2001/07/18 17:05:08 USERID2
Command ===> SAMPLES_________________________________________ Scroll ===> PAGE
- Confirm that you want to create and save a new member by performing the following steps:
- If you did not type the name on the previous pop-up panel, type a member name in the Create new member field.
- If the number is not displayed, type 2 in the choice entry field.If you named the command set on the command set pop-up panel, 2 is displayed in the choice entry field and the member name is carried forward to this pop-up panel.
Press Enter.The Member List panel is displayed.
File Options Samples Session Display Help
------------------------------------------------------------------------------
Member List - bmcnode.MAQ.REQUEST
Type one or more action codes. Then press Enter. Row 0001 of 0020
S=Update member Q=Execute interactively D=Delete B=Browse
A=Add new member X=Execute in batch R=Rename E=Edit
More: -
Act Name Prompt Size Created Changed ID
_ DEQUEUE1 ________ 3 2001/08/10 2001/08/10 11:34:19 USERID
**END**
Browse or edit the command by performing one of the following steps:
- Browse the command set by typing B in the Act field, and pressing Enter.
- Edit the command set by typing E in the Act field, and pressing Enter.
The new command set is displayed. The following figure shows the command set that was built with the REQUEUEING ALL MESSAGES: COLD START template.
BROWSE--- bmcnode.MAQ.REQUEST(REQUEUE1) - 01.00 --------------- COLUMNS 001 072
****** *************************** TOP OF DATA ******************************
000010 *TITLE=REQUEUING ALL MESSAGES: COLD START
000020 REQUEUE ; AUTOMATICALLY (Message Advisor SELECTS THE CHECKPOINT)
000030 IMSID=?,MODE=REQUEUE,TYPE=COLD,CONVERSATIONS=ALL,
000040 BMP=YES,MSGTYPE=ALL,SYSMSG=YES,TIMESTAMP=ORIGINAL,
000050 SCRAP=YES,OLDS=NO,COMPRESS=YES,INCORE=YES,PRINT=ALL,
000060 RATE=0
000070 END- Review the command set for accuracy and edit the command as necessary.
Press END.The Member List panel is displayed.
You can add conditional steps to specify that a command set within a request will not be executed unless a previous command set is successfully executed, or that it will be executed only if a previous command set is not successful. For more information, see Conditional-steps.