Cold Start With No Previous Shutdown >>-+-/NRESTART-+--CHKPT--0--------------------------------------> '-/NRE------' >--+---------------------------------------------------------+--> | (1) | '-FORMAT-------+-ALL------------------------------------+-' '-+----+--+----+--+----+--+----+--+----+-' '-SM-' '-LM-' '-QC-' '-RS-' '-WA-' >--+------------+--+------------+--+------------+---------------> +-TERMINAL---+ +-PASSWORD---+ +-TRANCMDS---+ '-NOTERMINAL-' '-NOPASSWORD-' '-NOTRANCMDS-' >--+-+------------+--+------------+-+--+----------+------------>< | +-TRANAUTH---+ +-CMDAUTH----+ | +-MULTSIGN-+ | '-NOTRANAUTH-' +-CMDAUTHE---+ | '-SNGLSIGN-' | +-NOCMDAUTH--+ | | '-NOCMDAUTHE-' | +-USER---------------------------+ '-NOUSER-------------------------'
Warm Start After a /CHECKPOINT FREEZE Command >>-+-/NRESTART-+--+-------------------------------------+-------> '-/NRE------' | .--------. | | (1) V | | '-FORMAT-------+---+-RS-+-+---------+-' | '-WA-' | '-+---ALL---+--| B |-' '-| A |---' >--+----------+--+------------+--+------------+-----------------> '-MSDBLOAD-' +-TERMINAL---+ +-PASSWORD---+ '-NOTERMINAL-' '-NOPASSWORD-' >--+------------+--+-+------------+--+------------+-+-----------> +-TRANCMDS---+ | +-TRANAUTH---+ +-CMDAUTH----+ | '-NOTRANCMDS-' | '-NOTRANAUTH-' +-CMDAUTHE---+ | | +-NOCMDAUTH--+ | | '-NOCMDAUTHE-' | +-USER---------------------------+ '-NOUSER-------------------------' >--+----------+------------------------------------------------>< +-MULTSIGN-+ '-SNGLSIGN-' A: |--+----+--+----+--+----+--+----+--+----+-----------------------| '-SM-' '-LM-' '-QC-' '-RS-' '-WA-' B: |--NOBUILDQ-----------------------------------------------------|
Warm Start After a /CHECKPOINT PURGE or /CHECKPOINT DUMPQ Command >>-+-/NRESTART-+--+-------------------------------------+-------> '-/NRE------' | .--------. | | (1) V | | '-FORMAT-------+---+-RS-+-+---------+-' | '-WA-' | '-+---ALL---+--| B |-' '-| A |---' >--+----------+--+------------+--+------------+-----------------> '-MSDBLOAD-' +-TERMINAL---+ +-PASSWORD---+ '-NOTERMINAL-' '-NOPASSWORD-' >--+------------+--+-+------------+--+------------+-+-----------> +-TRANCMDS---+ | +-TRANAUTH---+ +-CMDAUTH----+ | '-NOTRANCMDS-' | '-NOTRANAUTH-' +-CMDAUTHE---+ | | +-NOCMDAUTH--+ | | '-NOCMDAUTHE-' | +-USER---------------------------+ '-NOUSER-------------------------' >--+----------+------------------------------------------------>< +-MULTSIGN-+ '-SNGLSIGN-' A: |--+----+--+----+--+----+--+----+--+----+-----------------------| '-SM-' '-LM-' '-QC-' '-RS-' '-WA-' B: |--+-BUILDQ---+-------------------------------------------------| '-NOBUILDQ-'
Table 82 lists the environments (DB/DC, DBCTL, and DCCTL) from which the command and keywords can be issued.
Command / Keywords | DB/DC | DBCTL | DCCTL |
---|---|---|---|
/NRESTART | X | X | X |
BUILDQ | X | X | |
CHKPT | X | X | X |
CMDAUTH | X | X | |
CMDAUTHE | X | X | |
FORMAT | X | X | X |
MSDBLOAD | X | ||
MULTSIGN | X | X | |
NOBUILDQ | X | X | |
NOCMDAUTH | X | X | |
NOCMDAUTHE | X | X | |
NOPASSWORD | X | X | |
NOTERMINAL | X | X | |
NOTRANAUTH | X | X | |
NOTRANCMDS | X | X | |
NOUSER | X | X | |
PASSWORD | X | X | |
SNGLSIGN | X | X | |
TERMINAL | X | X | |
TRANAUTH | X | X | |
TRANCMDS | X | X | |
USER | X | X |
The /NRESTART command has three forms. The selected form depends on the following conditions:
/NRESTART is used to cold start IMS or warm start IMS following an orderly termination accomplished with a /CHECKPOINT shutdown command.
Attention: A cold start performed after a processing failure could cause processing against uncommitted data. To ensure data integrity, be sure necessary backout or recovery operations have been performed before restarting.
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 an IMS cold start, the base security definition is created from the IMS system definition and EXEC parameter specifications. For an /NRESTART warm restart, the base security definition is created from the IMS checkpoint data.
To override the base security definitions on a cold start, the security keywords of the /NRESTART command must be used.
The SGN=, TRN=, and RCF= startup parameters can be overridden by the /NRESTART command using the security keywords shown in Table 83 A brief description of the keywords is also included.
Keyword | 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 |
The BUILDQ keyword must be included if the message queues are to be restored after being formatted. If the BUILDQ keyword is specified, the log from the last /CHECKPOINT DUMPQ or /CHECKPOINT PURGE is required, slowing down the restart process.
If /NRESTART FORMAT is specified without the BUILDQ keyword, the NOBUILDQ keyword must be specified. specifying NOBUILDQ reformats the queues in question and all messages are lost.
If an /NRESTART BUILDQ command fails, and then the /ERESTART CHECKPOINT 0, /ERESTART COLDCOMM, or /ERESTART COLDSYS command is performed, the messages are lost. program product (5655-038) can be used to recover the 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.
Specify one or more of the following or ALL:
When FORMAT ALL is specified, do not also specify SM, LM, QC, WA, or RS. FORMAT ALL is only required at IMS initialization (first time use of the system).
You can specify any combination of SM, LM, QC, WA, and RS; for example, FORMAT LM 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 84 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 |
ALL | X | X1 | X |
Note:
|
MSDBLOAD is not required:
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.
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:
You can use /NRESTART NOUSER for a warm start, but if transaction or command authorization is set from the checkpoint data, NOUSER is ignored, and signon (user identification verification) is set on.
IMS system definition might preclude the authority of the master terminal operator to negate password security. If this is the case, and you specify NOPASSWORD, you receive an error message.
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 will be 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.
This is an example of a cold start with new message queue data sets.
Entry ET:
/NRESTART CHECKPOINT 0 FORMAT ALL
Response ET:
DFS058I (time stamp) NRESTART COMMAND IN PROGRESS DFS994I *CHKPT 82274/114447**SIMPLE*
Explanation: IMS is started at 114447 (time) on 82274 (Julian date). A simple checkpoint is written on the system log. All message queue data sets are formatted. 82274/114447 is the checkpoint number.
This is an example of a warm start from a FREEZE checkpoint.
Entry ET:
/NRESTART
Response ET:
DFS058I (time stamp) NRESTART COMMAND IN PROGRESS DFS680I USING CHKPT 82273/180000 DFS994I *CHKPT 82274/082217**SIMPLE*
Explanation: The restart is being performed from checkpoint 82273/180000, which was written at the most recent IMS shutdown. IMS is restarted at 082217 (time) on 82274 (Julian date). A simple checkpoint is written on this system log. 82274/082217 is the checkpoint number.
This is an example of a warm start to format WADS.
Entry ET:
/NRESTART FORMAT WA
Response ET:
DFS058I (time stamp) NRESTART COMMAND IN PROGRESS DFS680I USING CHKPT 82119/230000 DFS994I *CHKPT 82120/101318**SIMPLE*
Explanation: The restart is being performed from checkpoint 82119/230000, which was written at the most recent IMS shutdown. IMS is restarted at 101318 (time) on 82120 (Julian date). A simple checkpoint is written on the system log. 82120/101318 is the checkpoint number.
This is an example of a warm start from a PURGE or DUMPQ checkpoint.
Entry ET:
/NRESTART BUILDQ
Response ET:
DFS058I (time stamp) NRESTART COMMAND IN PROGRESS DFS680I USING CHKPT 82080/214240 DFS994I *CHKPT 82081/060000**SIMPLE*
Explanation: IMS is restarted at 060000 (time) on 82081 (Julian date) from checkpoint 82080/214240, which was written at the most recent IMS shutdown. 82081/060000 is the checkpoint number.
This is an example of a warm start from a PURGE or DUMPQ checkpoint. The large and small message queue data sets have been reallocated.
Entry ET:
/NRESTART BUILDQ FORMAT SM LM
Response ET:
DFS058I (time stamp) NRESTART COMMAND IN PROGRESS DFS680I USING CHKPT 82170/085236 DFS994I *CHKPT 82170/085820**SIMPLE*
Explanation: IMS is restarted at 085820 (time) on 82170 (Julian date) from checkpoint 82170/085236, which was written at the most recent IMS shutdown. The large and small message queue data sets are reformatted. 82170/085820 is the checkpoint number.
This is an example of a warm start from a PURGE or DUMPQ checkpoint. An initial set of MSDBs is needed.
Entry ET:
/NRESTART BUILDQ MSDBLOAD
Response ET:
DFS058I (time stamp) NRESTART COMMAND IN PROGRESS DFS680I USING CHKPT 82068/180000 DFS2554 MSDB MSDBHJ01 LOADED DFS2554 MSDB MSDBHJ02 LOADED DFS2554 MSDB MSDBAK01 LOADED DFS2554 MSDB MSDBAK02 LOADED DFS2554 MSDB MSDBPS01 LOADED DFS994I *CHKPT 82069/080000**SIMPLE*
Explanation: IMS is restarted at 080000 (time) on 82069 (Julian date) from checkpoint 82068/180000, which was written at the most recent IMS shutdown. A simple checkpoint is written on the system log. 82069/080000 is the checkpoint number. An initial set of MSDBs is loaded from the z/OS sequential data set MSDBINIT.
This is an example of a warm start from a PURGE or DUMPQ checkpoint with a request for transaction command security.
Entry ET:
/NRESTART TRANCMDS
Response ET:
DFS058I (time stamp) NRESTART COMMAND IN PROGRESS DFS680I USING CHKPT 82080/214240 DFS994I *CHKPT 82274/114447**SIMPLE*
Explanation: The master terminal operator is warm starting IMS and requesting that transaction command security be in effect at the completion of the normal restart.
This is an example of a warm start from a PURGE or DUMPQ checkpoint with a request to negate transaction command security.
Entry ET:
/NRESTART NOTRANCMDS
Response ET:
DFS2181I CANNOT OVERRIDE FORCED COMMAND SECURITY
Explanation: The master terminal operator is warm starting IMS with a request to negate transaction command security. IMS system definition precludes the authority of the master terminal operator to enter the NOTRANCMDS keyword. IMS returns the DFS2181 message.
This is an example of a warm start from a PURGE or DUMPQ checkpoint. The data sets are formatted without rebuilding the message queues.
Entry ET:
/NRESTART FORMAT SM LM NOBUILDQ
Response ET:
DFS058 NRESTART COMMAND IN PROGRESS
Explanation: The master terminal operator is warm starting IMS with a request to reformat the data sets without rebuilding the message queues. IMS comes up, but all messages are lost.