APPNAME = LITERAL (Read)
The application name to be
recorded in the new history record. If a null value (!
) is supplied, a default of
"HISCOM"
is used and the new history record describes the parameter values supplied
when HISCOM was invoked. If a non-null value is supplied, the new history record refers
to the specified application name instead of "HISCOM"
and does not describe the HISCOM
parameter values. [!]
COMMENT = LITERAL (Read)
A line of commentary limited to 72
characters. If the value is supplied on the command line only that line of commentary
will be written into the history. Otherwise repeated prompting enables a series of
commentary lines to be supplied. A null value (!
) terminates the loop. Blank lines
delimit paragraphs. Paragraph wrapping is enabled by Parameter WRAP. There is no
suggested default to allow more room for entering the value.
DATE = LITERAL
(Read)
The date and time to associated with the new history record. Normally, a
null (
!
) value should be supplied, in which case the current UTC date and time
will be used. If a value is supplied, it should be in one of the following
forms.
-
Gregorian Calendar Date –- With the month expressed either as an integer or a
three-character abbreviation, and with optional decimal places to represent a fraction
of a day ("1996-10-2"
or "1996-Oct-2.6"
for example). If no fractional part of a day is
given, the time refers to the start of the day (zero hours).
-
Gregorian Date and Time –- Any calendar date (as above) but with a fraction of a day
expressed as hours, minutes and seconds ("1996-Oct-2 12:13:56.985"
for example). The
date and time can be separated by a space or by a "T"
(as used by ISO 8601
format).
-
Modified Julian Date –- With or without decimal places ("MJD 54321.4"
for example).
-
Julian Date –- With or without decimal places ("JD 2454321.9"
for example).
[!]
FILE = FILENAME (Read)
Name of the text file containing the commentary. It is only
accessed if MODE="File"
.
The
interaction mode. The allowed
values are described below.
"File"
–- The commentary is to be read from a text file. The formatting and layout of
the text is preserved in the history unless WRAP=TRUE
and there are lines longer than
the width of the history records.
"Interface"
–- The commentary is to be supplied through a parameter. See Parameter
COMMENT.
["Interface"]
NDF = (Read and Write)
The NDF for which commentary is to be added
to the history.
WRAP = _LOGICAL (Read)
WRAP=TRUE
requests that the paragraphs of
comments are wrapped to make as much text fit on to each line of the history record as
possible. WRAP=FALSE
means that the commentary text beyond the width of the
history records (72 characters) is lost. If a null (!
) value is supplied, the
value used is TRUE
when MODE="Interface"
and FALSE
if MODE="File"
. [!]