Starting the CEMT transaction

You can construct a CEMT request in stages, or you can enter a complete request in one go. The CEMT transaction checks the syntax of requests and diagnoses errors. If your request is syntactically correct, it is processed immediately. If your request cannot be processed because of severe syntax errors, the full syntax of your request is displayed.

If you put a question mark (?) in front of your request, the syntax of your request is displayed but it is not processed.

If you put a minus sign (-) immediately following CEMT, and are using the master terminal transaction from the system console, CEMT always displays its results in abbreviated format. This is independent of the number of objects returned on the inquiry. Without the use of a minus sign, CEMT commands issued from the system console display the results in expanded format only if a single object is returned.

After you have initiated the CEMT transaction, you need not reenter CEMT on subsequent requests, because the identifier is implied at the beginning of any further request. However, if you are using the system console, you must always start each master terminal request with CEMT.

Enter CEMT on the command line of the screen, as follows:

CEMT

Press the ENTER key. You get the following response:

Figure 53. CEMT transaction: initial screen
  STATUS:  ENTER ONE OF THE FOLLOWING

 Discard
 Inquire
 Perform
 Set




 

This display prompts you to enter one of the keywords shown.

If you then type:

D

and press ENTER, you get the following screen:

Figure 54. CEMT transaction: DISCARD screen
  D
  STATUS:  ENTER ONE OF THE FOLLOWING


 Autinstmodel PROCesstype
 CONnection   PROFile
 CORbaserver  PROGram
 DB2Conn      Requestmodel
 DB2Entry     TCLass
 DB2Tran      TCPipservice
 DJar         TDqueue
 DOctemplate  TErminal
 Enqmodel     TRansaction
 FENode       TSmodel
 FEPOol       Start of changeUrimapEnd of change
 FEPRopset
 FETarget
 FIle
 JModel
 JOurnalname
 PArtner
   S At least 4 characters of DISCARD must be specified.
                                                      SYSID=JOHN APPLID=I

 PF 1 HELP       3 END       5 VAR                    9 MSG

 

If you type:

I

and press ENTER, you get the following screen:

Figure 55. CEMT transaction: INQUIRE screen
  I
  STATUS:  ENTER ONE OF THE FOLLOWING OR HIT ENTER FOR DEFAULT

 AUTInstmodel DSName       JVM          TAsk          WEBService                
 AUTOinstall  DUmpds       JVMPool      TCLass       WOrkrequest                
 AUXtrace     ENQ          Line         TCPIP                                   
 BEan         ENQModel     MODename     TCPIPService                            
 BRfacility   EXci         MONitor      TDqueue                                 
 CFdtpool     FEConnection Netname      TErminal                                
 CLasscache   FENode       PArtner      TRAnsaction                             
 CONnection   FEPOol       PIpeline     TRDumpcode                              
 CORbaserver  FEPRopset    PROCesstype  TSModel                                 
 DB2Conn      FETarget     PROFile      TSPool                                  
 DB2Entry     FIle         PROGram      TSQueue                                 
 DB2Tran      Gtftrace     REquestmodel UOW                                     
 DEletshipped Start of changeHostEnd of change         RRms         UOWDsnfail                              
 DIspatcher   INttrace     STAtistics   UOWLink                                 
 DJar         IRc          STReamname   Start of changeURimapEnd of change                                  
 DOctemplate  JModel       SYDumpcode   Vtam                                    
 DSAs         JOurnalname  SYStem       WEb         


                       

If you type:

P

and press ENTER, you get the following screen:

Figure 56. CEMT transaction: PERFORM screen
  P
  STATUS:  ENTER ONE OF THE FOLLOWING

 CLasscache
 DEletshipped
 DJar
 DUmp
 Endaffinity
 Reset
 SEcurity
 SHUTdown
 SNap
 STatistics




 

If you type:

S

and press ENTER, you get the following screen:

Figure 57. CEMT transaction: SET screen
  S
  STATUS:  ENTER ONE OF THE FOLLOWING OR HIT ENTER FOR DEFAULT

