Requeueing messages after an /ERE failure: command set
This example shows how to build and execute a REQUEUE command set to requeue messages after a cold start following an abend of IMS and subsequent /ERE failures. Message Advisor records checkpoints which can be used for restart in the Message Advisor Checkpoint Tracking data set. Message Advisor uses this checkpoint tracking information plus RECON data set information to automatically locate the appropriate SLDS(s), which it uses as input.
For information about building the command set request library and creating command set members, see Building-and-executing-a-command-set-in-your-request-library.
The Message Advisor ISPF interface provides online help for all panels, pop-up panels, and fields. For information about accessing the online help system, see Online-help.
- On the Message Advisor Primary Menu panel perform the following steps:
- Type 1 in the choice entry field.
- Type a valid library name in the Request library field, and press Enter.The Member List panel is displayed.
- Add a new member by typing A in the Command area of the Member List panel.The Member List panel lets you add a new member or to select an existing member for update. After the command set is built and saved, you can also execute the command set from this panel.
- Press Enter.The Insert Command Set pop-up panel is displayed. This pop-up panel lets you select one of the Message Advisor base command sets.
- Select the REQUEUE command set.
- Type 1 in the choice entry field of the Insert Command Set pop-up panel.
Press Enter.The REQUEUE Command Set pop-up panel is displayed.
Use the REQUEUE Command Set pop-up panel to access the options listed on the pop-up panel.
.-------------------------------------------------------------------------.
- | REQUEUE Command Set |
| Command ===> _________________________________________________________ |
C | |
| Description ___________________________________________________________ |
T | |
| Select one of the following. Then press Enter. |
| |
| __ 1. Processing options - Specify what this requeue should do |
Ac | 2. Screening options - Select types of messages to requeue |
_ | 3. Special options - Turn special options on or off |
_ | 4. Misc. options - Rate, user exit, user ID |
_ | 5. Reports - Specify which requeue reports to generate |
_ | 6. Interval selection - Restrict search based on time |
_ | 7. Message selection - Select or reject by dest, origin, etc. |
_ | 8. Change messages - Specify what to change in messages |
_ | 9. Scrap codes - Specify messages to copy to scrap file |
_ | 10. Input selection - Restrict input to specific data sets |
_ | 11. Alternate data sets - Specify extract, scrap, and spill files |
_ | |
_ | 12. Exit |
_ | |
_ '-------------------------------------------------------------------------'
Type 1 in the choice entry field, and press Enter.The REQUEUE Processing Options, Page 1 of 11 pop-up panel is displayed.
In this example, you are going to build a command set to requeue all messages from an IMSID by entering an IMSID and accepting the Message Advisor defaults wherever possible.
. .-------------------------------------------------------------------------.
- | | REQUEUE Processing Options |
| | Command ===> _________________________________________________________ |
C | | |
| | Type options. Then press Enter. Page 1_ of 11 |
T | | |
| | IMSID . . . R61P + |
| | Checkpoint _______ / _______ / _____ + (YYYYDDD/HHMMSST/+HHMM) |
| | |
c | | Processing mode. Select one or more. |
_ | | / Requeue messages |
_ | | _ Validate messages |
_ | | _ Extract messages to the extract file |
_ | | |
_ | | Type of situation. |
_ | | 2 1. COLD - Scheduled COLD start (uses DUMPQ chkpt) |
_ | | 2. EREFAIL - Cold start after /ERE FAILure |
_ | | (uses SNAPQ chkpt and log records) |
_ | | 3. REPROCESS - REPROCESS messages (uses log records) |
_ | | 4. FILE - Input from extract or unload FILE |
_ | | |
_ ' '-------------------------------------------------------------------------'- Define the REQUEUE processing options by performing the following steps:
- Verify that the IMSID in the IMSID field is accurate.
To use the last appropriate checkpoint recorded in the Message Advisor Checkpoint Tracking data set, leave the Checkpoint field blank.Although you can specify a checkpoint, you do not need to since Message Advisor can automatically determine which checkpoint to use for the requeue.
If you leave this field blank, Message Advisor will use the last SNAPQ checkpoint and the log records. You must accept or reject the checkpoint through a WTOR message. Message Advisor displays WTOR message BMC43298I REQUEUE TYPE=parameter checkpoint CHKPT SELECTED IS yyyyddd/hhmmsst, REPLY Y/N/O/L/n, IMSID=imsid at the MVS console for checkpoint validation.
- In the REQUEUE Processing Options panel, type a slash (/) in the Requeue messages field.
To select cold start after /ERE failure, type 2 in the Type of situation field and press Enter.The REQUEUE Screening Options, Page 2 of 11 pop-up panel is displayed.
Use the REQUEUE Screening Options pop-up panel to select the type of messages you want to requeue.
. .-------------------------------------------------------------------------.
- | | REQUEUE Screening Options |
| | Command ===> _________________________________________________________ |
C | | |
| | Select (type a '/') one or more from each group Page 2_ of 11 |
T | | to include that type of message. |
| | |
| | / Non-conversational messages |
| | _ Active conversations (pending or scheduled) |
c | | _ Held conversations |
_ | | |
_ | | _ Discardable and non-recoverable messages |
_ | | |
_ | | |
- Type a slash (/) next to the type(s) of messages that you want to requeue.For this example, accept the defaults displayed on this pop-up panel. The defaults do not include requeueing and establishing any conversational messages.
Press Enter.The REQUEUE Special Options, Page 3 of 11 pop-up panel is displayed.
. .-------------------------------------------------------------------------.
- | | REQUEUE Special Options |
| | Command ===> _________________________________________________________ |
C | | |
| | Select (type a '/') one or more of the following. Page 3_ of 11 |
T | | |
| | _ Replace TIMESTAMP on requeued messages with current date/time |
| | _ Use OLDS data sets (rather than SLDS) for auto input selection |
| | / COMPRESS messages when requeueing |
c | | / VALIDATE_SRC LTERM when requeueing |
_ | | |
_ | | Incore storage option 1 1. Use extended private area (EPVT) |
_ | | 2. Use EPVT and FIX all pages used |
_ | | 3. Use SPILL files instead of EPVT |
_ | | |
_ | | TYPE=COLD checkpoints _ 1. Always issue WTOR for confirmation |
_ | | 2. Never issue WTOR for confirmation |
_ | | |
_ | | For zero timestamps . . _ 1. Write message to the SCRAP file |
_ | | 2. Use timestamp of the checkpoint |
_ | | 3. Use timestamp of last similar message |
_ | | |
_ | | |
_ ' '-------------------------------------------------------------------------'- Accept or change the defaults displayed on this pop-up panel.For this example, accept the defaults. The defaults shown on this pop-up panel compress messages and sort messages in main storage for faster processing. Message Advisor chooses these selections as defaults; if you do not want a specific selection, blank it out by moving the cursor next to the option and pressing the space bar.
Press Enter.The REQUEUE Misc. Options, Page 4 of 11 pop-up panel is displayed.
. .-------------------------------------------------------------------------.
- | | REQUEUE Misc. Options |
| | Command ===> _________________________________________________________ |
C | | |
| | Type options. Then press Enter. Page 4_ of 11 |
T | | |
| | Maximum requeue activity rate . . . . ________ messages per minute |
| | Message selection exit . . . . . . . ________ (user exit name) |
| | Replace user ID in messages with . . ________ |
c | | |
_ | | |- Accept or change the defaults displayed on this pop-up panel.For this example, accept the defaults.
Press Enter.The REQUEUE Report Options, Page 5 of 11 pop-up panel is displayed.
The Summary report summarizes of the message types requeued. For more information about reports, see Message-Advisor-reports.
.-------------------------------------------------------------------------. .
| REQUEUE Report Options | |
| Command ===> _________________________________________________________ | |
| | |
| Select (type a '/') one or more reports to print. Page 5_ of 11 | |
| Enter DEFAULT on the command line to select defaults. | |
| | |
| / SUMMARY - Summary report | |
| / DESTINATION - Non-conversational (by destination) | |
| _ ORIGIN - Non-conversational (by origin) | |
| _ CONVERSATION - Conversational messages requeued | |
| _ ERROR - Messages which resulted in error scrap code | |
| _ SCRAP - Messages written to scrap file | |
| _ MESSAGE - Messages successfully requeued | |
| _ ERRORDATA - ERROR with message data | |
| _ SCRAPDATA - SCRAP with message data | |
| _ MESSAGEDATA - MESSAGE with message data | |
| | |- Select the reports you want to print.In this example, you are requeueing nonconversational messages and will need summary destination reports on nonconversational messages.
- Type / next to Summary report and Non-conversational messages requeued (by destination).
- Press END twice.The Confirm Changes pop-up panel is displayed.
Confirm the new command set options and defaults by typing 1 in the choice entry field of the Confirm Changes pop-up panel, and pressing Enter.The Command Sets panel is displayed. Use this panel to name the command set and enter title information describing the command set.
File Options Session Display Help
------------------------------------------------------------------------------
Command Sets - bmcnode.MAQ.REQUEST
Command ===> ________________________________________________ Scroll ===> PAGE
Member ________
Title. . ______________________________________________________________________
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- (optional) Name the command set and add a description by performing the following steps:
- (optional) Type the name of the command set in the Member field.If you name the command set, fields on the following pop-up panel will be populated.
- (optional) Type a description in the Title field.The Confirm Save pop-up panel is displayed.
- Press END.
- Confirm that you want to create and save the 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 it is not already displayed, type 2 in the choice entry field.If you named the command set on the command sets pop-up panel, a 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
Command ===> ________________________________________________ Scroll ===> PAGE
Type one or more action codes. Then press Enter. Row 0023 of 0026
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
_ SAMPRQ2 ________ 3 2001/08/24 2001/08/24 16:35:40 USERID1
_ SAMPUL ________ 3 2001/08/23 2001/08/23 15:39:29 USERID1
_ UNL0003 ________ 7 2001/05/30 2001/05/30 12:27:52 USERID2
_ UNL0015 ________ 4 2001/06/04 2001/06/04 11:45:36 USERID2
**End**
- View the command set and edit it, if necessary, by performing the following steps:
- Type E in the Act field.From the Member List panel, you can edit and/or execute the member that you just created. You can also select the member for update from the Member List panel and change the options and defaults on the respective pop-up panels by using the Message Advisor ISPF interface.
Press Enter.The new command set is displayed. This panel shows you the command set built with the preceding panels and pop-up panels. You can edit the command set on this panel and save the changes. You can also select the command set from the Member List panel and change the command set by using the Message Advisor ISPF interface.
File Edit Edit_Settings Menu Utilities Compilers Test Help
-------------------------------------------------------------------------------
EDIT bmcnode.MAQ.REQUEST(SAMPRQ2) - 01.00 Columns 00001 00072
****** ***************************** Top of Data ******************************
000010 REQUEUE IMSID=R61P,TYPE=EREFAIL,
000020 REPORT=(SUMMARY,DESTINATION,TRANSACTION)
000030 END
****** **************************** Bottom of Data ****************************
- Review the command set, then press END.The Member List panel is displayed.
- To execute the command set, type Q in the Act field of the Member List panel, and press Enter.The Confirm Execute pop-up panel is displayed.
If 1 is not already displayed in this field, confirm execution by typing 1 in the choice entry field of the Confirm Execute pop-up panel and pressing Enter.Message Advisor executes the request and then displays several status panels that indicate the status of the REQUEUE request that you just executed. The Waiting pop-up panel, which is the first in a series of status and selection list panels, is displayed.
The Waiting pop-up panel remains displayed while the requeue runs. You do not have to press any keys or type any commands while this pop-up panel is displayed; it automatically scrolls to the Request Status pop-up panel when the requeue completes.
This pop-up panel displays the status of the requeue process by displaying any significant messages. You can scroll up and down through the messages with the scroll keys.
File Options Samples Session Display Help
------------------------------------------------------------------------------
.-------------------------------------------------------------------------.
C | Request Status |
| Command ===> ________________________________________ Scroll ===> PAGE |
T | BMC43868 Request complete. Press Enter for report options. |
| Use the scroll actions/keys to view the messages. |
| Then press Enter to continue. |
| |
Ac | Request for Server QJER: Highest condition code: 00 |
Q | 16:43:43 bmcnode.MAQ.REQUEST(SAMPRQ2) |
_ | Line 017 of 026 |
_ | Significant messages: More: - |
_ | BMC43267I MESSAGE ADVISOR READING INPUT LOG(S), IMSID=R61P |
| BMC43227I USING SLDS DDN=SYS00053 DSN=ABC.QMR61.R61PXRF.D01236.T0943297 |
| IMSID=R61P |
| BMC43210I FOUND CHKPT 2001236/0959367CDT **SNAPQ ** (LOG IMSID=R61P R6. |
| 1) IMSID=R61P |
| BMC43210I USING CHKPT 2001236/0959367CDT **SNAPQ ** (LOG IMSID=R61P R6. |
| 1) IMSID=R61P |
| BMC43268I MESSAGE ADVISOR PROCESSING LOG RECORDS, IMSID=R61P |
| BMC43269I MESSAGE ADVISOR INSERTING MESSAGES TO IMS QUEUES, IMSID=R61P |
| BMC43076I REQUEUE FOR USERID1 (TASK 7) IMS(R61P) ENDED, RC=00 |
'-------------------------------------------------------------------------'Review the messages on the Request Status pop-up panel.This pop-up panel displays the status of the requested process by showing any significant messages. You may view an explanation about any message on the panel by placing the cursor on the message and pressing PF4 (PROMPT).
If this pop-up panel shows a condition code other than 00, review the messages and reports from the Browse Results pop-up panel to determine the problem.
- Press Enter.The Request Results pop-up panel is displayed.
To view the REQUEUE report, type 1 in the choice entry field on the Browse Results pop-up panel, and press Enter.The Browse Results pop-up panel is displayed.
.-----------------------------------------------------------------------------.
| Browse Results |
| Command ===> ____________________________________________ Scroll ===> PAGE |
| Line 000000 of 000198 Cols 001 075 |
| More: + > |
| ****************************** Top of Data ******************************** |
| BMC43077I REQUEUE IN PROGRESS FOR USERID1 (TASK 7) |
| >>>>REQUEUE IMSID=R61P,TYPE=EREFAIL, |
| >>>> REPORT=(SUMMARY,DESTINATION,TRANSACTION) |
| >>>>END |
| BMC43276I SEARCHING FOR COPY1 RECON DATA SET, IMSID=R61P |
| BMC43227I USING SCRAP DDN=SYS00046 DSN=RIHJER.R61P.SCRAP IMSID=R61P |
| BMC43227I USING SPILL2 DDN=SYS00047 DSN=RIHJER.R61P.SPILL2 IMSID=R61P |
| BMC43227I USING SPILL1 DDN=SYS00048 DSN=RIHJER.R61P.SPILL1 IMSID=R61P |
| BMC43227I USING SPILL3 DDN=SYS00049 DSN=RIHJER.R61P.SPILL3 IMSID=R61P |
| BMC43227I USING SPILL4 DDN=SYS00050 DSN=RIHJER.R61P.SPILL4 IMSID=R61P |
| BMC43315I NO ABEND TIMESTAMP FOUND - PROCESSING UNTIL END OF SELECTED INPUT |
| BMC43302I REQUEUE PROMPTING OPERATOR FOR CHECKPOINT VALIDATION, IMSID=R61P |
| BMC43246I SEARCHING FOR CHKPT=2001236/0959367CDT IMSID=R61P |
| BMC43227I USING RECON DDN=SYS00052 DSN=RCNDC.R61P.RECON1 IMSID=R61P |
| BMC43229I MESSAGE ADVISOR CHECKPOINT TRACKING IS ACTIVE, IMSID=R61P |
| BMC43267I MESSAGE ADVISOR READING INPUT LOG(S), IMSID=R61P |
'-----------------------------------------------------------------------------'- Review the output.If this pop-up panel shows an error code other than 00, see the BMC Documentation Center for an explanation of the error.
- To initiate normal IMS data communications, issue the /STA DC command.
Complete your normal IMS startup procedures.This step completes the sample task of requeueing all messages after an abnormal shutdown, /ERE failure, and cold start of IMS.
Related topic