CL Command Reference - PWRDWNSYS
CL Command List > PWRDWNSYS Reference
Description:
The Power Down System (PWRDWNSYS) command prepares the system for ending and then starts the power-down sequence. All active subsystems are notified that the system is being powered down; no new jobs or routing steps can be started by any subsystem. For example, jobs that are on a job queue will not be started. In addition, jobs that are on a job queue as a result of a Transfer Job (TFRJOB) command will not complete. They are removed from the job queue during the subsequent initial program load (IPL), and their job logs are produced.
When the system is powered down with the *CNTRLD option, a vary off of configuration objects is initiated, but may not complete before the power down completes. When the system is powered down with the *IMMED option, no vary off of configuration objects is performed.
Notes:
1. If network server descriptions are configured on the system, all NWSDs should be varied off before the PWRDWNSYS command is issued to ensure the integrity of system and user data associated with each network server.
2. If tape units are installed on the system, all tape reels that are on the device(s) should be unloaded before the system is powered down to ensure the integrity of data on the tapes.
3. If the system has a primary partition, powering down the primary partition will cause the other partitions to power down. Ensure the other partitions are ready to be powered down before powering down the primary partition.
4. If independent auxiliary storage pool (ASP) devices are configured on the system, all independent ASPs should be varied off before PWRDWNSYS command is issued to ensure the integrity of data associated with each independent ASP.
5. The registered Prepower down system exit point (QIBM_QWC_PWRDWNSYS) has two possible formats. Format PWRD0100 can be used to add a program that is called when the PWRDWNSYS command is used. Format PWRD0200 can be used to add one or more programs that are called when the PWRDWNSYS command is used. These exit programs can perform clean up functions before the system is powered down.
6. When changing the QENDJOBLMT and QPWRDWNLMT system values, specify values so that QPWRDWNLMT is greater than QENDJOBLMT. The values need to allow enough time for system-supplied end-of-job functions such as completing commitment control processing and closing database files.
Restrictions:
1. To run this command, the user must have job control (*JOBCTL) authority.
2. When *IMGCLG is specified on the IPL source (IPLSRC) parameter you need the following authorities:
. execute (*EXECUTE) authority to library QUSRSYS
. use (*USE) authority to the image catalog specified by the Image catalog (IMGCLG) parameter
. use (*USE) authority to the virtual device description
. execute (*X) authority to each directory in the image catalog path name
3. If you have a user exit program defined to the Prepower down system exit point (QIBM_QWC_PWRDWNSYS) for format PWRD0100, then the user must have use (*USE) authority to the user exit program and execute (*EXECUTE) authority to the library that contains that program. If not, then this user exit program will not be called and the system will continue to power down.
Examples:
Example 1: Performing An Immediate End
PWRDWNSYS OPTION(*IMMED)
This command causes the system to perform an immediate end without allowing any active jobs to perform cleanup routines. Once the system completes its end functions, it starts the power-down sequence.
Example 2: Specifying a Controlled End
SBMJOB JOB(LASTJOB) JOBD(QBATCH) JOBPTY(9) JOBQ(QBATCH)
RQSDTA(¡¯PWRDWNSYS *CNTRLD 3600¡¯)
This command submits a low priority batch job that, when run, causes the system to perform a controlled end. The controlled end is allowed one hour (3600 seconds) for completion before any remaining jobs are ended. This method of issuing the PWRDWNSYS command could be used to allow other higher priority jobs on job queue QBATCH (including those that are on the queue as a result of the Transfer Job (TFRJOB) command) to be completed before the PWRDWNSYS command is run. There must be an active subsystem for which the QBATCH job queue is a source of work.
Example 3: Specifying a Controlled End With No Time Limit
PWRDWNSYS OPTION(*CNTRLD) RESTART(*YES)
This command causes the system to perform a controlled end with no time limit. When all jobs in the system have completed, the system prepares for ending and starts an IPL. After PWRDWNSYS OPTION(*CNTRLD) is entered, and before the delay time ends, this command can be overridden by entering PWRDWNSYS OPTION(*IMMED). In this case, the values specified or defaulted for the RESTART parameter on the second command also override the values specified or defaulted for the first command.
Example 4: Changing the IPL Source After Immediate End
PWRDWNSYS OPTION(*IMMED) RESTART(*YES) IPLSRC(A)
This command causes the system to end immediately and change the IPL source to A. When the system restarts, it IPLs on the A source.
Example 5: Allowing the Operating System to Determine the Restart Point
PWRDWNSYS OPTION(*IMMED) RESTART((*YES *SYS))
This command causes the IPL to restart at the point determined by the operating system.
Example 6: Changing the Time Out Option.
PWRDWNSYS OPTION(*IMMED) TIMOUTOPT(*MSD)
This command causes the system to end immediately. If the QPWRDWNLMT system value is exceeded, the system will dump the main storage. If the main store dump manager is configured correctly, the system will restart. Otherwise, the B900 3F10 system reference code will be displayed and the system will halt.
Example 7: Installing a New Release of the Operating System.
PWRDWNSYS RESTART(*YES) IPLSRC(*IMGCLG) IMGCLG(MYCAT1)
This command causes the system to end and then start installing a new release of the operating system from the image catalog MYCAT1.