SECURITY RESET (Clearing Security Validation Buffer)

The SECURITY RESET function is used to clear the security validation buffer. The SECURITY function requires that the MUF be active. For information about security for ddb, see the topics under .
datacom
The SECURITY RESET function is used to clear the security validation buffer. The SECURITY function requires that the MUF be active. For information about security for 
Datacom/DB
, see the topics under Security Overview.
When to Use SECURITY RESET
Use the SECURITY RESET function to clear the security validation buffer. Security maintains a working set of validated profiles. This set is dynamically changed and is periodically cleared. If an access is changed, this reset must be done to ensure instant revalidation. This reset should be done only when changes have been made in your external security specifications that might be in the working set and, therefore, it is critical for the set to be refreshed.
This function communicates with one MUF. Be aware of the following:
  • Ensure that DBUTLTY is communicating with the desired MUF by executing DBUTLTY with the same System Identifier module (DBSIDPR) that is being used by the MUF.
  • Ensure proper load library concatenation by keeping the System Identifier modules (DBSIDPR) in separate load libraries.
If the z/OS Cross-System Coupling Facility (XCF) is being used, ensure that the TOGROUP DBSIDPR parameter is correctly defined.
When using a console command, these steps are unnecessary.
How to Use the Console Command (SECURITY RESET)
The MUF must be active when you execute this command.
Use the following in your command to initiate this function from the system console. Consult your site operating system documentation for additional syntax information.
►►─ SECURITY RESET ─┬────────┬────────────────────────────────────────────────►◄ └─
user
─┘
 
Command
 
  •  
    SECURITY
    Invokes the function.
 
Required Keyword
 
  •  
    RESET
    Signs off all users and clears the security validation buffer.
 
Optional Keyword
 
  •  
     
    user
     
    If the 
    user
     parameter is not coded, SECURITY RESET signs off all users and the security validation buffer is cleared.
    If the 
    user
     parameter is coded, the individual user specified with the parameter is signed off and that individual's CICS, and Server cached security validations are cleared. For active batch jobs, the individual user's batch cached security validations remain in effect for the life of the open URT for that batch job.
How to Use the DBUTLTY Command (SECURITY RESET)
The MUF must be active when you execute this command. Execute the SECURITY RESET function with the following command format:
►►─ SECURITY ─ OPTION=RESET ─┬──────────────┬────────────────────────────────►◄ └─ ,USER=
name
─┘
 
Command
 
  •  
    SECURITY
    Invokes the function.
 
Required Keywords
 
  •  
    OPTION=RESET
    Signs off all users and clears the security validation buffer.
    •  
      Default Value:
      (No default)
 
Optional Keyword
 
  •  
    ,USER=
    name
     
    If the USER= parameter is not coded, SECURITY RESET signs off all users and the security validation buffer is cleared.
    If the USER= parameter is coded, the individual user specified is signed off and that individual's CICS, and Server cached security validations are cleared. For active batch jobs, the individual user's batch cached security validations remain in effect for the life of the open URT for that batch job.
    •  
      Default Value:
      (No default)
Example JCL (SECURITY RESET)
The following shows the command to execute the RESET option.
 Use the following as a guide to prepare your JCL. The JCL statements are for example only. Lowercase letters in a statement indicate a value you must supply. Code all statements to your site and installation standards.
//jobname See the previous note and
JCL Requirements
.
// EXEC PGM=DBUTLTY,REGION=2M //STEPLIB
See the previous note and
JCL Requirements
.
//SYSIN DD * Command input SECURITY OPTION=RESET /*
Sample Report
Following is a sample report page. For an example report header, see Sample Report Headers.
CONTROL CARD(S) .........1.........2.........3.........4.........5.........6.........7.........8 SECURITY OPTION=RESET FUNCTION=SECURITY OPTION=RESET
This page of the report shows the following:
  • The command exactly as entered.
  • An analysis of keywords encountered and expected. Any errors found are flagged with a note in the left margin.
  • Any messages related to syntax processing.
DB13105I - SECURITY RESET REQUEST ACCEPTED
This page of the report displays a message indicating the success of the function execution.