You start the command-level interpreter by entering either of two transaction identifiers, CECS or CECI, followed by the name of the command you want to test. You can list command options too, although you can also do this later. For example:
CECS READ FILE('FILEA')
or
CECI READ FILE('FILEA')
CICS® responds with a display of the command and its associated functions, options, and arguments, as shown in Figure 153. If you leave out the command, CECI provides a list of possible commands to get you started. You can use any of the commands described for programming purposes in the CICS Application Programming Reference and the CICS System Programming Reference manuals. CECI also supports the FEPI commands provided for the CICS Front End Programming Interface.
READ FILE('FILEA') 1 STATUS: COMMAND SYNTAX CHECK NAME= 2 EXEC CICS READ File( 'FILEA ' ) < SYsid() > 3 SEt() | Into() < Length() > RIdfld() < Keylength() < GEneric > > < RBa | RRn | DEBRec | DEBKey > < GTeq | Equal > < Update < Token() > > S Option RIDFLD has been omitted or specified with an invalid value, the command cannot be executed. 4 PF 1 HELP 2 HEX 3 END 4 EIB 5 VAR 6 USER 7 SBH 8 SFH 9 MSG 10 SB 11 SF 5
If you use the transaction code CECS, the interpreter simply checks your command for correct syntax. If you use CECI, you have the option of executing your command once the syntax is correct. (CICS uses two transaction identifiers to allow different security to be assigned to syntax checking and execution.)
Until CICS executes a command, you can change it by changing the contents of the command line, by changing the option values shown in the syntax display in the body, or by changing the values of variables on the variables screen. (You can still make changes after a command is executed, but, unless they are in preparation for another command, they have no effect.)
When you make your changes in the command line or on the variables screen, they last for the duration of the CECI transaction. If you make them in the body of the syntax screen, however, they are temporary. They last only until the command is executed and are not reflected in the command line.
As noted earlier, not all characters are displayable on all terminals. When the display is in character rather than hexadecimal format, CECI shows these characters as periods (X'4B'). When you overtype a period, you should be aware that the current value may not be a period but an undisplayable character.
Furthermore, you cannot change a character to a period when the display is in character mode. If you attempt this, CECI ignores your change, and does not issue a diagnostic message. To make such a change, you have to switch the display to hexadecimal and enter the value (X'4B') that represents a period.
There is a restriction on changes in hexadecimal format as well. If you need to change a character to a blank, you cannot enter the code (X'40') from a hexadecimal display. Again, your change is ignored and CECI does not issue a message. Instead, you must switch to character mode and blank out the character.
After every modification, CECI rechecks your syntax to ensure that no errors have appeared. It restarts processing at the command syntax check if there are any execution-stoppers, and at about to execute command if not. Only after you press ENTER on an unmodified about to execute command screen does CECI execute your command.
[[ Contents Previous Page | Next Page Index ]]