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:
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:
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
Urimap
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:
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 DEletshippedHost
RRms UOWDsnfail DIspatcher INttrace STAtistics UOWLink DJar IRc STReamname
URimap
DOctemplate JModel SYDumpcode Vtam DSAs JOurnalname SYStem WEb
If you type:
P
and press ENTER, you get the following 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:
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 PIpelineURimap
FEConnection PROCesstype Vtam FENode PROGram WEb PF 1 HELP 3 END 5 VAR 9 MSG
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.
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:
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.
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.
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.
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.
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.
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.
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.
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).
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.
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.
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.
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.
?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() >
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.
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).
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.
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.
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.
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
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.