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.
LATEST COMMENTS
MC Press Online