RESTAUTH command: Difference between revisions
m (1 revision) |
mNo edit summary |
||
(2 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
The RESTART utility allows users outside the | <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> | ||
issue certain commands while the [[ONLINE]] or [[BATCH204]] job is running. | |||
Users can be authorized to do this with the RESTAUTH command. | The RESTART utility allows users outside the <var class="product">Model 204</var> address space to | ||
Since under MVS it is impossible to determine the originator of a MODIFY | issue certain commands while the [[Online|ONLINE]] or [[Using HLI and batch configurations#BATCH204|BATCH204]] job is running. | ||
command, any user that is capable of issuing a MODIFY command is | 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 <var>MODIFY</var> | |||
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 11: | 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 <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> | |||
</ | authorizes CMS users <code>SKIPPER</code> and <code>GILLIGAN</code> to issue RESTART utility | ||
authorizes CMS users SKIPPER and GILLIGAN 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 29: | Line 30: | ||
any single character. | any single character. | ||
For example: | For example: | ||
< | <p class="code">RESTAUTH PROF* *ANN GING?? *HOWE* | ||
</p> | |||
</ | authorizes any CMS userid that begins with the letters <code>PROF</code>, ends | ||
authorizes any CMS userid that begins with the letters | with the letters <code>ANN</code>, begins with the letters <code>GING</code> and is exactly | ||
with the letters | six characters long, or has the letters <code>HOWE</code> anywhere in it to issue | ||
six characters long, or has the letters | |||
RESTART utility commands (via SMSG). | RESTART utility commands (via SMSG). | ||
[[Category:System administrator commands]] | [[Category:System administrator commands]] | ||
[[Category:Commands]] | [[Category:Commands]] |
Latest revision as of 00:24, 10 October 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).