AUToinstall  FEPool       STatistics   WEBService                              
AUXtrace     FETarget     SYDumpcode   WOrkrequest                             
Brfacility   FIle         SYStem                                               
CLasscache   Gtftrace     TAsk                                                 
CONnection   Host         TCLass                                               
CORbaserver  INttrace     TCPIP                                                
DB2Conn      IRc          TCPIPService                                         
DB2Entry     JOurnalname  TDqueue                                              
DB2Tran      JVM          TErminal                                             
DEletshipped JVMPool      TRAnsaction                                          
DIspatcher   Line         TRDumpcode                                           
DSAs         MODename     TSqueue                                              
DSName       MONitor      UOW                                                  
DUmpds       Netname      UOWLink                                              
Enqmodel     PIpeline     Start of changeURimapEnd of change                                               
FEConnection PROCesstype  Vtam                                                 
FENode       PROGram      WEb    



 PF 1 HELP       3 END       5 VAR                    9 MSG
 

System parameters

If you press ENTER without selecting one of the CEMT keywords, INQUIRE SYSTEM is assumed and you get a display of the system parameters. Full details are given in CEMT INQUIRE SYSTEM.

Program function (PF) keys

When you start CEMT, the lower part of your display contains a list of PF keys. If your terminal does not have such keys, you can get the same effect by placing the cursor under a name in the list, and pressing ENTER.

Here is what the PF keys do:

PF1
is a general HELP key. It also gives you a list of all the PF keys and what they do.
PF2
switches the display of character values to hexadecimal format on an expanded panel (see Expanded panels).
PF3
ends this master terminal session by terminating the CEMT transaction. If, however, you use this key when you are modifying your display, say by keying in a new command, or by overtyping an old command, this key does not end your session; it is ignored.
PF5
gives a variables display. You can use this to create values for use in a command.
PF7
scrolls backward half a screen.
PF8
scrolls forward half a screen.
PF9
expands messages. If more than one message has been generated in response to your request, a message telling you how many messages have been generated appears near the bottom of the screen. PF9 lets you display all the messages on a separate display. Press ENTER to go back to your original display.
PF10
scrolls backward a full screen.
PF11
scrolls forward a full screen.

Minimum abbreviation of keywords

CEMT accepts as few characters of a keyword as needed to uniquely identify it within the request. This means that you can enter the keyword TASK as TA or TAS, but you cannot use T, because it can be confused with TCLASS, TDQUEUE, TERMINAL, TRANSACTION, or TRDUMPCODE. You are prompted if the abbreviation you use is not unique. An exception to this rule is SHUTDOWN, for which you must specify at least SHUT.

In the syntax displays on your screen and in the railroad diagrams and syntax descriptions in this book, the minimum permitted abbreviation is given in uppercase characters, with the remainder in lowercase characters.

ALL option

Many of the request formats contain the ALL option. For INQUIRE, this is the default. For example, if you inquire about terminals, you receive information about all terminals unless you specify a terminal identifier, a terminal class identifier, or a system identifier.

ALL is not the default on a SET command, however. If you specify the ALL option on a SET command, any changes you request are made to all resources of the specified type that you are authorized to access.

If there are no resources of the type specified on the SET command, a response of NOT FOUND is given.

CLASS option

When operating on terminals, transactions, and programs, the CLASS option can be used to identify the suffix of a TLT, XLT, or PLT. This limits the scope of the INQUIRE or SET commands to those resources defined in the specified table. Any resources whose definitions have not been installed are displayed as NOT FOUND. For information about TLT, XLT, and PLT, see the CICS Resource Definition Guide.

Family of resources (using * and + symbols)

You can use the symbols * and + as part of an identifier to specify a family of resources. * represents any number of characters (including none), and + represents a single character, for example:

A* all identifiers beginning with A
*DATA* all identifiers containing the characters DATA
TERM00+ all 7-character identifiers starting with TERM00.

Use of * and + is restricted to selecting existing resources and cannot be used either to create a new set of resources or to discard resources.

