DEFCNTX and APDFCNTX parameters: Difference between revisions
(Created page with "<var>DEFCNTX</var> {{Template:DEFCNTX parameter subtitle}} <var>APDFCNTX</var> {{Template:APDFCNTX parameter subtitle}} ==Summary== <dl> <dt>Default value <dd>None <dt>Parame...") |
No edit summary |
||
| Line 17: | Line 17: | ||
==Description== | ==Description== | ||
< | These parameters are better than using <code>$View('CURFILE')</code> because: | ||
<p> | <ul> | ||
<li><code>CURFILE</code> returns a null string if the default context is a group. | |||
<li><code>CURFILE</code> is affected by the <var>IN</var> clause prior to a <var>Begin</var> command and | |||
can be affected by the <var>In</var> clause prior to many SOUL statements. | |||
<li><var>APDFCNTX</var> provides information not about the default context when the request was compiled, but | |||
</ul> | |||
If there is no default context, the value of the parameters is the null string. | |||
Otherwise <code>$View('DEFCNTX')</code> returns the type of context (<code>FILE</code>, <code>TEMP GROUP</code>, or | |||
<code>PERM GROUP</code>) followed by the file or group name, with trailing blanks | |||
removed. | |||
<code>$View('APDFCNTX')</code> returns the same information based on the default | |||
context when the APSY was entered, unless that is the same as one of the files or groups in the subsystem's definition; in that case, the null string is returned. | |||
<blockquote class="note"><b>Notes:</b> In versions 7.4 and 7.5, these parameters are only available using the <code>$View</code> function, for example: | |||
<p class="code">print $view('DEFCNTX')</p> | |||
<ul> | |||
<li>Prior to version 7.6, they are not available with the <var>VIEW</var> command. | |||
<li>In version 7.4, they were implemented as part of maintenance - Early Warning 740EW159. | |||
<li>In version 7.4, they were implemented as part of maintenance - zap 75Z054. | |||
</ul> | |||
</blockquote> | |||
[[Category:User parameters]] | [[Category:User parameters]] | ||
[[Category:Parameters]] | [[Category:Parameters]] | ||
Revision as of 12:19, 7 April 2015
DEFCNTX Default file or group context APDFCNTX Default file or group context when APSY command issued
Summary
- Default value
- None
- Parameter type
- User
- Where set
- View-only
- Related products
- All
- Introduced
- Model 204 V7.4 or earlier
Description
These parameters are better than using $View('CURFILE') because:
CURFILEreturns a null string if the default context is a group.CURFILEis affected by the IN clause prior to a Begin command and can be affected by the In clause prior to many SOUL statements.- APDFCNTX provides information not about the default context when the request was compiled, but
If there is no default context, the value of the parameters is the null string.
Otherwise $View('DEFCNTX') returns the type of context (FILE, TEMP GROUP, or
PERM GROUP) followed by the file or group name, with trailing blanks
removed.
$View('APDFCNTX') returns the same information based on the default
context when the APSY was entered, unless that is the same as one of the files or groups in the subsystem's definition; in that case, the null string is returned.
Notes: In versions 7.4 and 7.5, these parameters are only available using the
$Viewfunction, for example:print $view('DEFCNTX')
- Prior to version 7.6, they are not available with the VIEW command.
- In version 7.4, they were implemented as part of maintenance - Early Warning 740EW159.
- In version 7.4, they were implemented as part of maintenance - zap 75Z054.