OPENCTL parameter: Difference between revisions
Jump to navigation
Jump to search
(Automatically generated page update) |
|||
| (2 intermediate revisions by 2 users not shown) | |||
| Line 16: | Line 16: | ||
==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 204</var> resets bits that are not currently defined by Rocket Software for the OPENCTL parameter. You cannot use the <var>[[ | <p class="note"><b>Note:</b> When a file is opened, <var class="product">Model 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 | |||
<p>Password is not requested and the file is opened with | <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 | |||
<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 | |||
<tr><th align="right"><var>X'20'</var></th><td>Using | <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 | <p><b>Additional options for [[PQO: Overview of Parallel Query Option/204|PQO]]</b></p> | ||
</var></th></tr> | </var></th></tr> | ||
<tr><th | |||
<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 | |||
<p><var class="product">Model 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 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 | |||
<tr><th | <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 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.
| Setting | Means 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 APSY | For 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.