RESTAUTH command: Difference between revisions
mNo edit summary |
mNo edit summary |
||
| Line 1: | Line 1: | ||
<p class="note"><b>Note:</b> This is a <var class="product">[[Sirius Mods]]</var>-only command prior to Version 7.5 of <var class="product">[[Model 204]]</var>.</p> | <p class="note"><b>Note:</b> This is a <var class="product">[[Sirius Mods]]</var>-only command prior to Version 7.5 of <var class="product">[[Model 204]]</var>.</p> | ||
The RESTART utility allows users outside the | The RESTART utility allows users outside the <var class="product">Model 204</var> address space to | ||
issue certain commands while the [[ONLINE | issue certain commands while the [[Model_204 configurations and operating environments#Model 204 configurations|ONLINE or BATCH204]] job is running. | ||
Users can be authorized to do this with the RESTAUTH command. | Users can be authorized to do this with the <var>RESTAUTH</var> command. | ||
Since under MVS it is impossible to determine the originator of a MODIFY | Since under MVS it is impossible to determine the originator of a <var>MODIFY</var> | ||
command, any user that is capable of issuing a MODIFY command is | command, any user that is capable of issuing a <var>MODIFY</var> command is | ||
considered to be authorized by the RESTART utility. | considered to be authorized by the RESTART utility. | ||
Since generally, most users don't have this privilege, this is not a problem. | Since generally, most users don't have this privilege, this is not a problem. | ||
| Line 13: | Line 13: | ||
Fortunately, the issuer of a SMSG command to the RESTART utility can be | Fortunately, the issuer of a SMSG command to the RESTART utility can be | ||
determined so a user must be authorized to issue RESTART utility commands | determined so a user must be authorized to issue RESTART utility commands | ||
via the RESTAUTH command. | via the <var>RESTAUTH</var> command. | ||
RESTAUTH is a <var class="product">Model 204</var> command that can only be issued by a system | <var>RESTAUTH</var> is a <var class="product">Model 204</var> command that can only be issued by a system manager or system administrator. | ||
manager or system administrator. | |||
===RESTAUTH command syntax=== | ===RESTAUTH command syntax=== | ||
<p class="syntax">RESTAUTH userlist</p> | <p class="syntax">RESTAUTH <span class="term">userlist</span></p> | ||
The RESTAUTH command should be followed by a list of userids that are | The <var>RESTAUTH</var> command should be followed by a list of userids that are | ||
authorized to issue RESTART utility commands. | authorized to issue RESTART utility commands. | ||
For example: | For example: | ||
<p class="code">RESTAUTH SKIPPER GILLIGAN | <p class="code">RESTAUTH SKIPPER GILLIGAN | ||
</p> | </p> | ||
authorizes CMS users SKIPPER and GILLIGAN to issue RESTART utility | authorizes CMS users <code>SKIPPER</code> and <code>GILLIGAN</code> to issue RESTART utility | ||
commands (via SMSG). | commands (via SMSG). | ||
Wildcards can also be used in the userids. | Wildcards can also be used in the userids. | ||
| Line 32: | Line 32: | ||
<p class="code">RESTAUTH PROF* *ANN GING?? *HOWE* | <p class="code">RESTAUTH PROF* *ANN GING?? *HOWE* | ||
</p> | </p> | ||
authorizes any CMS userid that begins with the letters | authorizes any CMS userid that begins with the letters <code>PROF</code>, ends | ||
with the letters | with the letters <code>ANN</code>, begins with the letters <code>GING</code> and is exactly | ||
six characters long, or has the letters | six characters long, or has the letters <code>HOWE</code> anywhere in it to issue | ||
RESTART utility commands (via SMSG). | RESTART utility commands (via SMSG). | ||
[[Category:System administrator commands]] | [[Category:System administrator commands]] | ||
[[Category:Commands]] | [[Category:Commands]] | ||
Revision as of 16:34, 12 August 2014
Note: This is a Sirius Mods-only command prior to Version 7.5 of Model 204.
The RESTART utility allows users outside the Model 204 address space to issue certain commands while the ONLINE or BATCH204 job is running. Users can be authorized to do this with the RESTAUTH command. Since under MVS it is impossible to determine the originator of a MODIFY command, any user that is capable of issuing a MODIFY command is considered to be authorized by the RESTART utility. Since generally, most users don't have this privilege, this is not a problem.
Under CMS, however, RESTART utility commands are issued via the VM SMSG facility, a facility available to all users. Fortunately, the issuer of a SMSG command to the RESTART utility can be determined so a user must be authorized to issue RESTART utility commands via the RESTAUTH command. RESTAUTH is a Model 204 command that can only be issued by a system manager or system administrator.
RESTAUTH command syntax
RESTAUTH userlist
The RESTAUTH command should be followed by a list of userids that are authorized to issue RESTART utility commands. For example:
RESTAUTH SKIPPER GILLIGAN
authorizes CMS users SKIPPER and GILLIGAN to issue RESTART utility
commands (via SMSG).
Wildcards can also be used in the userids.
An asterisk matches any group of characters and a question mark matches
any single character.
For example:
RESTAUTH PROF* *ANN GING?? *HOWE*
authorizes any CMS userid that begins with the letters PROF, ends
with the letters ANN, begins with the letters GING and is exactly
six characters long, or has the letters HOWE anywhere in it to issue
RESTART utility commands (via SMSG).