Automating iCluster Start-up – Part 5
The last post on automating start-up and shutdown in this series will cover the parameters for the DMENDCST command. Here is the command:
The first parameter End group option – OPTION, indicates how group operations should be ended. This is equivalent to the OPTION parameter on the DMENDGRP command. You should always specify *CNTRLD for controlled end unless you have very narrow time frames during which the IPL will occur. In other words *IMMED will end the group replication operations immediately at the time the command is invoked, but it may not be where you want it to end. The default is *CNTRLD.
The second parameter End delay time – DELAY, is the time in seconds you want to give to the command to wait for group operations to end in a controlled manner. This is equivalent to the DELAY parameter on the DMENDGRP command. Once this time is reached, operations will be ended immediately, and so this parameter is only used if *CNTRLD is specified for the End group option parameter. The default is 60 seconds.
MSGQUEUE allows you to specify a message queue other than QSYSOPR to which status and alert messages from the command will be sent. *CURRENT will use the message queue for the current user who submits the command. The default is QSYSOPR.
MAXWAITGRP specifies the amount in time in minutes to wait for groups to end all operations before declaring a failure to the command. The default is 10 minutes.
ENDNODES tells the command whether all nodes in the cluster should be ended (*YES), no nodes will be ended (*NO) or just the current node from which the command is being executed (*CURRENT). The default is *ALL.
MAXWAITNOD tells the command how many minutes to wait for a node to become *INACTIVE. If it reaches this time and the node still cannot be ended an error message is sent to the message queue specified as well as the event log and the command will end. The default is 10 minutes.
ENDSBS specifies whether the XDMCLUSTER subsystem will be ended on the current node. If *YES is specified the subsystem is ended *IMMED. The default is *NO.
The last parameter is Wait until subsystem ends – WAITSBSEND. It tells the command whether to wait for the XDMCLUSTER subsystem to end before returning control to the caller of the command. This parameter is only used if the previous parameter is set to *YES. The default is *NO, in other words return control to the caller immediately.
One final important fact about both the DMSTRCST and DMENDCST commands:
Make sure that whatever user profile is running the commands i.e. QSYSOPR or JOEPGMR – has been enrolled in iCluster using DMWRKUSR, else it may not have the required authorities to execute the commands.”