Invoking JMF *CALL,JMF

Function

Enter the *CALL,JMF command from a console associated with the required processor, or use the ROUTE command to direct the *CALL,JMF command to the appropriate processor.

*CALL JMF invokes the JMF facility and, if requested, generates reports for the following:

JES3 CPU activity
Activities on the FCT chain
JES3 spool data management
Device scheduling activity
Job throughput
Information related to Workload Management

Syntax


                      .-,--CYCLE--=--.2-.  .-,--DEBUG--=--N-.   
>>-+-*CALL-+--,--JMF--+-----------------+--+----------------+--->
   '-*X----'          '-,--CYCLE--=--nn-'  '-,--DEBUG--=--Y-'   

   .-,--DESTQ--=--Y-.   
>--+----------------+------------------------------------------->
   '-,--DESTQ--=--N-'   

   .-,--FCT--=--250--,--AWAIT--=--45--,--WAIT--=--100------------.   
>--+-------------------------------------------------------------+-->
   |                    .-,--AWAIT--=--45-.  .-,--WAIT--=--100-. |   
   '-,--FCT--=--+-nn-+--+-----------------+--+-----------------+-'   
                '-N--'  '-,--AWAIT--=--nn-'  '-,--WAIT--=--nn--'     

   .-,--INTERVAL--=--15-.  .-,--INTRDR--=--Y-.   
>--+--------------------+--+-----------------+------------------>
   '-,--INTERVAL--=--nn-'  '-,--INTRDR--=--N-'   

   .-,--JOB--=--50--,--JSTAT--=--5--------------.   
>--+--------------------------------------------+--------------->
   |                    .-,--JSTAT--=--5------. |   
   '-,--JOB--=--+-nn-+--+---------------------+-'   
                '-N--'  '-,--JSTAT--=--+-nn-+-'     
                                       '-N--'       

   .-,--SDM--=--Y-.  .-,--SMF--=--Y-.   
>--+--------------+--+--------------+--------------------------->
   '-,--SDM--=--N-'  '-,--SMF--=--N-'   

   .-,--SPOT--=--N--,--WIDTH--=--N--,--HFCT--=--N--,--NAME--=--N------------------------------------------.   
>--+------------------------------------------------------------------------------------------------------+-->
   |                  .-,--WIDTH--=--N--.  .-,--HFCT--=--N-----------.  .-,--NAME--=--N--------------.    |   
   '-,--SPOT--=--+-N--+-----------------+--+-------------------------+--+----------------------------+--+-'   
                 |    '-,--WIDTH--=--nn-'  '-,--HFCT--=--+-fctname-+-'  '-,--NAME--=--+-modulename-+-'  |     
                 |                                       '-ALL-----'                  +-ALL--------+    |     
                 |                                                                    '-NUC--------'    |     
                 |         .-,--WIDTH--=--N--.  .-,--HFCT--=--ALL-----.  .-,--NAME--=--ALL------------. |     
                 '-+-Y--+--+-----------------+--+---------------------+--+----------------------------+-'     
                   '-nn-'  '-,--WIDTH--=--nn-'  '-,--HFCT--=--fctname-'  '-,--NAME--=--+-modulename-+-'       
                                                                                       '-NUC--------'         

   .-,--SSI--=--Y-.  .-,--TIME--=--15-.  .-,--WLM--=--Y-.   
>--+--------------+--+----------------+--+--------------+------->
   '-,--SSI--=--N-'  '-,--TIME--=--nn-'  '-,--WLM--=--N-'   

   .-,--WTR--=--N--,--OUT--=--N----------------------------------.   
>--+-------------------------------------------------------------+-><
   |                            .-,--OUT--=--N-----------------. |   
   '-,--WTR--=--+-N----------+--+------------------------------+-'   
                +-Y----------+  '-,--OUT--=--+-devname-------+-'     
                '-modulename-'               +-+---+--devnum-+       
                                             | '-/-'         |       
                                             '-PRT-----------'

Parameters

CYCLE=nn | 2

Specifies the number of seconds (.01 through 300) before JMF takes a sample for the JMF report.

Note: The number selected for this parameter can degrade installation performance. See z/OS JES3 Diagnosis for more information concerning JMF.

DEBUG=Y|N

Specifies whether (Y) or not (N) JMF generates a dump when it completes. This parameter does not apply to the local.

DESTQ=Y|N

Specifies whether (Y) or not (N) JMF generates a destination queue report.

FCT=nn|N

Specifies whether (N) JMF generates a report for the specified number (1 through 4096) of function control table (FCT) entries on the chain. JMF selects the specified number of FCTs from the top of the chain.

Default: 250

AWAIT=45|nn

Specifies the number of times (0 through 99999999) the FCT must wait for processing to complete.

The maximum value of this parameter can be limited by the amount of storage available in your installation's JES3 address space. If you specify zero, JMF does not generate the AWAIT report. This subparameter is used with the FCT parameter.

WAIT=100|nn

Specifies the number of unique AWAITs (0 through 99999999) that will be collected for this FCT. Each AWAIT represents an event that the FCT must wait for processing to complete.

