Converting SMU Control Statements to CA Top Secret › Type 1 AOI Command Security Conversion › How TSSISMU1 Processing Works

How TSSISMU1 Processing Works

The TSSISMU1 conversion utility:

• Parses the department and facility values from the PARM= execution parameter in the TSSISMU1 job stream
• Processes the SMU information from the data set specified in the SMU DD statement in the execution JCL.
• Identifies the )( TCOMMAND control statements and extracts the command name from the control statement

  If the command name in the TCOMMAND statement is longer than three characters, the utility replaces it with the first three characters of the command verb.

  • Processes the CTRANS data statements that follow the )( TCOMMAND control statement.
  • (If this is the first time the transaction has been processed.) Generates a TSS CREATE command to create an ACID for the transaction for each transaction.

    The department for the ACID is the department specified in the PARM= parameter in the utility JCL, and the facility for the ACID is the facility in the PARM= parameter.

  • Generates a TSS PERMIT statement to permit access by the transaction ACID to the command.

    If the command specified in the TCOMMAND statement is * TSS PERMIT statements are generated for each IMS command eligible for AOI.

• Identifies the )(CTRANS control statements and extracts the transaction name from the control statement.
  • (If this is the first time the transaction is processed.) Generates a TSS CREATE command to create an ACID for the transaction.

    The department for the ACID is the department specified in the PARM= parameter in the utility JCL, and the facility for the ACID is the facility in the PARM= parameter.

  • Processes the TCOMMAND data statements that follow the )( CTRANS control statement. For each TCOMMAND data statement, the utility extracts the command name.

    If the command name in the TCOMMAND statement is longer than three characters, the utility replaces it with the first three characters of the command verb.

  • Generates the TSS PERMIT statement to permit access by the transaction ACID to the command.

    If the command specified in a TCOMMAND statement is * TSS PERMIT statements are generated for each IMS command eligible for AOI.

• (If the REPORT DD statement is specified in the utility JCL.) Generates a report listing all transactions identified in the SMU conversion process as issuing type 1 AOI commands.

  These transactions require the AOI=TRAN parameter in the TRANSACT macro transaction definitions in the IMS system definition (IMS stage 1) statements.

  Use this report to ensure that the appropriate transaction definitions are updated.

• (If the STG1IN and STG1OUT DD statements are specified in the utility JCL.)
  • Copies the IMS system definition statements from the STG1IN data set to the STG1OUT data set.
  • Identifies the TRANSACT macros for a transaction identified in the SMU conversion process as issuing AOI type 1 commands and adds an AOI=TRAN parameter to the end of the TRANSACT macro definition.

TSS Command Execution

Review the TSS commands generated by the TSSISMU1 utility for accuracy before you execute them.

This sample JCL executes the TSS statements in a batch TSO job:

//    JOB …
//IKJEFT01    EXEC  PGM=IKJEFT01,REGION=0M  
//SYSTSPRT    DD    SYSOUT=*   
//SYSPRINT    DD    SYSOUT=*   
//SYSTSIN     DD    DSN=tsscmds.input,DISP=SHR 
//

To execute the TSS statements the user must have an ACID with sufficient authority to create the transaction ACIDs and perform the command PERMITs.