QMF can interact with existing QMF applications that you have at your site. You can use the EXEC CICS START command with the transaction ID QMFn to start a QMF session from within a CICS application. An example of the command is shown in the following example. Replace the n symbol with the NLID from the Table 1.
EXEC CICS START
TRANSID('QMFn') FROM('M=B,I=START_PROC,UID=Q/QMF') TERMID('MYT5')
The command starts a noninteractive QMF session, connects QMF to DB2 using a user ID of Q and a password of QMF, then runs a QMF procedure named START_PROC.
Use the same rules for passing QMF program parameters that you use to start QMF from a cleared CICS screen, as shown in Starting QMF from a cleared CICS screen . You can use any QMF program parameter in a CICS application.
A terminal ID (TERMID) is required for an interactive session (when DSQSMODE = I), and optional for a noninteractive session (when DSQSMODE = B). If the terminal ID specifies the terminal where the calling CICS application is running, the QMF session starts when the CICS application finishes. If you do specify a terminal ID, the terminal must be available. Also ensure that the ID is defined as either a local terminal or a remote terminal on the system from which the START command is issued.
If you do not know the TERMID, issue the EXEC CICS ADDRESS EIB(xxx) parameter to retrieve it.
You might choose to run a nonineractive QMF session to conserve resources. Use a value of B for the DSQSMODE parameter and make sure that you use the DSQSRUN parameter to pass the name of an initial procedure to perform the necessary QMF tasks. Use the DSQSUSER parameter to ensure that you connect to the database using the appropriate SQL authorization ID and password.
If you do not specify a terminal ID, the QMF session runs without a terminal.
You can also start an interactive QMF session from within a CICS application. For example, the CICS application might be a menu application that allows users to start QMF from a menu of other products. A terminal ID is required to start an interactive session. Because the session runs interactively, you do not need to supply an initial procedure that runs when QMF starts, nor do you need to supply a value for the DSQSMODE parameter. If you want to connect to DB2 explicitly, supply values for the DSQSUSER parameter; otherwise, QMF connects to DB2 using the default VSE operator ID and password that are defined in the system catalog.
[ Previous Page | Next Page | Contents | Index ]