+JOURNAL

The +JOURNAL parameter controls the creation of the journal file associated with BMC AMI Utilities processing.

Important

The journal contains trace messages for the exclusive use of BMC Customer Support. Many of these messages are intentionally not documented. This does not indicate a problem with the software or the documentation.

Related topic

Global-parameters-UTLPARMS

JOURNAL.png

The values are defined as follows:

NO

(default) No journal prints.

YES

Journal prints to JRNLOUT DD. You may define this DD to SYSOUT or to a static data set. If you use a static data set, you must

  • Specify the DCB with the following attributes: RECFM=FBA, LRECL=133.
  • Set the BLKSIZE to 0 so that the system sets a default value based on the DASD type.

ONERROR

If an error occurs, and the product is left in a restartable state, send journal output to the JRNLOUT DD.

Example
//JRNLOUT  DD SYSOUT=*
//UTLPARMS DD *
+JOURNAL(YES)

A journal is sent to JRNLOUT.

Example
//JRNLOUT  DD DISP=SHR,DSN=USER.NGT.JOURNAL
//UTLPARMS DD *
+JOURNAL(YES)

A journal is sent to the data set USER.NGT.JOURNAL.

Example
//NGT1233  EXEC PGM=NGTUTIL,PARM='DB2T,ACCTG2009,RESTART'
//JRNLOUT  DD DISP=SHR,DSN=USER.NGT.JOURNAL
//UTLPARMS DD *
+JOURNAL(ONERROR)

A journal is sent to the data set USER.NGT.JOURNAL. The utility ID ACCTG2009 (if an error) occurs and the product is marked restartable.

Important

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

 

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