OPENCTL parameter: Difference between revisions

From m204wiki
Jump to navigation Jump to search
(Automatically generated page update)
(Automatically generated page update)
 
(9 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Template:OPENCTL parameter subtitle}}
==Summary==
==Summary==
<dl>
<dl>
Line 10: Line 11:
<dd>All
<dd>All
<dt>Introduced
<dt>Introduced
<dd><var class="product">Model 204 V6.1</var> or earlier
<dd><var class="product">Model 204 V2.1</var> or earlier
</dl>
</dl>
==Description==
==Description==
Whether a valid password must be entered when the file is opened and whether the file can be opened remotely  
Whether a valid password must be entered when the file is opened and whether the file can be opened remotely  
<p class="note"><b>Note:</b> When a file is opened, <var class="product">Model&nbsp;204</var> resets bits that are not currently defined by Rocket Software for the OPENCTL parameter. You cannot use the RESET command to set bits that are currently undefined by Rocket Software. If an application makes use of any of the undefined bits of the OPENCTL parameter, it might produce unexpected results.</p>
<p class="note"><b>Note:</b> When a file is opened, <var class="product">Model&nbsp;204</var> resets bits that are not currently defined by Rocket Software for the <var>OPENCTL</var> parameter. You cannot use the <var>[[RESET command|RESET]]</var> command to set bits that are currently undefined by Rocket Software. If an application makes use of any of the undefined bits of the <var>OPENCTL</var> parameter, it might produce unexpected results.</p>
<p>The settings of OPENCTL for public, semi-public, private, remote, and secured files are shown in the table below.</p>
<p>
<p>Except as specified in the following table, OPENCTL settings can be added together. The first three settings are mutually exclusive and one of them must be included in your OPENCTL specification. The remaining settings in the table are options that you can add to one of the first three settings. </p>
The settings of <var>OPENCTL</var> for public, semi-public, private, remote, and secured files are shown in the table below.</p>
<p>
Except as specified in the following table, <var>OPENCTL</var> settings can be added together. The first three settings are mutually exclusive and one of them must be included in your <var>OPENCTL</var> specification. The remaining settings in the table are options that you can add to one of the first three settings. </p>
<table>
<table>
<caption>OPENCTL settings</caption>
<caption>OPENCTL settings</caption>
<tr><th>Setting</th><th>Means file is...</th><th>Password handling</th></tr>
<tr class="head"><th>Setting</th><th>Means file is...</th><th>Password handling</th></tr>
<tr><th align="right"><var>X'80'</var></th><td>Public</td><td>
 
<p>Password is not requested and the file is opened with default privileges. </p>
<tr><th><var>X'80'</var></th>
<p>This setting cannot be combined with X'40'.</p>
<td>Public</td><td>
<p>
Password is not requested and the file is opened with [[PRIVDEF parameter|default privileges]]>. </p>
<p>
This setting cannot be combined with X'40'.</p>
</td></tr>
</td></tr>
<tr><th align="right"><var>X'40'</var></th><td>semi-public</td><td>
 
<p>User is asked for a password. For a valid password, the user is given the associated privileges. Otherwise, the user is granted default file privileges. </p>
<tr><th><var>X'40'</var></th>
<td>semi-public</td><td>
<p>
User is asked for a password. For a valid password, the user is given the associated privileges. Otherwise, the user is granted default file privileges. </p>
<p>This setting cannot be combined with X'80'.</p>
<p>This setting cannot be combined with X'80'.</p>
</td></tr>
</td></tr>
<tr><th align="right"><var>X'00'</var></th><td>Private</td><td>Without a valid password the file is not opened.</td></tr>
 
