The information in this article applies to:
Product: MIM and PM4Data
Version: 8.x
Platform: z/OS
Discussion
The FTF command line with the -ofile option can be used to retrieve stored requests. To submit a previously saved request stored by the Process Monitor, simply prepend the value following the ofile argument with xmdir://.
For example, if a request has been saved as MyRequest in the Process Monitor, the command to submit the request would be ftf -ofile xmdir://MyRequest. This syntax can be used at an open system command prompt.
The same type of request can be submitted from JCL. Consider the out-of-the-box JCL that can be used to submit an FTF request. It also uses the -ofile option; however, it refers to a DD called OFILE that contains instream data. This instream data contains the normal FTF command line options. The following is an excerpt from a JCL stream:
//SYSCNTL JCLLIB ORDER=DEVCWG.PM818.CQ.JCLLIB // INCLUDE MEMBER=JCLVARS //\*-------------------------------------------------------------------- //\* FTF //\*-------------------------------------------------------------------- //FTF EXEC PGM=FTF, // PARM='/-OFILE DD:OFILE' //STEPLIB DD DISP=SHR,DSN=&ENVHLQ..CQ.LOADLIB //\* DD DISP=SHR,DSN=&SCEERUN \* C RUNTIME // DD DISP=SHR,DSN=&SCSQANLE \* MQ SCSQANLE DSN // DD DISP=SHR,DSN=&SCSQAUTH \* MQ SCSQAUTH DSN // DD DISP=SHR,DSN=&SCSQSNLE \* MQ SCSQAUTH DSN //SYSPRINT DD SYSOUT=\* //SYSOUT DD SYSOUT=\* //DSNTRACE DD SYSOUT=\* //CEEDUMP DD SYSOUT=\* //OUTPUT DD SYSOUT=\* //XMDIR DD PATH='&DATAPATH/config/client.xml' //OFILE DD \* -LQM HD01 -SQM HD01 -DQM HD01 -SPATH /u/DEVCWG/test.file -DPATH DEVCWG.TEST.FILE2 -stype HFS -delsrc /\* //\* END OF FTF.JCL
To convert this JCL to pull the stored request from the registry, you must change the PARM on the EXEC statement. The -OFILE DD:OFILE needs to be modified to use the xmdir:// syntax. Note that DD:OFILE can be removed.
The following converted JCL retrieves MyRequest from the registry:
//FTF EXEC PGM=FTF, // PARM='/-OFILE XMDIR://MyRequest' //STEPLIB DD DISP=SHR,DSN=&ENVHLQ..CQ.LOADLIB //\* DD DISP=SHR,DSN=&SCEERUN \* C RUNTIME // DD DISP=SHR,DSN=&SCSQANLE \* MQ SCSQANLE DSN // DD DISP=SHR,DSN=&SCSQAUTH \* MQ SCSQAUTH DSN // DD DISP=SHR,DSN=&SCSQSNLE \* MQ SCSQAUTH DSN //SYSPRINT DD SYSOUT=\* //SYSOUT DD SYSOUT=\* //DSNTRACE DD SYSOUT=\* //CEEDUMP DD SYSOUT=\* //OUTPUT DD SYSOUT=\* //XMDIR DD PATH='&DATAPATH/config/client.xml' //\* END OF FTF.JCL
- Note: The request name is case-sensitive, so be sure to set CAPS OFF.
