Skip to Content
Information
Limited support BMC provides limited support for this version of the product. As a result, BMC no longer accepts comments in this space. If you encounter problems with the product version or the space, contact BMC Support.BMC recommends upgrading to the latest version of the product. To see documentation for that version, see UNLOAD PLUS for DB2 13.1.

SmartSwitch output

SmartSwitch output can combine output from UNLOAD PLUS and BMC AMI Unload, depending on whether SmartSwitch switches a job to BMC AMI Unload: 

  • If SmartSwitch switches a job to BMC AMI Unload, output is written to CDBPRINT, SYSERROR, SUMMARY, and OBJREPRT DD statements (the norm for BMC AMI Utilities output), as it is for other BMC AMI Unload output. BMC AMI Unload dynamically allocates these DD statements, using SYSPRINT as a model.
  • If SmartSwitch does not switch a job to BMC AMI Unload, UNLOAD PLUS continues to write output to SYSPRINT (the norm for UNLOAD PLUS). UNLOAD PLUS also issues UTILITY COMPLETE messages and a final condition code.

The following table displays sample messages that are displayed in various scenarios:

Scenario

Sample message

The following message is displayed in SYSPRINT:

BMC54002ISMARTSWITCH BLUE SOLUTION LICENSE NOT FOUND
  • SmartSwitch is enabled.
  • The rules table does not contain any rules.
BMC50004I  UTILINIT PHASE COMPLETE.  ELAPSED TIME = 00:00:00
BMC54003I  SMARTSWITCH RULE: FORCE_NO_SWITCH  COMMENT: SMARTSWITCH NOT ACTIVATED, NO ROWS ON POLICY TABLE

The following message is also displayed in the Comments column of the rules table: 

SMARTSWITCH NOT ACTIVATED, NO ROWS ON POLICY TABLE
  • SmartSwitch is enabled.
  • The rules table contains at least one rule.
  • The job does not match any of the rules in the rules table.
BMC50004I UTILINIT PHASE COMPLETE.  ELAPSED TIME = 00:00:00
BMC54003I SMARTSWITCH RULE: FORCE_NO_SWITCH  COMMENT: SMARTSWITCH IS ACTIVATED, BUT NO RULE APPLIES. CLASSIC UTILITY WILL BE USED
BMC50004I NGTUTIL PHASE COMPLETE.  ELAPSED TIME = 00:00:00

The following message is also displayed in the Comments column of the rules table: 

SMARTSWITCH IS ACTIVATED, BUT NO RULE APPLIES.  UTILITY WILL BE USED
  • SmartSwitch is enabled.
  • The job matches a rule that contains ALLOW_SWITCH.
BMC50004I UTILINIT PHASE COMPLETE.  ELAPSED TIME = 00:00:00
BMC54003I SMARTSWITCH RULE: ALLOW_SWITCH  COMMENT: SEND JOBS FROM RDARKB TO BMC AMI UTILITIES
BMC50186I SMARTSWITCH SYNTAX VERIFICATION RC=00000000 :  BMC AMI UTILITIES CAN NATIVELY PROCESS THIS LOAD.
BMC50184I SMARTSWITCH PROCESSING SUCCESSFUL. RETURN CODE=0.  UTILITY OUTPUT CAN BE FOUND IN BMC AMI UTILITIES DD CDBPRINT, SUMMARY AND OBJREPRT.
(PTF BQU2387 applied) BMC50200I SMARTSWITCH ALWAYS SENDS DELETEFILES TO BMC AMI UTILITIES AND OVERRIDES +DELETEOUTPUT VALUE.

The following message is also displayed in the Comments column of the rules table: 

SEND JOBS FROM RDARKB TO BMC AMI UTILITIES
  • SmartSwitch is enabled.
  • The job matches a rule that contains ALLOW_SWITCH.
  • The job cannot switch from UNLOAD PLUS to BMC AMI Unload.
BMC50004I UTILINIT PHASE COMPLETE.  ELAPSED TIME = 00:00:01
BMC54003I SMARTSWITCH RULE: ALLOW_SWITCH  COMMENT: SEND JOBS FROM RDARKB TO BMC AMI UTILITIES
BMC50183I SMARTSWITCH PRECLUDED FROM SWITCHING.  REASON DDTYPE LOCPFCPY FOUND WITH IFALLOC USE
BMC50004I NGTUTIL PHASE COMPLETE.  ELAPSED TIME = 00:00:00 

