New (Journal constructor): Difference between revisions
Jump to navigation
Jump to search
m (1 revision) |
mNo edit summary |
||
| Line 1: | Line 1: | ||
<span style="font-size:120%; color:black"><b><section begin=dpl_desc/><section end=dpl_desc/></b></span> | <span style="font-size:120%; color:black"><b><section begin=dpl_desc/> | ||
New instance of a Journal object<section end=dpl_desc/></b></span> | |||
[[Category:Journal methods|New constructor]] | [[Category:Journal methods|New constructor]] | ||
<!--DPL?? Category:Journal methods|New constructor: --> | <!--DPL?? Category:Journal methods|New constructor: --> | ||
| Line 5: | Line 6: | ||
New is a member of the [[Journal class]]. | New is a member of the [[Journal class]]. | ||
</p> | </p> | ||
===Syntax=== | ===Syntax=== | ||
%jrnl = new(name) | %jrnl = new(name) | ||
Revision as of 03:13, 2 January 2011
<section begin=dpl_desc/> New instance of a Journal object<section end=dpl_desc/>
New is a member of the Journal class.
Syntax
%jrnl = new(name)
Syntax Terms
- %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.
Usage Notes
- 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.