Printing messages and control statements

You can select the type of messages you want written to the message data set during installation or at run time. Messages ICE097I and ICE158A are written only to the master console.

If installation option NOMSGDD=QUIT is in effect, you must provide a DD statement using the name of the alternate message data set specified during installation or at run time, or a SYSOUT DD statement. Otherwise, DFSORT terminates with a return code of 20.

The following list outlines the hierarchy for message and control statements for the Blockset and Peerage/Vale sorting techniques. SORTDIAG DD, MSGPRT, and LIST, as they are used here, represent all methods of specifying the appropriate function. For example, FLAG (I) in the EXEC PARM field is equivalent to MSGPRT=ALL, and installation option DIAGSIM=YES is equivalent to specifying a SORTDIAG DD statement for every job.

Note: When an error message (ICExxxA) is issued and the message data set is available, DFSORT will display the diagnostic messages (ICE75xI, ICE8xxI and ICE9xxI) even if they are not requested (by DIAGSIM=YES or a SORTDIAG DD). This can improve first failure data capture and remove the need to rerun the application to display diagnostic messages.

SORTDIAG DD statement: Prints all messages (including diagnostic messages); prints control statements. A message data set DD statement should be provided.
When SORTDIAG DD is specified, Blockset error messages that are normally suppressed are printed. This may result in an error message being printed for a run that is actually successfully completed by another technique (as indicated by a return code of 0 or 4).
MSGPRT=ALL and LIST in effect: Prints all messages except diagnostic messages; prints control statements. A message data set DD statement should be provided.
MSGPRT=ALL and NOLIST in effect: Prints all messages except diagnostic messages; does not print control statements. A message data set DD statement should be provided.
MSGPRT=CRITICAL and LIST in effect: Prints only critical error messages; prints control statements. A message data set DD statement should be provided.
Control statements are not printed if MSGPRT=CRITICAL is in effect and DFSORT is dynamically invoked using the 24-bit parameter list.
MSGPRT=CRITICAL and NOLIST in effect: Prints only critical error messages; does not print control statements. A message data set DD statement should be provided.
MSGPRT=NONE in effect: Does not print messages; does not print control statements.