Entering a CEMT command - IBM - AS/400

There are a number of conventions for entering CEMT commands that reduce the amount of information you have to type and also allow you to select the resources you wish to work with.

Minimum abbreviation of keywords
The CEMT transaction accepts as few characters of a keyword as are needed to identify it uniquely within the request. This means that the keyword TASK can be entered as TA or TAS, but T cannot be used, because it can be confused with TDQUEUE, TERMINAL, or TRANSACTION. The first keyword containing the abbreviation is used if it is not unique. An exception to this rule is SHUTDOWN, for which at least SHUT must be specified.

In the syntax displays on the screen, and in some examples in this chapter, the minimum permitted abbreviation is given in uppercase characters, and the remainder in lowercase characters.

Selecting resources
You can affect either a single resource or a group of resources. For example,
CEMT INQUIRE JOURNALNUM(14) CLOSED
Inquires about a single resource, journal 14. If CICS journal 14 is open for output, the command results in the NOTFND response, because the CEMT transaction looks for a CICS journal numbered 14 that is closed.

Many of the request formats contain the ALL option. For CEMT INQUIRE, this is a default that is assumed if an alternative is not specified. For example, if inquiring about CICS terminals, information about all CICS terminals is displayed, unless aCICS terminal identifier is specified.

The ALL option is not the default for CEMT SET commands. If the ALL option on a CEMT SET option is specified, any changes requested are made to all CICS resources of the specified type. If there are no CICS resources of the type specified on the CEMT SET command, a response of NOTFND is given.

For example:
INQUIRE TERMINAL ALL INSERVICE

Displays the status of all CICS terminals that are in service.If the subdefined CICS resource group has no members, the CEMT transaction returns a NOTFND response. For example, if all the CICS files in the CICS control region are closed, the command:
INQUIRE FILE ALL OPEN

Gives the NOTFND response.A CICS resource group cannot be subdefined on the CEMT SET command in the same way. For example:
SET TERMINAL ALL INSERVICE ACQUIRED

puts all CICS terminals both in service and into an acquired status. However, such groups of CICS resources can be managed by issuing a CEMT INQUIRE request, and overtyping the display produced.

Family of resources
The symbols * and + can be used as part of an identifier to specify a family of CICS resources. The symbol * 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 CICS resources and cannot be used to discard CICS resources.
SET TERMINAL(TRM*) INSERVICE

sets all CICS terminals, whose identifiers start with TRM, in service.

List of resource identifiers
You can specify a list of CICS resource identifiers, rather than a single one, separating the items in the list by commas or blanks. Any errors of syntax are reported.
SET TERMINAL(TO1,TO2,TO3,TO4) INSERVICE

The symbols * or + cannot be used when the identifier is in a list of identifiers.Most of the requests either inquire about (INQUIRE) or change (SET) the status of one or more CICS resources (such as a terminal), a particular subgroup of CICS resources (such as terminals whose ids all start with the same characters), or all CICS resources of a particular type (such as all terminals).On every CEMT SET command, an argument, a generic argument, or ALL must be specified, for example:
SET TERMINAL(TRM1) INSERVICE

sets CICS terminal TRM1 in service. The command:
SET TERMINAL ALL INSERVICE

sets all CICS terminals in service. Note that the command:
SET TERMINAL INSERVICE

produces an error.

Displaying options and syntax (the ? key)
If you type the ? key in the space on the extreme left of the command line, the syntax for that command appears on the screen. For example, ?INQUIRE TERMINAL gives the list of options that you can use the inquiry command on,
with the default highlighted.

Following the inquiry command, you can see a list of the resources installed in your control region. For example, when you place the cursor at the beginning of one of the lines of status information, and type a question mark (?), you see a display consisting of that line of data and the syntax of the appropriate CEMT SET command.

Figure . Sample of screen showing the syntax of a CEMT SET command

Sample of screen showing the syntax of a CEMT SET command

Scrolling data (+ 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 PURGE on the CEMT SET TERMINAL command. This is not part of the status of a CICS resource.

A status beginning with “NO”, for example NOREAD, is not displayed and appears as a blank field. To alter the status, for example from NOREAD to READ, simply type in the change in the blank field. To position the cursor at one of these fields, use either the tab key or the cursor control keys.


All rights reserved © 2018 Wisdom IT Services India Pvt. Ltd DMCA.com Protection Status

IBM - AS/400 Topics