RESTAUTH command: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
 
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>
The RESTART utility allows users outside the [[Model 204]] address space to
The RESTART utility allows users outside the [[Model 204]] address space to
issue certain commands while the [[ONLINE]] or [[BATCH204]] job is running.
issue certain commands while the [[ONLINE]] or [[BATCH204]] job is running.
Line 15: Line 17:
manager or system administrator.
manager or system administrator.
===RESTAUTH command syntax===
===RESTAUTH command syntax===
  RESTAUTH userlist
<p class="syntax">RESTAUTH userlist</p>


The RESTAUTH command should be followed by a list of userids that are
The RESTAUTH 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:
<pre>
<p class="code">RESTAUTH SKIPPER GILLIGAN
    RESTAUTH SKIPPER GILLIGAN
</p>
</pre>
authorizes CMS users SKIPPER and GILLIGAN to issue RESTART utility
authorizes CMS users SKIPPER and GILLIGAN to issue RESTART utility
commands (via SMSG).
commands (via SMSG).
Line 29: Line 30:
any single character.
any single character.
For example:
For example:
<pre>
<p class="code">RESTAUTH PROF* *ANN GING?? *HOWE*
    RESTAUTH PROF* *ANN GING?? *HOWE*
</p>
</pre>
authorizes any CMS userid that begins with the letters 'PROF', ends
authorizes any CMS userid that begins with the letters 'PROF', ends
with the letters 'ANN', begins with the letters 'GING' and is exactly
with the letters 'ANN', begins with the letters 'GING' and is exactly

Revision as of 22:22, 4 March 2013

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).