Use this command only after the active system issues message DFS3804I.
>>-+-/ERESTART-+--BACKUP----------------------------------------> '-/ERE------' >--+----------------------------------------+------------------>< '-FORMAT--+----+--+----+--+----+--+----+-' '-SM-' '-QC-' '-LM-' '-MD-'
>>-+-/ERESTART-+--+--------------+--+------------+--+-------+---> '-/ERE------' '-CHECKPOINT 0-' '-FORMAT--WA-' '-NOBMP-' >--+----------+------------------------------------------------>< '-OVERRIDE-'
The message queues have not been dumped to the system log since the most recent cold start.
>>-+-/ERESTART-+--+--------------+--BUILDQ--+-------+-----------> '-/ERE------' '-CHECKPOINT 0-' '-NOBMP-' >--+----------+-------------------------------------------------> '-OVERRIDE-' >--+----------------------------------------------------+------>< '-FORMAT--+-+----+--+----+--+----+--+----+--+----+-+-' | '-SM-' '-LM-' '-QC-' '-RS-' '-WA-' | '-ALL------------------------------------'
>>-+-/ERESTART-+--COLDBASE--+--------+--+----------+------------> '-/ERE------' '-BUILDQ-' '-OVERRIDE-' >--+----------------------------------------------------+------>< '-FORMAT--+-+----+--+----+--+----+--+----+--+----+-+-' | '-SM-' '-LM-' '-QC-' '-RS-' '-WA-' | '-ALL------------------------------------'
>>-+-/ERESTART-+--COLDCOMM--+-------+--+----------+-------------> '-/ERE------' '-NOBMP-' '-OVERRIDE-' >--+----------------------------------------------------+------>< '-FORMAT--+-+----+--+----+--+----+--+----+--+----+-+-' | '-SM-' '-LM-' '-QC-' '-RS-' '-WA-' | '-ALL------------------------------------'
>>-+-/ERESTART-+--COLDSYS--+----------+-------------------------> '-/ERE------' '-OVERRIDE-' >--FORMAT--+-+----+--+----+--+----+--+----+--+----+-+-----------> | '-SM-' '-LM-' '-QC-' '-RS-' '-WA-' | '-ALL------------------------------------' >--+------------+--+------------+--+------------+---------------> +-TERMINAL---+ +-PASSWORD---+ +-TRANCMDS---+ '-NOTERMINAL-' '-NOPASSWORD-' '-NOTRANCMDS-' >--+-+------------+--+------------+-+--+----------+------------>< | +-TRANAUTH---+ +-CMDAUTH----+ | +-MULTSIGN-+ | '-NOTRANAUTH-' +-CMDAUTHE---+ | '-SNGLSIGN-' | +-NOCMDAUTH--+ | | '-NOCMDAUTHE-' | +-USER---------------------------+ '-NOUSER-------------------------'
Table 56 lists the environments (DB/DC, DBCTL, and DCCTL) from which the command and keywords can be issued.
Command / Keywords | DB/DC | DBCTL | DCCTL |
---|---|---|---|
/ERESTART | X | X | X |
BACKUP | X | X | |
BUILDQ | X | X | |
CHECKPOINT | X | X | X |
CMDAUTH | X | X | |
CMDAUTHE | X | X | |
COLDBASE | X | X | |
COLDCOMM | X | X | |
COLDSYS | X | X | X |
FORMAT | X | X | X |
MULTSIGN | X | X | |
NOBMP | X | X | X |
NOCMDAUTH | X | X | |
NOCMDAUTHE | X | X | |
NOPASSWORD | X | X | |
NOTERMINAL | X | X | |
NOTRANAUTH | X | X | |
NOTRANCMDS | X | X | |
NOUSER | X | X | |
OVERRIDE | X | X | X |
PASSWORD | X | X | |
SNGLSIGN | X | X | |
TERMINAL | X | X | |
TRANAUTH | X | X | |
TRANCMDS | X | X | |
USER | X | X |
/ERESTART is a multisegment command used to:
For an /ERESTART command restart, the base security definition is created:
To override the security definitions, specify the COLDSYS keyword and the security keywords on the COLDSYS keyword.
The format for /ERESTART depends on whether or not the IMS system is an XRF alternate system. If the system is not an alternate system, the format also depends on the type of system failure associated with the termination and whether or not the message queues have been dumped to the system log since the most recent cold start.
All /ERESTART formats require an EOM indication to denote end-of-message; an EOS indication must be included for all segments that precede the last segment. See Multisegment Command Input for more details on using EOS and EOM.
With Fast Path, the /ERESTART command loads the latest MSDB checkpoint data set and applies all MSDB changes up to the latest complete commit point. /ERESTART also ensures that DEDB updates created between the restart checkpoint and the latest complete commit point are applied. If the DEDB updates are not applied, they are queued for output. Output messages not acknowledged or not transmitted are also queued for output.
When IMS initializes, the system parameters used for this initialization can come from the IMS system generation, from a PROCLIB member, or from EXEC statements that can override both the defaults and the PROCLIB members. Therefore, message DFS1929I is displayed showing the system parameters used for this particular initialization. The system parameters are also written to the job log.
For a list of the commands recovered, see Commands Recovered During Emergency Restart
If an /ERESTART BUILDQ command fails, and then you issue the /ERESTART CHECKPOINT 0, /ERESTART COLDCOMM, or /ERESTART COLDSYS command, messages in local queues are lost. However, the IMS Message Requeuer (MRQ) program product (5655-038) can be used to recover local message queues. For more information about MRQ, refer to the IMS/ESA Message Requeuer Program Description/Operations Manual.
In a shared-queues environment, the BUILDQ keyword is ignored because the message queue data sets are not used.
To specify CMDAUTH, either:
SECURITY macro TYPE=RACFTERM|RACFCOM|SIGNEXIT|TRANEXIT
must be specified in the IMS system definition, or
EXEC parameters RCF=A|Y|T|C|S
must be specified on an EXEC parameter.
To specify CMDAUTHE, either:
SECURITY macro TYPE=RACFTERM|RACFCOM|SIGNEXIT|TRANEXIT
must be specified in the IMS system definition, or
EXEC parameters RCF=A|Y|T|C|S
must be specified on an EXEC parameter.
The SGN=, TRN=, and RCF= startup parameters can be overridden by the /ERESTART COLDSYS command using the keywords shown in Table 57 Table 57 lists the keywords and the startup parameters that those keywords can override and a brief description.
Any combination of SM, LM, QC, WA, MD, and RS can be specified; for example, FORMAT LM RS. When you specify ALL, do not specify SM, LM, QC, WA, MD, or RS.
In a shared-queues environment, the LM, SM, and QC parameters are ignored because the message queue data sets are not used. If you specify ALL, IMS does not attempt to format the message queue data sets.
Table 58 shows the environments in which the parameters are valid.
Parameter | DB/DC | DBCTL | DCCTL |
---|---|---|---|
SM | X | X | |
LM | X | X | |
QC | X | X | |
RS | X | X | X |
WA | X | X | X |
MD | X | X | |
ALL | X | X | X |
If the WADS must be reformatted during emergency restart, the ALL parameter can be used. IMS first closes the OLDS from the WADS and then reformats the WADS. If you generally use the ALL parameter during restart, do not be concerned that the WADS will not be available to close the OLDS.
In an IMSplex with Resource Manager and a resource structure, if MULTSIGN conflicts with the single user signon definition for the IMSplex, a warning message will be issued.
If NOBMP is not specified, all updates made subsequent to the last commit point invoked by the active BMP programs are backed out of the database as part of the restart process.
NOBMP is ignored if no BMP programs were active at the time of the system failure.
IMS system definition might have precluded the authority of the master terminal operator to negate terminal security, in which case, if NOTERMINAL is specified, an error message is received.
If you specify NOTRANAUTH, it will be rejected with an error message if either:
IMS system definition might have precluded the authority of the master terminal operator to negate password security, in which case, if NOPASSWORD is specified, an error message is received.
In an IMSplex with Resource Manager and a resource structure, if SNGLSIGN conflicts with the single user signon definition for the IMSplex, a warning message is issued.
To specify TRANAUTH either:
SECURITY macro TYPE=RACFTERM|RACFCOM|SIGNEXIT|TRANEXIT
must be specified in the IMS system definition, or
EXEC parameters RCF=A|Y|T|C|S
must be specified on an EXEC parameter.
To specify USER, either:
SECURITY macro TYPE=RACFTERM|RACFCOM|SIGNEXIT|TRANEXIT
must be specified in the IMS system definition, or
EXEC parameters RCF=A|Y|T|C|S
must be specified on an EXEC parameter.
All system data sets are intact.
Entry ET:
/ERESTART.
Response ET:
DFS058I (time stamp) ERESTART COMMAND IN PROGRESS DFS680I USING CHKPT 85200/123456 DFS994I *CHKPT 85201/110117**SIMPLE*
Explanation: The restart is being performed from checkpoint 85200/123456, which was selected by IMS. If IMS contained active BMPs when the system failed, checkpoint 85200/123456 is the checkpoint that allows backout of all updates made by each active BMP since its latest system checkpoint. A simple checkpoint is written on the system log. The checkpoint number is 85201/110117.
Message queues are in error.
Entry ET:
/ERESTART BUILDQ.
Response ET:
DFS058I (time stamp) ERESTART COMMAND IN PROGRESS DFS680I USING CHKPT 85119/074811 DFS994I *CHKPT *85120/192021**SIMPLE*
Explanation: IMS is restarted at 192021 (time) on 85120 (* * date) from the most recent DUMPQ or SNAPQ checkpoint, 85119/074811. A simple checkpoint is written on the system log. The checkpoint number is 85120/192021.
The message queues from checkpoint 85119/074811 are loaded.
If BMP programs were active when the system failed, all updates invoked by the BMP programs are backed out.
Small and large message queues were reallocated. The message queues have been dumped at least once since the most recent cold start.
Entry ET:
/ERESTART BUILDQ FORMAT SM LM.
Response ET:
DFS058I (time stamp) ERESTART COMMAND IN PROGRESS DFS680I USING CHKPT 85201/070348 DFS994I *CHKPT *85204/010203**SIMPLE*
Explanation: IMS is restarted at 010203 (time) on 85204 (Julian date). A simple checkpoint was written on the system log. The checkpoint number is 85204/010203.
The large and small message queue data sets are reformatted.
The message queues are loaded from checkpoint 85201/070348.
If BMP programs were active when the system failed, all updates invoked by the BMP programs are backed out.
Message queues in error or data sets reallocated and the message queues have not been dumped since the most recent cold start.
Entry ET:
/ERESTART BUILDQ FORMAT ALL NOBMP.
Response ET:
DFS058I (time stamp) ERESTART COMMAND IN PROGRESS DFS680I USING CHKPT 85045/112140 DFS994I *CHKPT 85121/235959**SIMPLE*
Explanation: IMS is restarted at 235959 (time) on 85121 (Julian date) from the checkpoint taken during cold start 85045/112140. A simple checkpoint is written on the system log. The checkpoint number is 85121/235959.
All message queues and data sets are reformatted.
The message queues from the system log were loaded.
BMP programs that were active when the system failed are stopped, as are the databases updated by them.
Figure 4 and Figure 5 show formatted master screens for active and backup IMS master terminals in an XRF environment.
The /ERESTART BACKUP command was entered on the master terminal of the XRF IMS system IMSB. During the synchronization phase, the alternate system requested a SNAPQ checkpoint from the active system. The /ERESTART BACKUP is currently complete and alternate system IMSB is now tracking active system IMSA.
02/05/15 14:28:44 RSENAME: DFSRSENM BACKUP TRACKING IN PROGRESS IMSB DFS810A IMS READY 085135/1422535 IMS432 .IEFPROC DFS058 14:26:10 ERESTART COMMAND IN PROGRESS DFS3871I JOINAVM WAS SUCCESSFUL DFS3873I JOINRSE MODE=BACKUP WAS SUCCESSFUL DFS3857I OKTOSYNC ARRIVED FROM THE ACTIVE SYSTEM. DFS680I USING CHKPT85135/142629 DFS2591I NO MSDB HEADERS FOUND, IMAGE COPY LOAD IGNORED DFS3839I 14:26:46 XRF INITIAL DC PRE-OPEN COMPLETE. DFS3838I 14:28:41 XRF INITIAL DB PRE-OPEN COMPLETE. ------------------------------------------------------------------------ PASSWORD: /ere backup.
02/05/15 14:26:40 RSENAME: DFSRSENM ACTIVE IMSA DFS3499I ACTIVE DDNAMES: MODBLKSA IMSACBA FORMATA MODSTAT ID: 11 DFS3804I LAST CHKPT ID VALID FOR RESTART: 85135/141619-BUILDQ: 85135/141619 DFS994I COLD START COMPLETED. DFS3830 14:16:23 NO DEFERRED PAGE FIXING WAS DONE DFS3856I REQSYNC WAS PROCESSED TO TAKE SNAPQ CHKPT. DFS2716I NO MSDBS FOUND - NO MSDB CHECKPOINT TAKEN DFS994I *CHKPT 85135/14269***SNAPQ** DFS3499I ACTIVE DDNAMES: MODBLKSA IMSACBA FORMATA MODSTAT ID: 11 --------------------------------------------------------------------------- MASTER MESSAGE WAITING PASSWORD: