CA Top Secret Supplied Transactions › The Environmental Utility (TSEU) › Executing TSEU

Executing TSEU

This section contains a detailed description of the information returned by each of the transactions.

TSEU=INSTALL

Details the following information about a region:

• Whether SEC=YES or SEC=NO is coded.
• Where the CA Top Secret modules are located.
• Whether the Application Interface is installed.
• Whether the TSS command is installed.
• The name of the region control userid.
• The name of the MASTFAC.
• The settings of the XPARMs, DSNCHECK, LTLOGOFF, PCTRESSEC, and PCTCMDSEC.

TSEU=WHOSON

Indicates who is signed on to a particular region.

TSEU=TRANS=(trans)

Describes the following information about a specific CICS transaction:

• Whether the transaction is local or remote.
• The priority at which it is defined.
• Whether the transaction was defined in the PCT or was loaded dynamically from the RDO file.
• Whether the transaction was generated with external security.
• Whether the PCTEXTSEC FACILITY suboption has been set to HONOR or OVERRIDE.
• Whether the transaction resides in the Bypass List.

TSEU=CESF=termid

Resets the ATS flag to allow the terminal to ATS again.

To reset the ATS flag, issue the following command (where L809 is the terminal id):

The terminal that issues the action will receive the following message: “CESF has been scheduled for terminal L809.”

Resetting the ATS flag also allows non‑ATS users to be signed off manually avoiding operator already signed on messages.

TSEU=TERM=(term | *)

Gives the following if a user is not signed on to a terminal:

• Whether there is a Security Record at the terminal.
• The three‑character operator ID.
• If the attend bit is on or off.

TSEU=TERM=(term)

Gives the following information if a user is signed on to a terminal:

• Gives the name of the ACID.
• Whether the user is defined or undefined, and the security MODE.
• The three‑character CICS operator ID.
• If the attend bit is on or off.

TSEU=MAXT=INQ

Has the ability to inquire about the maximum number and actions available for concurrent signon/signoff requests that are set.

A sample screen for TSEU=MAXT=INQ appears next:

Maximum users = 3000                           
Total number session-related tokens = 750      
Allocated session-related tokens = 4           
Max concurrent sign-on/off requests = 10       
Current no. of users signed on = 2             
Active user-related storage = 1248 bytes       
Total user-related storage = 83K  bytes        
Active user-related cache storage = 1024 bytes 
Total user-related cache storage = 375K bytes  

CICS Maximum task value = 60                   
Current no. of tasks = 8                       
Active task-related storage = 32K  bytes       
Total task-related storage = 240K bytes        
Total number task-related tokens = 60          

Times resource found in cache = 0              
Times resource not found in cache = 2          
Times cache overflowed = 0                     
Number entries added to cache = 2              
Number entries excluded from cache = 0         
Session cache box size = 512 bytes             
Command complete

TSEU=NEWC=(program)

Refreshes the running copy of a CA‑Top Secret CICS module, which is not callable from normal CICS application programming. This function allows emergency maintenance to be applied to a single CICS region without recycling that specific region.

The following CA Top Secret CICS modules are refreshed through the CICS command TSEU=NEWCOPY: CAKSLMT, CAKSMSGH, CAKSPCH1, CAKSSIGN, CAKSRINT, CAKSPVAL, CAKSRVAL, CAKSGLUE, CAKSPWH, CAKSCMIN, CAKSHASH, CAKSALOC, CAKSTRPX, CAKSXCMD, CAKSATS, CAKSEXIT, CAKSSHUT, CAKSPSPM, CAKSCBXM, CAKS#SEC, TSSCLMT, TSSCRVAL, TSCRTYxx, TSCCTYxx, TSCRACxx, TSSCXFM.

The following CA Top Secret CICS modules are refreshed through the CICS command CEMT SET PROGRAM(name) NEWCOPY: CAKSEXSN, CAKSCHEK, CAKSINST, CAKSMAXT, CAKSNEWC, CAKSTERM, CAKSTRAC, CAKSTRAN, CAKSWHOS, CAKSWRIT, CAKSSCAN, CAKSLOCK, TSSCAI, TSSCAIN, TSSCICS, TSSCICSN, TSSCPTSS. However, any TSS or CAKS program with a CSD definition can be refreshed using CEMT NEWCOPY.

TSEU=TRACE=(INQ|OFF|ON)

Inquires on or controls the status of the CA Top Secret CICS diagnostic tracing facility. The Trace Facility writes diagnostic trace records into the CICS main trace table.

INQ

Displays the current status (ON|OFF) of the CA Top Secret CICS diagnostic tracing facility.

OFF

Turns off the CA Top Secret CICS diagnostic trace.

ON

Turns on the CA Top Secret CICS diagnostic trace. Note that the CICS auxiliary trace must be controlled independently through CICS transactions CETR or CEMT.

Note: TRACE adds to the overhead experienced by CICS. Only run this option under the direction of CA Top Secret technical support.

You can control the amount of trace data created by specifying one or more of the following keywords when you activate the trace.

Level=1|2|3

Controls the amount of trace data created:

1

(Default) Each trace record contains the trace point ID, the name of the calling program, and the offset into the program. In addition, any specific trace data provided by the calling program appears in the trace record.

2

In addition to the data provided by Level 1, each trace record contains the contents of general registers R0 to R15 at the time the trace call was made.

3

In addition to the data provided by Level 2, each trace record contains a dump of two key control blocks. The control blocks from which you can select are: TRT, PGE, WSB, PGA, and SRT. The TRT and PGE control blocks are traced by default.

To identify which control blocks are to be traced, specify block=Y at the end of the command. Replace block with the name of the control block to be traced.

MODule=name

Specify a module name to trace only those calls made by the specified module.

EVent=xxyy

Specify an ENF event ID to trace only those calls made for the specified event.

TRAns=name

Specify a transaction ID to trace only those calls made by the specified transaction.

TERm=name

Specify a terminal ID to trace only those calls made by the transactions running on the specified terminal.

ENtry=name

Specify an entry ID so that only the specified trace point creates trace records.

DUMP=traceid

This function is to be used at the request of support and produces an XPI dump on the first entry to that traceid.

The following example shows how to trace only a program named CAKSROUT with detail at level 2.

TSEU=TRACE=ON,LE=2,MOD=CAKSROUT

The next example shows how to trace only CEMT transactions with detail at level 3, which will include a dump of WSB and SRT on each trace record. Control block tracing is only available with LE=3 tracing.

TSEU=TRACE=ON,LE=3,TRANS=CEMT,WSB=Y,SRT=Y