+DSCRL

The +DSCRL parameter is used to verify that, after a product has issued a -STOP or -START command for an object, the function completed.

+DSCRL determines how often and how many times the status should be checked. Before a BMC AMI Utility starts a function, it issues Db2 -STOP and -START commands to put the table space in a state suitable for the product. If, by the end of the time limit specified in DSCRL, the table space is not in the desired state, the product issues an error message and fails.

When a command is issued (for example, -STOP DATABASE( xxx ) SPACENAM( yyy )), Db2 schedules the request and then acknowledges that the command has been scheduled. A Db2 acknowledgement means only that the command was scheduled, not that it has completed. If another program holds a lock on the table space, the table space goes into a STOP PENDING status which could last for seconds, minutes, or even hours if it is a batch program which holds the lock.

Related topic

Global-parameters-UTLPARMS

After the -STOP command is issued, the BMC AMI Utility issues -DISPLAY commands until Db2 shows the desired state or until the time specified in DSCRL expires, whichever comes first.

DSCRL.png

The values are defined as follows:

timeAttempts

Time between display commands where the following subfields exist (default = 000100):

  • MM: Minutes
  • SS: Seconds
  • T: Tenths of a second
  • H: Hundredths of a second

numAttempts

Maximum number of display attempts (default = (000100,100))

If the number of retries is exceeded, the BMC AMI Utility issues a message and terminates with return code 8.

Example
+DSCRL(000100,120)

The first operand tells the BMC AMI Utility to retry every second. The second operand specifies a maximum of 120 retries. This combination of parameters would make the BMC AMI Utilities product wait for up to two minutes before terminating the BMC AMI Utility on this object.

Important

For the rules that apply to parameter syntax, see Parameter syntax rules.

 

  • 13.1
Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*