Previous Topic: CXXCLONENext Topic: External Security for DBUTLTY

Version 14.0 › CA Datacom Tools Products › New Features and Enhancements › DBUTLTY Features › Debugging Using an Additional SYSIN with the DBUTLTY SET Function

Debugging Using an Additional SYSIN with the DBUTLTY SET Function

The additional SYSIN SET feature allows you to debug DBUTLTY functions by processing JCL containing DBUTLTY DIAGOPTIONs and debugging messages in front of the SYSIN JCL. The DIAGOPTIONs and debugging messages are turned on using DBUTLTY SET functions with the OPTION1= keyword. This is not a common requirement. The option is also used to define configuration options, including many of the SET functions, the FORCE function, and the DEFAULT function.

Note: Some of the valid additional SYSIN SET options can be used for more than just debugging.

The additional SYSIN JCL is defined by a module, DBIN1PR, that is assembled using a DBIN1PR macro. When a DBIN1PR module is loaded before SYSIN processing begins, the DBIN1PR module is processed as an alternate SYSIN before the processing of the provided SYSIN. The DBUTLTY SET function must start column 1 followed by one blank and OPTION1= keyword. Each SET statement is echoed to the console. No SYSPRINT/SYSLST output occurs.

Each SET statement must be contained in a single line. The value after the equal sign (=) cannot be in quote values as is allowed or required when processed during the normal SYSIN. Not all OPTION1= values can be used. The FORCE and DEFAULT values must also be specified in column 1, followed by one blank and OPTION1=.

Note: If an asterisk (*) is used in column 1, the statement is ignored, and IGNORED is displayed.

The DBIN1PR macro providing the additional SYSIN can be built using two different techniques. The first is to define the input statements in place. This is the simpler approach.

Note: z/OS and z/VSE support the technique of putting the statements directly into the DBIN1PR Macro.

The second is to define a PDS data set that is to contain the additional SYSIN statements along with the member name in the PDS.

Note: z/OS supports the PDS data set technique.

The following are examples of the message that occurs when the additional SYSIN is processed:

For more information, see the CA Datacom/DB DBUTLTY Reference Guide for z/OS.