IBM Support

PWRDWNSYS and ENDSBS *ALL Exit Programs

Troubleshooting


Problem

There are several issues that may be encountered by not ending certain functions in a granular fashion. The following system provided exit programs are available to facilitate customized pre-processing when ENDSBS *ALL or PWRDWNSYS are called.

Resolving The Problem

There are several issues that may be encountered by not ending certain functions in a granular fashion. The following system provided exit programs are available to facilitate customized pre-processing when ENDSBS *ALL or PWRDWNSYS are called.

QIBM_QWC_PWRDWNSYS PWRD0100 - Prepower down system exit point (PWRDWNSYS or ENDSYS / no in or out parameters).
QIBM_QWC_PWRDWNSYS PWRD0200 - Prepower down system exit point (PWRDWNSYS / parameters passed including 0/1 for yes/no).
QIBM_QWC_PRERESTRICT - ENDSYS ENDSBS *ALL prerestricted state processing (called when ENDSBS *ALL is issued).

The exits and their availability are as follows:


V5R2
V5R3
V5R4
V6R1
V7R1
QIBM_QWC_PWRDWNSYS PWRD0100
*
*
*
*
*
QIBM_QWC_PWRDWNSYS PWRD0200
N/A
N/A
*
*
*
QIBM_QWC_PRERESTRICT
N/A
*
*
*
*

Here are some areas of interest that may be included in a user-written CL for utilization with the provided exits:

TCP, Host Servers, Telnet:

Recommendation:

ENDTCPSVR *ALL
MONMSG MSGID(TCP0000)
ENDHOSTSVR SERVER(*ALL) ENDACTCNN(*DATABASE *FILE)
MONMSG MSGID(TCP0000)
DLYJOB DLY(300)
ENDTCP
MONMSG MSGID(TCP0000)
DLYJOB DLY(300)

Possible problems by not following recommendation are listed below:

o LDAP not restarting properly or losing data due to the server not being ended before subsystems.
o Netserver not restarting due to tasks not ending properly without an end of the server prior to the ending of subsystems.
o Document New, Receiving CWBLM0017 RC2=28 Error When Trying to Start PC5250 Session:
o Document New, Telnet Fails after System Save (GO SAVE 21): Database 'DCF Technotes (IBM i)', View 'Products', Document 'Telnet Fails after System Save (GO SAVE 21)'
o Document N1010546, Management Central Failing to Start and Receiving Message CWBCO1008 RC 8007:

Network Server:

Recommendation:

VRYCFG CFGOBJ(NWSDNAME) CFGTYPE(*NWS) STATUS(*OFF)
DLYJOB DLY(300)

Note: The problem is that we are waiting approximately 3-15 minutes for the network server side to shut down. The timeframe is dependent on the network server function; in other words, it is a mail server or database server. The DLYJOB may be adjusted accordingly.

Possible problems by not following recommendation:

o Network Server will not start or the e-mail server is corrupted requiring a rebuild of the e-mail system.
o Often just the operating system will not start

WebSphere:

Recommendation:

End the WebSphere Application Server environment by typing the following command on an operating system command line:

ENDSBS SBS(QEJBSBS) OPTION(*CNTRLD) DELAY(600)


BRMS:

Note: In a BRMS control group that performs a restricted state backup, it is recommended that a CL program be written that includes the above commands and then add a call to that program as the first *EXIT in that control group. In addition, your system may not need a full 5-minute / 300-second delay in each DLYJOB DLY(300) command.



More information about the Power Down System Exit Programs can be found in the Information Center:

V5R2 - http://publib.boulder.ibm.com/iseries/v5r2/ic2924/index.htm?info/apis/xpwrdwn.htm
V5R3 - http://publib.boulder.ibm.com/infocenter/iseries/v5r3/index.jsp?topic=/apis/xpwrdwn.htm
V5R4 - http://publib.boulder.ibm.com/infocenter/iseries/v5r4/index.jsp?topic=/apis/xpwrdwn.htm
V6R1 - http://publib.boulder.ibm.com/infocenter/iseries/v6r1m0/index.jsp?topic=/apis/xpwrdwn.htm
V7R1- http://publib.boulder.ibm.com/infocenter/iseries/v7r1m0/topic/apis/xpwrdwn.htm

[{"Type":"MASTER","Line of Business":{"code":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"7.1.0"}]

Historical Number

525561593

Document Information

Modified date:
18 December 2019

UID

nas8N1018598