Note:
The INQUIRE command and the SET command may use the generic name in a different way. The following two examples illustrate the difference:
CEMT INQUIRE FI(*) DSN(ABCD*)
lists all the files with data sets with a name beginning with ABCD.
CEMT SET FI(*) DSN(ABCD*) CLO
associates all your files with data set ABCD* and closes them all.

Thus the generic name has the expected effect only for the resource itself.

List of resource identifiers

You can specify a list of resource identifiers, rather than a single one, separating the items in the list by commas or blanks. Any errors of syntax are reported.

CEMT SET TERMINAL(TO1,TO2,TO3,TO4) INSERVICE

You cannot use * or + when the identifier is in a list of identifiers.

Note:
If you use the comma (,) in the name of a resource identifier, you will not be able to use any commands that permit the use of lists of resources, because the comma will be treated as a list separator, and not as a part of a name.

Subdefining resource groups

When you make an inquiry, you can subdefine a resource group by specifying one or more attributes of the group. For example:

CEMT INQUIRE TERMINAL ALL INSERVICE

displays the status of all terminals that are in service.

If the subdefined resource group has no members, CEMT returns a NOT FOUND response. For example, if all the files in the system are closed, the command:

CEMT INQUIRE FILE ALL OPEN

gives the NOT FOUND response.

You cannot subdefine a resource group on the SET command in the same way. For example:

CEMT SET TERMINAL ALL INSERVICE PAGE

puts all terminals both in service and into page status.

However, you can manage such groups of resources by issuing an INQUIRE request, and overtyping the display produced.

Overtyping a display

When you issue an INQUIRE request, you usually get a display that consists of status information for each resource in the specified group. The status information is displayed as a list of abbreviated keywords. You can move the cursor to some fields and change their contents by overtyping. When you press the ENTER key again, CICS reads the contents of all fields that have been changed, and processes any valid operations implied by the changes. If you make an invalid change, you get an error message, and the field is not changed.

When a field is overtyped, CEMT will accept and identify only as few characters as are necessary to uniquely identify the keyword within the valid options for that position. This is usually only one character.

On many of the status displays, the current status is displayed in certain positional fields at the right-hand side of the display. For some fields, the positional display appears only when the status of a particular resource is ‘on’. You can overtype the current status (when it is either displayed or blank) to change it.

So, for example, if you type ‘CEMT INQUIRE SYD’, you get a display of the current settings of the entries in the system dump table. The various attributes of those entries are displayed in fields across the screen. If CICS is to be shut down after the occurrence of an error for this dump code, ‘Shu’ appears in the third field of attributes for that dump code. If CICS is not to be shut down, however, the ‘Shu’ space is left blank. If you want CICS to be shut down for this dump code, you can tab to that field and type ‘shu’ in that blank space in that field only.

The sequence of the positional fields is given in the descriptions of the various CEMT INQUIRE commands.

Whenever you overtype a display, not only is that particular action taken but all the status information is refreshed. You can avoid the overhead of a large number of table searches either by using the SET command, or by limiting your inquiry to a specific number of resources (either by using a ‘wild card’ in the search argument or by naming a range of resource identifiers).

Tab key

The fields you can change are different in each display. You can detect them, however, by pressing the tab key repeatedly. This causes the cursor to jump from one field to the next.

Scrolling symbol (+ sign)

A plus (+) sign on the first or last line of a display tells you that there is more data above or below your current display. Scrolling backward reveals data above, and scrolling forward reveals data below.

Blank fields in a display

Some displays contain blank fields that allow you to specify options, such as NEWCOPY, on the CEMT SET PROGRAM command, which are not part of the status of a resource. A status, such as NOREAD, which begins NO, is also represented by a blank field. You can detect these fields by using the tab key.

Using the ? key

If you precede the command with ?, the syntax for that command appears on the screen. For example ?INQUIRE TERMINAL gives the list of options that you can specify with the inquiry command with the default highlighted. See Figure 58.

