IMS Version 9

/ERESTART

Format

Manual Restart of an XRF Alternate System

Use this command only after the active system issues message DFS3804I.

Read syntax diagramSkip visual syntax diagram>>-+-/ERESTART-+--BACKUP---------------------------------------->
   '-/ERE------'

>--+----------------------------------------+------------------><
   '-FORMAT--+----+--+----+--+----+--+----+-'
             '-SM-'  '-QC-'  '-LM-'  '-MD-'

Restart of IMS Following Loss of Virtual Storage Only

Read syntax diagramSkip visual syntax diagram>>-+-/ERESTART-+--+--------------+--+------------+--+-------+--->
   '-/ERE------'  '-CHECKPOINT 0-'  '-FORMAT--WA-'  '-NOBMP-'

>--+----------+------------------------------------------------><
   '-OVERRIDE-'

Restart of IMS Following Loss of Virtual Storage and Message Queue Data Set Integrity

The message queues have not been dumped to the system log since the most recent cold start.

Read syntax diagramSkip visual syntax diagram>>-+-/ERESTART-+--+--------------+--BUILDQ--+-------+----------->
   '-/ERE------'  '-CHECKPOINT 0-'          '-NOBMP-'

>--+----------+------------------------------------------------->
   '-OVERRIDE-'

>--+----------------------------------------------------+------><
   '-FORMAT--+-+----+--+----+--+----+--+----+--+----+-+-'
             | '-SM-'  '-LM-'  '-QC-'  '-RS-'  '-WA-' |
             '-ALL------------------------------------'

Restart of IMS Following /ERESTART Failure of the Database Component

Read syntax diagramSkip visual syntax diagram>>-+-/ERESTART-+--COLDBASE--+--------+--+----------+------------>
   '-/ERE------'            '-BUILDQ-'  '-OVERRIDE-'

>--+----------------------------------------------------+------><
   '-FORMAT--+-+----+--+----+--+----+--+----+--+----+-+-'
             | '-SM-'  '-LM-'  '-QC-'  '-RS-'  '-WA-' |
             '-ALL------------------------------------'

Restart of IMS Following /ERESTART Failure of Communication Component

Read syntax diagramSkip visual syntax diagram>>-+-/ERESTART-+--COLDCOMM--+-------+--+----------+------------->
   '-/ERE------'            '-NOBMP-'  '-OVERRIDE-'

>--+----------------------------------------------------+------><
   '-FORMAT--+-+----+--+----+--+----+--+----+--+----+-+-'
             | '-SM-'  '-LM-'  '-QC-'  '-RS-'  '-WA-' |
             '-ALL------------------------------------'

Restart of IMS Following /ERESTART Failure of Both the Database and Communication Components

Read syntax diagramSkip visual syntax diagram>>-+-/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-------------------------'

Environments and Keywords

Table 56 lists the environments (DB/DC, DBCTL, and DCCTL) from which the command and keywords can be issued.

Table 56. Valid Environments for the /ERESTART Command and Keywords
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

Usage

/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

BACKUP
Indicates that the control region is an alternate system in an XRF environment. This command is required when performing manual restart.
BUILDQ
Is required for any restart from a failure in which message queue data set integrity was lost. When a checkpoint other than checkpoint 0 is specified, the checkpoint must be one at which the message queues were dumped to the system log. Message queue data set integrity has been lost if one or more of the data sets have been reallocated or reformatted. If a checkpoint is not specified, IMS selects the appropriate checkpoint from which to start.

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.

CHECKPOINT
CHECKPOINT is an optional keyword that identifies whether the restart should use the initial system checkpoint taken during the cold start of the IMS subsystem. If you do not specify this keyword, IMS determines the correct checkpoint to use. If you do specify this keyword, you can only specify CHECKPOINT 0 to use the initial system checkpoint.
CMDAUTH
Specifies that both signon (user identification verification) and command authorization for static and ETO terminals are in effect at the end of the emergency restart. (Command authorization is same as specifying RCF=S on the startup parameter.)

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.

CMDAUTHE
Specifies that command authorization for ETO terminals (same as RCF=S on the startup parameter) is in effect at the end of the emergency restart. CMDAUTHE also resets command authorization for static terminals, if it was set.

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.

COLDBASE
Indicates a cold start of the database component, while performing an emergency restart of the communications component.
COLDCOMM
Indicates a cold start of the data communication component, while an emergency restart of the database component is being performed. This includes recovering Fast Path DEDBs, reloading MSDBs, backing out inflight changes to DL/I databases, and maintaining all existing indoubt data. COLDCOMM is used to get the DC network reinstated as soon as possible while databases are being recovered. As a result of COLDCOMM, all of the messages on the local message queue will be lost; inflight messages in shared queues are moved to the cold queue for later recovery. If this keyword is not used, the data communication component will be restarted.
COLDSYS
Indicates a cold start of both the database and the data communication components. The /ERESTART COLDSYS command performs the same function as the /NRESTART CHECKPOINT 0 DETACH command performed in prior releases, and replaces it.

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.

