Group Special Authority

Group Administration functions for checking a user’s Group Special Authority.

GroupAdmin.has_group_special_authority()

def has_group_special_authority(self, group: str, userid: str) -> Union[bool, bytes]:

📄 Description

 

Having RACF Special authority is analogous to having Root authority on Linux.

 

Check if a user has RACF Special authority within a group.

📥 Parameters

  • group
    The group where the user’s authority is being checked.

  • userid
    The z/OS userid of the user whose authority is being checked.

📤 Returns

  • Union[bool, bytes]
    Returns True when the user has RACF Special authority within the specified group and False otherwise. If the GroupAdmin.generate_requests_only class attribute is set to True, concatenated Security Request XML bytes will be returned.

❌ Raises

  • SecurityRequestError
    Raises SecurityRequestError when the SAF Return Code of a Security Result is equal to 4.
  • DownstreamFatalError
    Raises DownstreamFatalError when the SAF Return Code of a Security Result is greater than 4.

💻 Example

Python REPL
>>> from pyracf import GroupAdmin
>>> group_admin = GroupAdmin()
>>> group_admin.has_group_special_authority("testgrp0", "squidwrd")
False