The Maintain Journal (MTNJRN) command provides a number of facilities to manage

journals and journal receivers on your system. The command gives you the

ability to change journals to new journal receivers and delete old journal

receivers. When you use the command, you start by specifying the library and

the journal that you want to maintain.

A number of parameters on the command give you the ability to maintain the

journals. The parameters let you generate new journal receivers, delete old

journal receivers, specify the number of days to retain detached journal

receivers, and determine whether a message should be sent if you are deleting

journal receivers that haven't been saved. MTNJRN doesn't save journal

receivers, so you may need to do that before running this command. MTNJRN is a

slow-running command and therefore may need to be submitted to batch.

Required Parameters

JRN

Specify the qualified name of the journal you want to maintain with this

command.

The possible library values are

*LIBL: The utility uses the library list to locate the journal.

library-name: Specify the name of the library where the utility can locate the

journal.

The possible journal name values are

*ALLSTD: All standard IBM-supplied journals are maintained. The journals

include QAOSDIAJRN, QSNADS, QDSNX, and QSXJRN.

*OFFICE: The utility maintains the IBM-supplied journal QAOSDIAJRN.

*SNADS: The utility maintains the IBM-supplied journal QSNADS.

*DSNX: The utility maintains the IBM-supplied journal QDSNX.

*PROB: The utility maintains the IBM-supplied journal QSXJRN.

journal-name: Specify the name of the journal that you want to maintain.

Optional Parameters

GENNEWRCVR

Specify whether the utility should generate new journal receivers. You must

either specify this parameter as *YES, or you must specify DLTOLDRCVR(*YES).

*NO: The utility does not generate new journal receivers.

*YES: The utility generates new journal receivers.

DLTOLDRCVR

Specify whether the utility should delete old journal receivers for the journal

specified in the parameter JRN. You must specify either this parameter as *YES,

or you must specify GENNEWRCVR(*YES).

*NO: The utility does not delete old journal receivers.

*YES: The utility deletes old journal receivers.

RETAINDAYS

Specify the number of days to retain existing detached journal receivers. This

parameter refers to the date the journal receiver was attached, not the date

that the receiver was detached.

1: Detached journal receivers are eligible for deletion if it has been more

than one day since they were attached.

retain-days: Specify the number of days to elapse for detached journal

receivers to become eligible for deletion. Valid values range from 0 to 999.

SAVINQMSG

Specify whether the utility should send a system inquiry message if you

specified DLTOLDRCVR(*YES) and any of the journal receivers that would be

deleted have not been saved yet. The message informs the operator that the

journal receiver has not been saved. The operator can reply to ignore this

error, in which case the journal receiver is deleted. The operator can also

reply to cancel the operation, which preserves the journal receiver.

*YES: The inquiry message is sent if necessary. The operator can respond with

either I to ignore or C to cancel.

*NO: The inquiry message is not sent. The utility may delete old journal

receivers that have not been saved without warning the operator.

Example

MTNJRN JRN(*ALLSTD) +

GENNEWRCVR(*YES)

This command generates new journal receivers for the IBM-supplied journals. You

would normally follow this command with a save of the old journal receivers,

then by the following command, which would delete the old journal receivers.

MTNJRN JRN(*ALLSTD) +

DLTOLDRCVR(*YES)

Prerequisites

The following tools from the QUSRTOOL library must be on your system before you

can create MTNJRN.

ADDDAT

EDTVAR

CVTJRNA

RTVOBJD

SOURCE MEMBERS

INFO: MTNJRN (QATTINFO)

CDO: TAAJRNC (QATTCMD)

CPP: TAAJRNCC (QATTCL)

Jim Hoopes is a senior technical editor for Midrange Computing.

This tool is documented in Midrange Computing's QUSRTOOL Command Reference. The

manual contains explanations and syntax diagrams for more than 300 useful

tools.