As you are testing your application program, you may need to issue IMS operator commands that provide services to you, as well as provide important information. A certain subset of IMS operator commands are useful in the test environment, and are described below.
You can always use the long form of the command. (The slash, followed by the first three characters of the command, is a valid short form.) Examples would be/TES (short for/TEST) and /FOR (short for /FORMAT). Figure 3-4 shows a table of common IMS Test System commands.
| Command | Example |
|---|---|
| /TEST | /TEST MFS or /TEST MFS NODE LTERM /TES MFS or /TES MFS NODE LTERM |
| /FORMAT | /FORMAT modname or /FOR modname |
| /DISPLAY | /DISPLAY TRANSACTION trancode…. or /DIS PROGRAM progname,….. or /DIS DATABASE ddname,…… or /DIS NOTE LTERM,…… |
| /START | /START TRAN trancode,…. or /STA PROG progname,…. or /STA DB ddname,…… |
| /STOP | /STOP TRAN trancode,…… or /STO PROG progname,…… or /STO DB ddname,…. |
| DBRECOVERY | /DBRECOVERY ddname,….. NOFEOV or /DBR ddname,….. NOFEOV |
| /RSTART | /RSTART NODE LTERM1 LTERM2 …… or /RST NODE LTERM1 LTERM2…… or |
| /END | /END or /END NODE LTERM |
| /RCLSDST | /RCLSDST or /RCL |
Common IMS Test System Commands
The first two commands,/TEST and /FORMAT, should always be available for your use. Others may not be. The following list explains the common commands in detail.
/TEST |
This command is used to put IMS in the MFS test mode. In the test IMS system, you are allowed to regenerate MFS formats and test them right away, a facility not available in the production IMS system. To take advantage of this test facility, you must issue the following test command the first time you enter the IMS test system:
/TEST MFS or /TES MFS |
This will put IMS into the MFS test mode. You will now be able to retrieve MFS formats from the test format library.
If you wish to test alternate devices, like 3270 printers, you must issue a variation of /TEST in addition to the /TEST MFS command. The command looks like the following:
/TEST MFS NODE LTERM or /TES MFS NODE LTERM |
The NODE keyword is where you specify the device ID that is known to IMS. For example, if you wanted to test an application that writes MFS messages to a 3287 printer, and the printer ID is HAH23V, the command is
/TEST MFS NODE HAH23V |
/FORMAT |
This command is used to retrieve MFS MODs from the test MFS library. The command used to retrieve MOD CT7001M1 would be
/FORMAT CT7001M1 or /FOR CT7001M1 |
/DISPLAY |
This command displays the information requested in the command. There are several pieces of information that can be displayed. Below are examples of the display command.
/DISPLAY TRANSACTION CT7P01S1.... display transaction info
/DIS PROGRAM CT7P01S1.... display program info
/DIS DATABASE CT7DPDA1..... display data base info
/DIS NODE WRDT0333..... display node info
The above examples give only a small sample of the type of information that can be displayed.
/START |
This command starts the various IMS resources that have been stopped either by the operator or by program abend. Examples are the following:
/START TRANSACTION CT7P01S1 (start the stopped transactions)
/STA PROGRAM CT7P01S1 (start the stopped programs)
/STA DATABASE CT7DPDA1 (start the stopped data bases)
/STOP |
This command stops the various IMS resources that are active. Some examples include the following:
/STOP TRANSACTION CT7P01S1 (stop the active transactions)
/STO PROGRAM CT7P01S1 (stop the active programs)
/STO DATABASE CT7DPDA1 (stop the active data bases)
/DBRECOVERY |
This command stops and deallocates IMS databases from IMS online. It also stops the scheduling of any transactions or programs that use the databases using DBR. A true recovery is not always done. This command should only be issued when it is necessary to perform maintenance to the database. The NOFEOV keyword should also be used so that a log file switch is not made by IMS. AN example is:
/DBRECOVERY CT7DPDA1 or /DBR CT7DPDA1..... NOFEOV |
/RSTART |
This command starts an IMS node after it has been stopped by a previous transaction abend, or stopped by issuing a /STOP command. An example is:
/RSTART NODE WRDT0333 or /RST NODE WRDT0333 |
/END |
This command terminates the test mode invoked by the /TEST command, specifically the TEST MFS mode. An example is:
/END If you have been testing alternate devices, like 3270 printers, you must issue a variation to the /END command. The command to terminate the test mode of alternate devices looks like the following:
/END NODE LTERM |
The NODE keyword is where you specify the device ID known to IMS. For example, if you have been testing an application that writes MFS messages to a 3287 printer and the printer ID is HAH23V, the command you would issue to terminate the device test is
/END NODE HAH23V |
The /END command and the /END NODE command, like the /TEST MFS and /TEST NODE commands, are not mutually exclusive, but are both required to terminate a test session if both /TEST commands were issued to start the session.
/RCLSDST |
This command logs you off and disconnects your device from IMS. This command stands for Remote CLose DeSTination. An example is
/RCLSDST or /RCL |
If you have any doubts or queries related to this chapter, get them clarified from our Mainframe experts on IBMMainframer Community!