<tr><th align="right"><var>X'20'</var></th><td>Using record security</td><td>No effect.</td></tr>
<tr><th><var>X'00'</var></th>
<td>Private</td>
<td>Without a valid password the file cannot be opened.</td></tr>
<tr><th align="right"><var>X'20'</var></th><td>Using [[Model 204 security features#Record_security|record security]]</td>
<td>No effect.</td></tr>
 
<tr><th colspan="3"><var>
<tr><th colspan="3"><var>
<p><b>Additional options for PQO</b></p>
<p><b>Additional options for [[PQO: Overview of Parallel Query Option/204|PQO]]</b></p>
</var></th></tr>
</var></th></tr>
<tr><th align="right"><var>X'08'</var></th><td>Accessible remotely without a valid password </td><td>For a public file, no password is requested and the file is opened with default privileges.
 
<p>For a semi-public file, a password is requested. If the password is missing or invalid, the user is granted default file privileges.</p>
<tr><th><var>X'08'</var></th>
<p>For a private file, or a semi-public file that a remote user presents a valid password for,  the file is opened if X'02' is set. </p>
<td>Accessible remotely without a valid password </td>
<td>For a public file, no password is requested and the file is opened with default privileges.
<p>
For a semi-public file, a password is requested. If the password is missing or invalid, the user is granted default file privileges.</p>
<p>
For a private file, or a semi-public file that a remote user presents a valid password for,  the file is opened if X'02' is set. </p>
</td></tr>
</td></tr>
<tr><th align="right"><var>X'04'</var></th><td>Accessible  remotely as a permanent group member</td><td>
 
<p><var class="product">Model&nbsp;204</var> permanent group security is in effect. Password handling for local users is unaffected.</p>
<tr><th><var>X'04'</var></th>
<td>Accessible  remotely as a permanent group member</td><td>
<p><var class="product">Model&nbsp;204</var> permanent [[Model 204 security features#Group_security|group security]] is in effect. Password handling for local users is unaffected.</p>
</td></tr>
</td></tr>
<tr><th align="right"><var>X'02'</var></th><td>Accessible remotely with a valid password</td><td>For a private file, or a semi-public file that a remote user presents a valid password for, the file is opened. </td></tr>
 
<tr><th align="right"><var>X'00'</var></th><td>Accessible remotely via APSY</td><td>For any file, no password is requested and the file cannot be opened remotely, except within a trusted subsystem.</td></tr>
<tr><th><var>X'02'</var></th>
<td>Accessible remotely with a valid password</td>
<td>For a private file, or a semi-public file that a remote user presents a valid password for, the file is opened. </td></tr>
 
<tr><th><var>X'00'</var></th>
<td>Accessible remotely via APSY</td><td>For any file, no password is requested and the file cannot be opened remotely, except within a trusted subsystem.</td></tr>
</table>
</table>
<p>The file manager can turn off the record security option (X'20') with the RESET command, but the file manager can turn on that option only by issuing the CREATE command.</p>
<p>
<p>The PQO remote access settings (X'08', X'04', X'02') have no affect on files that are only accessed locally. For more information about PQO remote files, see the <var>Parallel Query Option/204 User's Guide.</var></p>
The file manager can turn off the record security option (X'20') with the <var>RESET</var> command, but the file manager can turn on that option only by issuing the <var>CREATE</var> command.</p>
<p>
The PQO remote access settings (X'08', X'04', X'02') have no affect on files that are only accessed locally. For more information about PQO remote files, see [[PQO: Remote files and scattered groups]].</p>
   
   
<p class="note"><b>Note:</b> OPENCTL is ignored when a file defined in an application subsystem is opened within that subsystem. File privileges are specified in the subsystem definition.</p>
<p class="note"><b>Note:</b> <var>OPENCTL</var> is ignored when a file defined in an application subsystem is opened within that subsystem. File privileges are specified in the subsystem definition.</p>
 
[[Category:CREATE parameters]]
[[Category:CREATE parameters]]
[[Category:File parameters]]
[[Category:File parameters]]
[[Category:Parameters]]
[[Category:Parameters]]

Latest revision as of 20:52, 7 April 2017

Open control flags

Summary

Default value
X'80'
Parameter type
File
Where set
During file creation or reset by file manager
Related products
All
Introduced
Model 204 V2.1 or earlier

Description

Whether a valid password must be entered when the file is opened and whether the file can be opened remotely

Note: When a file is opened, Model 204 resets bits that are not currently defined by Rocket Software for the OPENCTL parameter. You cannot use the RESET command to set bits that are currently undefined by Rocket Software. If an application makes use of any of the undefined bits of the OPENCTL parameter, it might produce unexpected results.

The settings of OPENCTL for public, semi-public, private, remote, and secured files are shown in the table below.

Except as specified in the following table, OPENCTL settings can be added together. The first three settings are mutually exclusive and one of them must be included in your OPENCTL specification. The remaining settings in the table are options that you can add to one of the first three settings.

OPENCTL settings
SettingMeans file is...Password handling
X'80' Public

Password is not requested and the file is opened with default privileges>.

This setting cannot be combined with X'40'.

X'40' semi-public

User is asked for a password. For a valid password, the user is given the associated privileges. Otherwise, the user is granted default file privileges.

This setting cannot be combined with X'80'.

X'00' Private Without a valid password the file cannot be opened.
X'20'Using record security No effect.

Additional options for PQO

X'08' Accessible remotely without a valid password For a public file, no password is requested and the file is opened with default privileges.

For a semi-public file, a password is requested. If the password is missing or invalid, the user is granted default file privileges.

For a private file, or a semi-public file that a remote user presents a valid password for, the file is opened if X'02' is set.

X'04' Accessible remotely as a permanent group member

Model 204 permanent group security is in effect. Password handling for local users is unaffected.

X'02' Accessible remotely with a valid password For a private file, or a semi-public file that a remote user presents a valid password for, the file is opened.
X'00' Accessible remotely via APSYFor any file, no password is requested and the file cannot be opened remotely, except within a trusted subsystem.

The file manager can turn off the record security option (X'20') with the RESET command, but the file manager can turn on that option only by issuing the CREATE command.

The PQO remote access settings (X'08', X'04', X'02') have no affect on files that are only accessed locally. For more information about PQO remote files, see PQO: Remote files and scattered groups.

Note: OPENCTL is ignored when a file defined in an application subsystem is opened within that subsystem. File privileges are specified in the subsystem definition.