ON MESSAGE


ON MESSAGE allows you to specify whether UNLOAD PLUS should stop or continue processing when it encounters the message BMC50253 or BMC50254.

ON_MESSAGE.png

This option is meaningful only when DIRECT YES is in effect.

If you do not specify ON MESSAGE, the utility stops when it encounters the specified message.

UNLOAD PLUS ignores this option when DIRECT NO is in effect.

STOP UTILITY

STOP UTILITY is the default, and stops the job when UNLOAD PLUS issues either BMC50253 or BMC50254. The utility ID remains in a restartable state.

CONTINUE UTILITY

This option tells UNLOAD PLUS to continue processing when issuing either BMC50253 or BMC50254. However, under some fatal conditions, the utility does not continue, even though you specified CONTINUE. When you specify CONTINUE and UNLOAD PLUS can continue, UNLOAD PLUS issues an informational message.

We recommend that you specify CONTINUE only after an error stops your utility job, and you either correct the issue and restart or determine that you want to restart without making any changes.

RETCODE

This option tells UNLOAD PLUS which return code to issue when it encounters the message BMC50253 or BMC50254 with CONTINUE UTILITY.

The following considerations apply to this option:

  • We recommend that you avoid specifying a value of 0 or 4.
  • If you do not specify a value for this option, UNLOAD PLUS issues the normal return code.

 

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