RESTAUTH command

From m204wiki
Revision as of 22:22, 4 March 2013 by JAL (talk | contribs)
Jump to navigation Jump to search

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