Figure 58. Sample of screen showing the syntax of a INQUIRE command
 ?INQ TERM
  STATUS:  COMMAND SYNTAX CHECK
   CEMT  Inquire TErminal()
    < CLass() | ALl >
    < TRansaction() >
    < PRiority() >
    < PAgeable | AUtopageable >
    < Inservice | Outservice >
    < ATi | NOAti >
    < TTi | NOTti >
    < NEtname() >
    < ACquired | RELeased >
    < CReate | NOCreate >
    < REMotesystem() >




 

Expanded panels

You can select one resource item from a list, then check and change its options if required. Type the required CEMT INQUIRE or SET command name, then move the cursor to the relevant line on the display panel and press ENTER. This will result in an expanded display showing the attributes of the selected resource item. In the process, an INQUIRE command is executed for the associated resource.

For example, if you enter CEMT INQUIRE TERM, this gives the screen in Figure 59.

Figure 59. Sample of screen showing a list of terminals
 in task
 STATUS:  RESULTS - OVERTYPE TO MODIFY

           *** Sample screen required ***

Move the cursor to the left of the first entry and press ENTER. This selects the first terminal, and displays the relevant information for that terminal (see Figure 60).

Figure 60. Terminal settings for a selected terminal
 in term
 RESULT - OVERTYPE TO MODIFY
   Terminal(bell)
   Transaction()
   Priority( 000 )
   Pagestatus( Pageable )
   Servstatus( Inservice )
   Atistatus( Noati )
   Ttistatus( Tti )
   Nature(Local)
   Purgetype(              )
   Netname()
   Termstatus(              )
   Createsess(              )
   Task(00000)
   Remotesystem()
   Rname()
   Rnetname()
   Cid()
 

Overtype the displayed settings if you want to make changes. Press ENTER to restore the original panel.

You can view a number of expanded panels in succession by entering ‘?’ or ‘s’ in the space at the beginning of the line for each resource you wish to query. After the first expanded panel, pressing ENTER takes you to the next panel.

Hexadecimal values

Some values such as TSQUEUE and NETUOWID may contain nondisplayable characters, which are shown as periods. You can use PF2 on the expanded panel to see the hexadecimal values of these characters. To switch back to character format, press PF2 again.

Variables

PF5 gives a display of variables, similar to that for the CECI command. Here are some examples of its use.

From a FILE display, you may wish to inquire of a particular DSNAME, which is typically 26 characters and can be up to 44 characters in length. Go to the expanded panel, position the cursor on the DSNAME line, and press PF5. You now have a variable &DSN with the required value. Type I DSN(&DSN) on the command line, and press ENTER.

You may wish to find all the TSQUEUE names beginning with a nondisplayable character--for example, X'FF'. Press PF5 for the variables display. Enter X and 2 to make a variable &X of length 2. Press PF2 to switch to hexadecimal, and overtype ‘4040’ with ‘FF5C’ (‘%c’ is hexadecimal for the asterisk (*) symbol). Type I TS(&X) on the command line and press ENTER.

For more information on the variables display, see the CICS® Application Programming Guide.

Invoking CEMT from an application program

Many of the CEMT INQUIRE and SET operations are available through the EXEC CICS INQUIRE and EXEC CICS SET commands; for programming information, see the CICS System Programming Reference.1

Security checking

The scope of a particular DISCARD, INQUIRE, SET, or PERFORM command can be limited by a combination of several levels of security checking. The normal transaction-attach security is described in the CICS RACF® Security Guide. CEMT calls the exec interface programs to process the user’s commands, in much the same way as CECI or a user’s command-level program would. The resource security and the command security used by the command-level programming interface are thus applicable to the master terminal user.

For programming information about command security checking, see the CICS System Programming Reference.


1.
Users of earlier releases of CICS may be familiar with the old programmable interface to the master terminal program (DFHEMTA). Its use is still supported, though the documentation is available only in the CICS libraries for releases prior to CICS Transaction Server for z/OS®, Version 3 Release 1.

[[ Contents Previous Page | Next Page Index ]]