The maximum value of this parameter can be limited by the amount of storage available in your installation's JES3 address space. This subparameter is used with the FCT parameter.

INTERVAL=15|nn

Specifies the number of minutes (0.1 through 60) that will expire before JMF generates the next report.

INTRDR=Y|N

Specifies whether (Y) or not (N) JMF generates a report for the JES3 Internal reader. This parameter does not apply to the local.

JOB=nn|N

Specifies whether JMF should monitor the processing for a job. If you specify a numeric value or omit this parameter, JMF generates a report. JMF monitors the first nn jobs in the resqueue. If the parameter is omitted, the default is to monitor the first 50 jobs in the resqueue. If N is specified, JMF will not generate a report. This parameter does not apply on the local.

Default: 50

JSTAT=nn|N

Specifies whether JMF should generate a MDS and GMS Scheduling Analysis report for each job. If JOB=nn, and you do not specify this subparameter, JMF lists a maximum of five reasons why MDS bypassed scheduling for each job that it monitors. If you specify a numeric value, JMF lists to the specified value. JMF will not generate the report if JSTAT=N, JSTAT=0 or JOB=N is specified. This parameter does not apply on the local.

SDM=Y|N

Specifies whether (Y) or not (N) JMF generates a spool data management (SDM) report. If you do not specify this parameter, JMF generates an SDM report. JMF generates an SDM report when JMF reaches the time specified on the INTERVAL= parameter. If SDM=N, JMF does not produce a report.

SMF=Y|N

Specifies whether (Y) or not (N) JMF generates the report in SMF records. If you do not specify this parameter, JMF uses SMF records to format the output.

SPOT=N|Y|nn

Specifies whether JMF should provide a hot spot report that identifies the percentage of CPU time spent in each JES3 CSECT or JES3 module. If SPOT=Y, JMF generates a maximum number of 200 hot spot entries. If SPOT=nn, JMF generates a maximum of nn hot spot entries. If this parameter is omitted or SPOT=N or zero, no report is generated. This parameter is used with the FCT parameter.

WIDTH=

Specifies the number of bytes within a CSECT that JMF should monitor. If WIDTH=N and SPOT=Y, JMF generates a report for the entire CSECT. The minimum value for this parameter is one.

HFCT=

Specifies the number of FCTs JMF should monitor for hot spot analysis. If you specify HFCT=ALL, JMF should monitor the entire FCT chain. If you are interested in a single FCT, specify its name on this parameter.

NAME=

Specifies the CSECTS and JES3 modules JMF should monitor. If you request hot spot analysis and this option is omitted or ALL is specified, JMF generates a report for all JES3 CSECTS and modules. JMF can monitor a single area or related areas.

If you want JMF to monitor activity in a particular area, specify:

NAME=NUC for the JES3 nucleus.
NAME=modulename (the eight character identifier) for a specific CSECT or module.
```
To monitor the CPU activity in module IATGRJS, specify
NAME=IATGRJS.
```
NAME=modulename (a unique identifier) for a related group of modules and CSECTs.
```
To monitor the CPU activity in JES3 setup, specify
NAME=IATMD.
```

SSI=Y|N

Allows JMF to monitor the number of subsystem interface requests and responses. If you specify N, JMF does not produce a report.

TIME=15|nn

Specifies the number of minutes from 6 seconds to 7 days (0.1 through 10080) that JMF can run before ending.

WLM=Y | N

Specifies whether (Y) or not (N) to report Workload Management (WLM) information (such as the backlog of jobs in each service class). WLM=Y is not valid on a local processor. Y is the default on the global, and N is the default on the local.

WTR=Y|modulename|N

Specifies that JES3 formats a hardcopy report (Y); that the installation specify its own module to format a hardcopy report (modulename); that no hardcopy report is generated (N). This parameter does not apply to the local.

OUT=PRT|N|devname|devnum|/devnum

Specifies the printer for the formatted output. If OUT=N is specified, the hardcopy report will be sent to the default printer. This parameter does not apply to the local.

OUT=devnum or OUT=/devnum specifies a 3-digit or 4-digit hexadecimal device number. A slash (/) preceding the device number is not required. Device numbers can be specified by any of the following formats:

ddd dddd /ddd /dddd

where ddd and dddd represent the device numbers.

Examples

The following description provides an example of invoking JMF on a local. In the example, SY1 is the global and SY2 is the local where the system programmer wants JMF to run. To invoke JMF on the local, the system programmer issued the following command on the local:

*X,JMF,SMF=Y

In response to the command, JES3 displays the following message on the console where the command was issued:

IAT9601
  JMF INTERVAL STARTING ON SY2

To determine the status of JMF on all the mains in the complex, this command was entered:

*I,A,D=JMF

In response, JES3 issues:

IAT8524   JOB JMF  (JOB09992)    ACTIVE ON
SY1   00000.36 MIN IAT8524   JOB JMF  (00000000)    ACTIVE ON SY2   00000.73
MIN

Message IAT8524 contains a job number of 00000000 for the job number of JMF on all the locals. See z/OS JES3 Diagnosis for a description of the trace entries.