Package dev.galasa.zossecurity

Interface IZosCicsClassSet

public interface IZosCicsClassSet

Represents a set of RACF Classes that is used to CICS security. A time of writing this is 10 classes TxxxxTRN and GxxxxTRN etc.

Method Summary

Modifier and Type	Method	Description
List<IZosProfile>	allowAllAccess()	Creates a generic '*' profile with a UACC of ALTER on all CICS security classes so that security can be switched on and everyone will have access.
List<IZosProfile>	allowAllAccess(boolean refresh)	Creates a generic '*' profile with a UACC of ALTER on all CICS security classes so that security can be switched on and everyone will have access.
IZosProfile	defineGroupProfile(ZosCicsClassResource classType, String profileName, RACFAccessType uacc, List<String> members)	Create a new Grouping profile within this set
IZosProfile	defineGroupProfile(ZosCicsClassResource classType, String profileName, RACFAccessType uacc, List<String> members, boolean refresh)	Create a new Grouping profile within this set
IZosCicsProfile	defineMemberProfile(ZosCicsClassResource classType, String profileName, RACFAccessType uacc)	Create a new Member profile within this set
IZosCicsProfile	defineMemberProfile(ZosCicsClassResource classType, String profileName, RACFAccessType uacc, boolean refresh)	Create a new Member profile within this set
void	deleteProfile(IZosCicsProfile profile)	Delete a profile.
void	deleteProfile(IZosCicsProfile profile, boolean refresh)	Delete a profile.
void	free()	Free the CICS class set.
String	getName()	Retrieves the name of the set.
String	getSecprfx()	For Shared CICS Classsets this will return the setting for SECPRFX= SIT parameter
HashMap<String,String>	getSIT()	Return all SIT parameters for the security class setup.
HashMap<String,String>	getSIT(int cicsRelease)	Return all SIT parameters for the security class setup appropriate for the provided CICS release.
String	getSIT(ZosCicsClassResource classType)	Retrieve the SIT parameter value for the CICS Security class requested.
IZosImage	getZosImage()	Retrieves this zOS image this set belongs to

Method Details

getName

String getName()

Retrieves the name of the set.

Returns:

Set name

getZosImage

IZosImage getZosImage()

Retrieves this zOS image this set belongs to

Returns:

zOS Image

getSIT

String getSIT(ZosCicsClassResource classType)

Retrieve the SIT parameter value for the CICS Security class requested.

If the setname is JA01, this method will return JA01TRN for CICSClassResource.Transaction so you can set the SIT to be XTRAN=JA01TRN

Parameters:

classType -

Returns:

The class name for the security SIT parameter

getSIT

HashMap<String,String> getSIT()

Return all SIT parameters for the security class setup.

Returns:

A hashmap of all the class sit parameters

getSIT

HashMap<String,String> getSIT(int cicsRelease)

Return all SIT parameters for the security class setup appropriate for the provided CICS release.

Parameters:

cicsRelease - - The CICS Release this SITs are for, internal CICS release number eg 660.

Returns:

A hashmap of all the class SIT Override parameters

allowAllAccess

List<IZosProfile> allowAllAccess()
                          throws ZosSecurityManagerException

Creates a generic '*' profile with a UACC of ALTER on all CICS security classes so that security can be switched on and everyone will have access. It is intended that the tester create additional profiles to test the security in the area of concern.

Returns:

A list of profiles created

Throws:

ZosSecurityManagerException

allowAllAccess

List<IZosProfile> allowAllAccess(boolean refresh)
                          throws ZosSecurityManagerException

Creates a generic '*' profile with a UACC of ALTER on all CICS security classes so that security can be switched on and everyone will have access. It is intended that the tester create additional profiles to test the security in the area of concern.

Parameters:

refresh - - issue SETROPTS REFRESH

Returns:

A list of profiles created

Throws:

ZosSecurityManagerException

defineMemberProfile

IZosCicsProfile defineMemberProfile(ZosCicsClassResource classType,
 String profileName,
 RACFAccessType uacc)
                             throws ZosSecurityManagerException

Create a new Member profile within this set

Parameters:

classType - - Type of security class

profileName - - The name of the profile

uacc - - The uacc to set or null

Returns:

The created profile

Throws:

ZosSecurityManagerException

defineMemberProfile

IZosCicsProfile defineMemberProfile(ZosCicsClassResource classType,
 String profileName,
 RACFAccessType uacc,
 boolean refresh)
                             throws ZosSecurityManagerException

Create a new Member profile within this set

Parameters:

classType - - Type of security class

profileName - - The name of the profile

uacc - - The uacc to set or null

refresh - - Issue SETROPTS Refresh

Returns:

The created profile

Throws:

ZosSecurityManagerException

defineGroupProfile

IZosProfile defineGroupProfile(ZosCicsClassResource classType,
 String profileName,
 RACFAccessType uacc,
 List<String> members)
                        throws ZosSecurityManagerException

Create a new Grouping profile within this set

Parameters:

classType - - Type of security class

profileName - - The name of the profile

uacc - - The uacc to set or null

members - - A list of members to add or null

Returns:

The created profile

Throws:

ZosSecurityManagerException

defineGroupProfile

IZosProfile defineGroupProfile(ZosCicsClassResource classType,
 String profileName,
 RACFAccessType uacc,
 List<String> members,
 boolean refresh)
                        throws ZosSecurityManagerException

Create a new Grouping profile within this set

Parameters:

classType - - Type of security class

profileName - - The name of the profile

uacc - - The uacc to set or null

members - - A list of members to add or null

refresh - - Issue SETROPTS Refresh

Returns:

The created profile

Throws:

ZosSecurityManagerException

deleteProfile

void deleteProfile(IZosCicsProfile profile)
            throws ZosSecurityManagerException

Delete a profile.

Parameters:

profile - -The profile to be deleted

Throws:

ZosSecurityManagerException

deleteProfile

void deleteProfile(IZosCicsProfile profile,
 boolean refresh)
            throws ZosSecurityManagerException

Delete a profile.

Parameters:

profile - -The profile to be deleted

refresh - - Issue SETROPTS Refresh

Throws:

ZosSecurityManagerException

getSecprfx

String getSecprfx()
           throws ZosSecurityManagerException

For Shared CICS Classsets this will return the setting for SECPRFX= SIT parameter

Returns:

Throws:

ZosSecurityManagerException

free

void free()
   throws ZosSecurityManagerException

Free the CICS class set. This will be performed automatically at the end of the run

Throws:

ZosSecurityManagerException