Table 57. Security Keywords and Their Startup Parameter Equivalents
Keyword1 Description Startup Parameter
CMDAUTH RACF command authorization on static and ETO terminals only RCF=S
CMDAUTHE RACF command authorization on ETO terminals only RCF=C
MULTSIGN Permits multiple signons for each user ID SGN=M
NOCMDAUTH Resets the command authorization on static and ETO terminals Not RCF=S
NOCMDAUTHE Resets the command authorization on ETO terminals only Not RCF=C
NOTRANAUTH Resets the transaction authorization. Not TRN=F or Y
NOUSER Resets user identification verification, transaction authorization, and command authorization
Not SGN=F or Y
(G or Z becomes M)
Not TRN=F or Y
Not RCF=C or S
SNGLSIGN Permits a single signon for each user ID
SGN=F and Y
Not SGN=M
(G or Z becomes F or Y)
TRANAUTH Transaction authorization TRN=F or Y
USER Sets user identification verification SGN=Y
Note:
  1. Valid only with the /ERESTART COLDSYS command.
FORMAT
Specifies which queues or data sets should be formatted as part of the restart process when: When queues or data sets must be formatted as part of the restart process, specify one or more of the following:
SM
Short-message queue
LM
Long-message queue
QC
Control record data set (QBLKs)
RS
Restart data set
WA
Write ahead data set
MD
MSDB dump data set (valid only for backup)
ALL
All message queues (SM and LM) and data sets (QC, WA and RS). For DBCTL, this supports RS and WA only.

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.

Table 58. /ERESTART FORMAT Command Parameter Environments
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.

MULTSIGN
Permits multiple signons for each user ID.

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.

NOBMP
Specifies no backout of BMP updates occurs and all affected databases and programs are stopped.

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.

NOCMDAUTH
Resets command authorization on static and ETO terminals.
NOCMDAUTHE
Resets command authorization for static and ETO terminals. The command authorization is reset for static terminals because the command authorization for static terminals cannot exist without the command authorization for ETO terminals.
NOTERMINAL
Specifies that the terminal security specifications established by the Security Maintenance utility are not in effect at completion of this emergency restart.

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.

NOTRANAUTH
Turns off transaction authorization. NOTRANAUTH is not the opposite of TRANAUTH. TRANAUTH sets transaction authorization and also turns on signon (user identification verification).

If you specify NOTRANAUTH, it will be rejected with an error message if either:

NOUSER
Specifies that none of the following is in effect at the end of the emergency restart:
OVERRIDE
Is required only to restart the system after failure of power, machine, z/OS, or DBRC where IMS abnormal termination was unable to mark the DBRC subsystem record in RECON as abnormally terminated. IMS emergency restart will abort with message DFS0618A when DBRC indicates that the subsystem is currently active and that neither the OVERRIDE keyword nor the BACKUP keyword is present on the /ERESTART command. If there is any doubt about the status of an IMS system at restart time, the OVERRIDE keyword should not be used.
Attention: Use of the OVERRIDE keyword on a currently running IMS system can lead to database and system integrity problems.
PASSWORD or NOPASSWORD
Specifies whether (PASSWORD) or not (NOPASSWORD) the password security specifications established by the Security Maintenance utility will be in effect at completion of this emergency restart.

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.

SNGLSIGN
Permits a single signon for each user ID.

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.

TERMINAL
Specifies that the terminal security specifications established by the Security Maintenance utility are in effect at completion of this emergency restart. However, TERMINAL can only be used for transaction authorization if RCF=S is specified. SMU is not used for command terminal security if RACF is used.
TRANAUTH
Specifies both transaction authorization and user identification verification, with or without RACF.

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.

TRANCMDS or NOTRANCMDS
Specifies whether (TRANCMDS) or not (NOTRANCMDS) the transaction command security established by the Security Maintenance utility is in effect at completion of this emergency restart.
TRANCMDS
Specifies that transaction command security established by the Security Maintenance utility is in effect at completion of this emergency restart.
NOTRANCMDS
Specifies that transaction-entered commands cannot be entered. IMS system definition might have precluded the authority of the master terminal operator to not allow transaction-entered commands, in which case, if the NOTRANCMDS keyword is used, an error message is returned.
USER
Specifies user identification verification. User identification verification means that signon is required by the static terminals that are defined to SMU for signon verification. This keyword has no effect on ETO terminals because they are always required to sign on. User identification verification can be forced on by TRANAUTH or CMDAUTH.

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.

Examples

Example 1 for /ERESTART Command

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.

Example 2 for /ERESTART Command

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.

Example 3 for /ERESTART Command

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.

Example 4 for /ERESTART Command

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.

Example 5 for /ERESTART Command

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.

Figure 4. IMS Formatted Master for the Alternate System
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.
 
Figure 5. IMS Formatted Master for the Active System
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:
 
 

Go to the previous page Go to the next page

IBM Confidential

Downloads | Library | Support | Support Policy | Terms of use | Feedback
Copyright: IBM Corporation 1974, 2004 Copyright IBM Corporation 1974, 2004  timestamp Last updated: March, 2004