288 IMS in the Parallel Sysplex, Volume III: IMSplex Implementation and Operations
12.21.1 Automatic RECON loss notification (ARLN)
When an I/O error on a RECON or a CHANGE.RECON REPLACE command is issued,
DBRC begins a reconfiguration process. This is true for all releases of IMS. The loss of a
RECON causes the remaining good RECON to be copied to the spare. This makes the spare
a member of the good RECON pair. It also leaves the RECONs without a spare.
IMS V7 added the DSP0388I message. It is sent by the system which begins the RECON
reconfiguration process. The message identifies the subsystems using the RECONs. It is
intended to be used by operators or automation processes. The message is of the form:
DSP0388I nnnn SSYS RECORD(S) IN THE RECON AT RECONFIGURATION
DSP0388I SSID=ssidname FOUND
The installation needs to create a new spare so that it may handle any failure of a member of
the new pair. The bad RECON data set name is used for the new spare. The bad RECON
must be deallocated from all subsystems which were using it before it may be deleted and
redefined. In previous releases each subsystem deallocates the bad RECON the next time it
attempts to access the RECONs. At that time, it will discover the change in the RECONs and
reconfigure. This may take a long time for batch jobs or utilities which use DBRC.
12.22 Examples
Here are some examples referred to by explanations and messages mentioned above.
12.22.1 SCI registration
Example 12-7 SCI registration
J E S 2 J O B L O G -- S Y S T E M S C 5 3 -- N O D E
17.08.02 JOB10316 ---- THURSDAY, 13 JUN 2002 ----
17.08.02 JOB10316 IRR010I USERID JOUKO1 IS ASSIGNED TO THIS JOB.
17.08.03 JOB10316 ICH70001I JOUKO1 LAST ACCESS AT 17:06:13 ON THURSDAY, JUNE
17.08.03 JOB10316 $HASP373 LISTRCN STARTED - INIT A - CLASS A - SYS SC53
17.08.03 JOB10316 IEF403I LISTRCN - STARTED - TIME=17.08.03 - ASID=03F3 - SC53
17.08.03 JOB10316 +DSP1123I DBRC REGISTERED WITH IMSPLEX PLEX1
17.08.04 JOB10316 - --TIMINGS (MINS.)--
17.08.04 JOB10316 -JOBNAME STEPNAME PROCSTEP RC EXCP CPU SRB CLOCK
17.08.04 JOB10316 -LISTRCN D 00 232 .00 .00 .0
17.08.04 JOB10316 IEF404I LISTRCN - ENDED - TIME=17.08.04 - ASID=03F3 - SC53
17.08.04 JOB10316 -LISTRCN ENDED. NAME-LISTINGS TOTAL CPU TIME=
17.08.04 JOB10316 $HASP395 LISTRCN ENDED
------ JES2 JOB STATISTICS ------
...
2 //D EXEC PGM=DSPURX00,PARM=('IMSPLEX=PLEX1')
3 //STEPLIB DD DISP=SHR,DSN=IMSPSA.IMS0.SDFSRESL
4 // DD DISP=SHR,DSN=IMSPSA.IM0A.MDALIB
...
DSP1123I DBRC REGISTERED WITH IMSPLEX PLEX1
IMS VERSION 8 RELEASE 1 DATA BASE RECOVERY CONTROL PAGE 0002
LIST.RECON STATUS
2002.164 17:08:03.2 -04:00 LISTING OF RECON PAGE 0003
-------------------------------------------------------------------------------
RECON
RECOVERY CONTROL DATA SET, IMS V8R1
DMB#=13 INIT TOKEN=02015F0058438F
NOFORCER LOG DSN CHECK=CHECK17 STARTNEW=NO
Chapter 12. Operations for other features utilizing Common Service Layer 289
TAPE UNIT=3480 DASD UNIT=3390 TRACEOFF SSID=IM1A
LIST DLOG=YES CA/IC/LOG DATA SETS CATALOGED=YES
MINIMUM VERSION = 6.1
LOG RETENTION PERIOD=00.001 00:00:00.0
COMMAND AUTH=NONE HLQ=**NULL**
SIZALERT DSNUM=15 VOLNUM=16 PERCENT= 95
LOGALERT DSNUM=3 VOLNUM=16
TIME STAMP INFORMATION:
TIMEZIN = %SYS -LABEL- -OFFSET-
UTC +00:00
OUTPUT FORMAT: DEFAULT = LOCORG LABEL PUNC YYYY
CURRENT = LOCORG LABEL PUNC YYYY
IMSPLEX = PLEX1
-DDNAME- -STATUS- -DATA SET NAME-
RECON1 COPY1 IMSPSA.IM0A.RECON1
RECON2 COPY2 IMSPSA.IM0A.RECON2
RECON3 SPARE IMSPSA.IM0A.RECON3
If you use the provided sample SCI registration user exit, you get the following SCI
registration message DSP1123I with the additional info
USING EXIT:
19.00.40 JOB10437 +DSP1123I DBRC REGISTERED WITH IMSPLEX PLEX1 USING EXIT
You get this message even though you have stated the correct IMSPLEX parameter on the
exec statement. It indicates that the final decision is made by the exit.
12.22.2 RECON access denied
If there is already an IMSplex name in the RECON ("PLEX1"), and you are trying to access
this RECON without any execution parameter or an SCI user exit, the access is denied and
return code 12 is issued as shown in Example 12-8.
Example 12-8 RECON access denied
...
19.16.52 JOB09571 IEF403I LISTRCN - STARTED - TIME=19.16.52 - ASID=0035 - SC54
19.16.53 JOB09571 +DSP1136A RECON ACCESS DENIED, IMSPLEX NAME NOT VALID
19.16.53 JOB09571 +DSP1136A RECON ACCESS DENIED, IMSPLEX NAME NOT VALID
19.16.53 JOB09571 - --TIMINGS (MINS.)--
19.16.53 JOB09571 -JOBNAME STEPNAME PROCSTEP RC EXCP CPU SRB CLOCK
19.16.53 JOB09571 -LISTRCN D 12 170 .00 .00 .0
19.16.53 JOB09571 IEF404I LISTRCN - ENDED - TIME=19.16.53 - ASID=0035 - SC54
...
1 //LISTRCN JOB (999,POK),'LISTINGS',NOTIFY=&SYSUID,
// CLASS=A,MSGCLASS=T,TIME=1439,
// REGION=0M,MSGLEVEL=(1,1)
/*JOBPARM SYSAFF=SC54
//*JOBPARM SYSAFF=SC47
//********************************************************************
//* SC53 IM1SC , SC54 IM3SC , SC67 IM4SC
//* IMS0 RESLIB WITH DSPSCIX0 MODIFIED WITH UMSCIX0
//* IM0A RESLIB WITHOUT
//********************************************************************
IEFC653I SUBSTITUTION JCL - (999,POK),'LISTINGS',NOTIFY=JOUKO1,CLASS=A
MSGLEVEL=(1,1)
2 //D EXEC PGM=DSPURX00 <==== no parm string !
...

Get IMS in the Parallel Sysplex Volume III IMSplex Implementation and Operations now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.