Message BMC50183I describes the reason that prevents the job from switching from the UNLOAD PLUS to BMC AMI Unload.

  • SmartSwitch is enabled.
  • The job matches a rule that contains ALLOW_SWITCH.
  • The BMC AMI Utilities parser prevents the job switching from UNLOAD PLUS to BMC AMI Unload.
BMC50004I UTILINIT PHASE COMPLETE.  ELAPSED TIME = 00:00:00
BMC54003I SMARTSWITCH RULE: ALLOW_SWITCH  COMMENT: SEND JOBS FROM RDARKB TO BMC AMI UTILITIES
BMC50186I SMARTSWITCH SYNTAX VERIFICATION RC=00000008 :  LOAD PARSER ERROR: NGTU782 TEXT IN ERROR IS: PAUSE RESUME NO SHRL
BMC50004I NGTUTIL PHASE COMPLETE.  ELAPSED TIME = 00:00:01 

Message BMC50186I describes the reason that prevents the job from switching from UNLOAD PLUS to BMC AMI Unload.

The full reason for the switch not occurring is described in the SYSERROR DD statement. For example:

MAIN.LD900PAR NGTU782 TEXT IN ERROR IS: PAUSE RESUME NO SHRL
MAIN.LD900PAR NGTU783 REASON FOR ERROR: PARAMETER IS NOT RECOGNIZED.
MAIN.LD900PAR NGTU783 FOR SUB KEYWORD : PRELOAD.
MAIN.LD900PAR NGTU784 EXPECTED TOKENS FOLLOWS:
MAIN.LD900PAR NGTU785 "LOAD","CONTINUE".
MAIN.RRGSRTNS NGTZ170 ERROR OCCURRED IN STATEMENT NUMBER 1 

In this example, the user specified PRELOAD PAUSE in the LOAD statement.

  • SmartSwitch is enabled.
  • The job matches a rule that contains ALLOW_SWITCH.
  • The UNLOAD PLUS can execute the job only by invoking DSNUTILB.
  • The BMC AMI Utilities parser prevents the job switching from UNLOAD PLUS to BMC AMI Unload.
BMC50004I UTILINIT PHASE COMPLETE.  ELAPSED TIME = 00:00:00
BMC50182I DSNUTILB REQUIRED: INDEX CONTAINS A RANDOM KEY INDEX 'RKB '.'RKBUTSCR '
BMC54003I SMARTSWITCH RULE: ALLOW_SWITCH  COMMENT: SEND JOBS FROM RDARKB TO BMC AMI UTILITIES
BMC50186I SMARTSWITCH SYNTAX VERIFICATION RC=00000008 :  REORG PARSER ERROR: NGTU781 SYNTAX ERROR OCCURRED AT STATEMENT NO. 1
BMC50004I NGTUTIL PHASE COMPLETE.  ELAPSED TIME = 00:00:01
DSNU000I    108 17:45:46.99 DSNUGUTC - OUTPUT START FOR UTILITY, UTILID = RKBRSSW1

In this example, the user used a DEADLINE keyword in the SYSIN that triggered the BMC AMI Utilities parser error.

  • SmartSwitch is enabled.
  • The job matches a rule that contains ALLOW_SWITCH.
  • The UNLOAD PLUS can execute the job only by invoking DSNUTILB.
  • The BMC AMI Utilities parser determines that the job can switch from UNLOAD PLUS to BMC AMI Unload.
BMC50004I UTILINIT PHASE COMPLETE.  ELAPSED TIME = 00:00:00
BMC50182I DSNUTILB REQUIRED: INDEX CONTAINS A RANDOM KEY INDEX 'RKB '.'RKBUTSCR '
BMC54003I SMARTSWITCH RULE: ALLOW_SWITCH  COMMENT: SEND JOBS FROM RDARKB TO BMC AMI UTILITIES
BMC50186I SMARTSWITCH SYNTAX VERIFICATION RC=00000004 :  BMC AMI UTILITIES CAN PROCESS THIS REORG BY INVOKING DSNUTILB
BMC50004I NGTUTIL PHASE COMPLETE.  ELAPSED TIME = 00:00:01

In this example, the job switches to the BMC AMI Utilities , but because there was an index in RBDP status, BMC AMI Unload in turn invokes DSNUTILB.

Related topic

How-SmartSwitch-works

 

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

UNLOAD PLUS for DB2 11.2