New (Journal constructor)

<section begin=dpl_desc/>New instance of a Journal object<section end=dpl_desc/>

New is a member of the Journal class.

  %jrnl = new(name)

%jrnl: A reference to an instance of a Journal object.
name: A string that is the DDname of the journal dataset or the name of the stream that is to be accessed.

In Sirius Mods version 7.7, the New method returns a Null object if the journal is not present or is not a valid journal. In Sirius Mods version 7.8 and later, New also throws a BadJournal exception (?? refid=bdjrnl.) on an error, and it will not return a Null Journal object without throwing an exception. Consequently, invocations of New in Sirius Mods version 7.7 need to include a test with an On Error unit and a test for a Null result.
In Sirius Mods version 7.7, New does not require the input journal to be from the same Model 204 release as the Online. However, if the releases are different, an AppendJournalData call that references this journal will silently fail to add any data to its output Stringlist. As of Sirius Mods version 7.8, an attempt to instantiate a journal object variable that references a journal from a different version than the Online produces a BadJournal exception.

Navigation menu