User Display Facility

This section provides the background needed to implement the User Display Facility.

Introduction

The BMC ThruPut Manager User Display Facility (UDF) allows your datacenter users to display information about jobs processed by BMC ThruPut Manager. Using UDF, you can display information such as hold reasons and job dependencies for individual jobs or lists of jobs. This facility runs under ISPF and can be invoked with a single keystroke by assigning the TMUSER command to a PF key, referred to as the Hot Key.

Important

In order to use this facility, the appropriate ISPF data sets must be concatenated during the INSTALL process described in the Installation Guide.

UDF is sensitive to the environment in which it is invoked, and within recognized environments is also sensitive to the position of the cursor. Supported spool management products include:

  • SDSF
  • IOF
  • JES Master
  • SA/SYSVIEW

Once invoked, UDF uses a pop-up window approach to show you information about jobs processed by BMC ThruPut Manager.

UDF can be added to an ISPF environment quickly and easily. UDF uses standard ISPF interfaces and requires no modifications to the system.

Some Concepts

UDF is invoked through an ISPF command: TMUSER. It uses a PC-like interface to give users instant and convenient access to needed information.

In order to understand how UDF resembles a PC-like interface, it is necessary to introduce some basic concepts before proceeding with detailed descriptions.

Windows

A window is a framed portion of the logical ISPF screen that displays BMC ThruPut Manager information.

A UDF pop-up window can be thought of as a mini-ISPF screen. For most purposes, therefore, UDF windows can be treated as if they were ISPF screens. When UDF opens a window, it respects the logical ISPF screen divisions you have selected. If you split the screen, UDF detects this and adjusts its windows to respect your boundaries.

UDF operates with the standard ISPF scrolling commands. Standard ISPF scrolling commands and techniques are also supported at the command prompt. You can scroll up and down the display in any window that shows the word MORE in either the upper or lower line of the frame. The amount of text scrolled down or up can be controlled through the SCROLL field at the top of the logical screen.

The Hot Key

The Hot Key is a PF key that has been assigned the command TMUSER, which invokes UDF.

Like any command used in ISPF, you can assign TMUSER to a key of your choosing. Doing so allows you to display information by simply placing the cursor and hitting the assigned key. Although it is not necessary to assign a PF key to TMUSER, doing so makes invoking UDF easier and allows you take full advantage of its ability to detect supported spool management products.

The following discussions assume that such a Hot Key has been defined, although in every case you can achieve the same effect by entering the TMUSER command at the ISPF command prompt, then moving the cursor to the desired location before hitting ENTER.

Invoking the User Display Facility

The User Display Facility can be invoked in two ways:

  • In-context, by hitting the UDF Hot Key or by entering the TMUSER command while using a spool management product supported by UDF.
  • Explicitly, by entering the TMUSER command anywhere else in ISPF.

These invocation types are explained in detail later, but first it is necessary to introduce the Information Summary Line concept.

The Information Summary Line

Regardless of the type of invocation, UDF takes you to a window that has one or more Information Summary Lines. The Information Summary Line for a job always displays the same format and can always be used in the same way, no matter which window displays it.

GL3005TB JOB 1143 10 E 3    _ JB JC JL                  H

The Information Summary Line contains the jobname and job number. This might be followed by a line command area, depending upon the job's status.

BMC ThruPut Manager services affecting the job are listed using two letter acronyms. For example JB for Job Binding Services. Highlighted acronyms indicate that the service is causing the job to be held.

Finally, the line may contain the letters H or D, showing whether the job has been held or deferred by BMC ThruPut Manager.

Using the Information Summary Line

You can think of the Information Summary Line as a control line that you can use to get to any UDF window that applies to the job, as long as you are authorized to access the detailed information.

The ability to display the detailed level of job information can be restricted to specific ISPF users. How to control the display of information is discussed later on in this section.

The Line Command Area

If there is BMC ThruPut Manager information available, the Information Summary Line has a line command area:

  • Entering a D opens the Job Detail Window.
  • Entering a I opens the JES2 Job Select Information Window.
  • Entering a V opens the Volume Information Window. These windows are described in detail later.

The Service Acronyms

On the Information Summary Line, every BMC ThruPut Manager service affecting a job is represented by its two letter acronym. For example, a job using Job Setup Services has the acronym JS displayed. To display further information about a service and how it is affecting a job, tab or move the cursor to the acronym for the service in which you are interested, then hit ENTER. UDF opens the window associated with that service.

Other Information Displayed

The following descriptions explain other information that could be displayed on the Information Summary Line for an individual job.

  • D - If the job has been deferred, it is flagged with the letter D.
  • H - If the job is in hold, it is flagged with the letter H. If the job is being held by one of the BMC ThruPut Manager services, the acronym for that service is highlighted.
  • Data Only - This job is not under the control of any BMC ThruPut Manager Services, therefore only general information or Volume information (if any) can be displayed.
  • Failed - This job was failed during job analysis. BMC ThruPut Manager information could be available.
  • Exempt - This job was submitted in a class that is exempt from BMC ThruPut Manager processing, therefore no BMC ThruPut Manager information is available.
  • Analyzing - This job is currently being analyzed by BMC ThruPut Manager. If the job has not been previously analyzed, no BMC ThruPut Manager information is available.
  • Awaiting Analysis - This job is awaiting analysis by BMC ThruPut Manager. If the job has never been analyzed, no BMC ThruPut Manager information is available.
  • Awaiting XMIT - This job is awaiting transmission to another node. No BMC ThruPut Manager information is available.
  • Information Not Yet Available - There is no BMC ThruPut Manager information currently available for this job. The job has been selected while on the input or converter queue. Line commands are accepted because the job's status will change.
  • Not BMC ThruPut Manager Processed - BMC ThruPut Manager has never processed this job, therefore no information is available.
  • Duplicate - You have scrolled the spool manager's screen left or right, therefore UDF can no longer distinguish between duplicate jobnames. BMC ThruPut Manager information cannot be provided until you provide a job number.
  • Not Found - The job has been purged since the last time the spool manager's display was refreshed. No BMC ThruPut Manager information is available.
  • Job Analyzer Bypassed - The job has bypassed the job analyzer as a result of operator intervention. No BMC ThruPut Manager information is available.

In-context Invocation

UDF supports invocation in-context when used in conjunction with these spool management products:

  • SDSF, a product of IBM.
  • IOF, a product of Fischer International Systems Corporation.
  • JES Master, a product of XENOS Group Inc.
  • When invoked in-context, UDF operates in one of two modes:
  • List Mode, which provides a summary for each job in a list. The information is shown in the Job List Window.
  • Job-specific Mode, which provides specific detailed information for a particular job. The information is shown in a variety of windows, depending on the request.

Explicit Invocation

You can invoke UDF explicitly from anywhere in ISPF by hitting the Hot Key or entering the TMUSER command. The first window opened by explicit invocation is the Job Prompt Window, and as its name indicates it prompts you to enter the job name and job number. You must enter enough information to identify a specific job: a unique jobname; a job number; or if there are duplicate jobnames, a jobname and number combination.

Once a specific job has been identified, UDF opens the Job Detail Window provided that you are allowed to view detailed information for the job, otherwise a window containing the Information Summary Line and a message is opened.

When invoked explicitly, UDF operates in Job-specific Mode.

List Mode

As indicated earlier, List Mode occurs when UDF is invoked in-context. In this mode, UDF displays a list of Information Summary Lines corresponding to a list of jobs displayed by a supported spool manager.

When operating in List Mode UDF uses a concept called a coupled window. The Job List Window, shown below, is directly coupled to the job list display of the spool manager you are using. Each line in the Job List Window is directly related to the same line in the spool manager's display, and if you scroll up or down, the Job List and the spool manager's display scroll together.

 The Job List Window

---------------------------- TM/User Display Facility ----------------------
COMMAND INPUT ===>                                           SCROLL ===> CSR

NP JOBNAME TYPE JNUM PRTY C POS RMT *---------- (Job List Display) ------*
   AP9002UP JOB  1145 12  E  1      |_ JC JB                      H      |
   PR4000PR JOB  1147 12  E  2      |  Exempt                            |
   GL3005TB JOB  1143 10  E  3      |_ JB JC JL                   H      |
   UPDATE   JOB  1177 10  U  1   17 |_ JS                         H      |
   BMP202   JOB  1155 10  F  1      |_ JB                                |
   BMP203   JOB  1156 10  F  2      |_ DC JB                      H      |
   COMPILE  JOB  1139 10  D  1   20 |_ Awaiting Analysis           D     |
   MYTEST   JOB  1142 10  T  1   20 |_ Data Only                         |
   TLT90    JOB  1173 10  T  3      |_ JS                                |
   TLT91    JOB  1174 10  T  4      |_ JC JB                             |
   GL3005FR JOB  1169  9  T  5   7  |_ JB JL                             |
   RELOCAT  JOB  1175  9  H  1      |_ JL                                |
                                    *------------------------------------*

How Is This Window Opened?

The Job List Window opens when you hit the Hot Key while you are displaying a job list from one of the spool managers but without placing the cursor on a line containing a specific jobname or job number. Whenever the Job List Window is active, you are in List Mode.

 What Is In This Window?

The Job List Window simply contains a corresponding Information Summary Line for each job listed in the spool manager's display.

From This Window: Where Can I Go?

From the Job List Window you can go:

  • To the Job Detail Window by entering D in the line command area of an Information Summary Line and hitting ENTER.
  • To the Volume Information Window by entering V in the line command area of an Information Summary Line and hitting ENTER.
  • To the JES2 Job Select Information Window by entering I in the line command area of an Information Summary Line and hitting ENTER.
  • You can go to the window for any BMC ThruPut Manager service for which an acronym is shown by tabbing to the particular acronym in an Information Summary Line and hitting ENTER.

Job-specific Mode

Job-specific Mode is active whenever you are using a UDF window to display details about an individual job. Various UDF windows display information about different aspects of a specific job and how BMC ThruPut Manager processing affects it:

  • The Job Detail Window displays details about a job have been associated with a job as a result of BMC ThruPut Manager processing. The selection of job details is under the control of your installation.
  • The Volume Information Window displays a summary of the volumes associated with the job at the time of BMC ThruPut Manager processing.
  • TM Services Display Windows display details about a specific BMC ThruPut Manager service and how it affects the job. The BMC ThruPut Manager base product includes:
    • The Job Setup Services Display Window.
      When optional BMC ThruPut Manager components are installed, additional windows become available:
    • The Dataset Contention Services Display Window.
    • The Job Binding Services Display Window.
    • The Job Chaining Services Display Window.
    • The Job Limiting Services Display Window.
    • The System Level Manager Display Window.

To display information about the BMC ThruPut Manager Services that are currently controlling the job, tab or move the cursor to the acronym in the Information Summary Line for the service in which you are interested, then hit ENTER. UDF opens the window associated with the particular service.

The following pages provide more information about the UDF detail Windows. Note that these windows are available regardless of the type of invocation (explicit or in-context). For details about the windows for the optional BMC ThruPut Manager components, see the sections describing the individual functions.

 The Job Detail Window

------------------------- TM/User Display Facility -------------------------
COMMAND INPUT ===>                                           SCROLL ===> CSR
NP JOBNAME TYPE JNUM PRTY C POS RMT   *---------- (Job List Display) ------*
   AP9002UP JOB  1145 12  E  1        |_ JC JB                      H      |
   PR4000PR JOB  1147 12  E  2        |  Exempt                            |
   GL3005TB JOB  1143 10  E  3        |d JB JC JL                   H      |
   UPDATE   JOB  1177 10  U  1   17   |_ JS                         H      |
   BMP202   JOB  1155 10  F  1        |_ JB                                |
   BMP203   JOB  1156 10  F  2        |_ DC JB                      H      |
   COMPILE  JOB  1139 10  D  1   20   |_ Awaiting Analysis           D     |
   MYTEST   JOB  1142 10  T  1   20   |_ Data Only                         |
   TLT9 *----------------------- (Job Detail) ------------------------*    |
   TLT9 | GL3005TB(JOB01143)  _ JB JC JL                      H       |    |
   GL30 | Awaiting Execution E Priority 10               Held by JES2 |    |
   RELO | System Affinity(SYS3)                                       |    |
        | Submission Class      A     Execution Class      E          |----*
        | Submission Priority   6     Execution Priority  10          |
        | CPU Time     10:00 mins     Region Size       512K          |
        | Tape Cartridges       0     Drives               0          |
        *-------------------------------------------------------------*

How Is This Window Opened?

To open the Job Detail Window, you do one of the following:

From the UDF Job List Window
  • Tab or move the cursor to the line command area of the Information Summary Line for a job, then enter a D and hit ENTER.
Directly from your spool manager window
  • You place the cursor on a line from the spool manager's job list that contains a specific jobname or job number, then hit the Hot Key.
  • You do one of the following:
    • For SDSF, you hit the Hot Key when you are on the Dataset Display Screen.
    • For IOF, you hit the Hot Key when you are on the Job Summary Screen.
    • For JES Master, you hit the Hot Key when you are on the Job Display screen.
From the Job Prompt Window
  • Once a specific job has been identified, UDF opens the Job Detail Window provided that you are allowed to view detailed information for the job.

If you are not allowed to view detailed information about the job, a window is opened displaying the Information Summary Line for the job, accompanied by a message.

What Is In This Window?

The first line of the Job Detail Window is the Information Summary Line for the job.

The second line shows the job's current status. If the job is awaiting execution, the third line displays the job's system affinity.

Subsequent lines display information that has been associated with the job as a result of BMC ThruPut Manager processing. The information passed to UDF combines text with information about the job that has been collected by the BMC ThruPut Manager. Your installation can customize this display. If customization has not been done, UDF displays information that is of general interest.

From This Window: Where Can I Go?

From the Job Detail Window you can go:

  • To the Volume Information Window by entering V in the line command area of the Information Summary Line and hitting ENTER.
  • To the JES2 Job Select Information Window by entering I in the line command area of the Information Summary Line and hitting ENTER.
  • To the window for any BMC ThruPut Manager service for which an acronym is shown by tabbing to the particular acronym in the Information Summary Line and hitting ENTER.
  • If you invoked the Job Detail Window from the Job List Window, you can return to the Job List Window by hitting PF3, the END key.

The Volume Information Window

------------------------- TM/User Display Facility -------------------------
COMMAND INPUT ===>                                           SCROLL ===> CSR
NP JOBNAME TYPE JNUM PRTY C POS RMT   *---------- (Job List Display) ------*
   AP9002UP JOB  1145 12  E  1        |_ JC JB                      H      |
   PR4000PR JOB  1147 12  E  2        |  Exempt                            |
   GL3005TB JOB  1143 10  E  3        |_ JB JC JL                   H      |
   UPDATE   JOB  1177 10  U  1   17   |v JS                         H      |
   BMP202   JOB  1155 10  F  1        |_ JB                                |
   BMP203   JOB  1156 10  F  2        |_ DC JB                      H      |
   COMPILE  JOB  1139 10  D  1   20   |_ Awaiting Analysis           D     |
   MYTEST   JOB  1142 10  T  1   20   |_ Data Only                         |
   TLT9 *---------------------(Volume Information) -------------------*    |
   TLT9 | UPDATE(JOB01177)   _ JS                             H       |    |
   GL30 | Unavailable Volumes  T002AA                                 |    |
   RELO | Mountable Volumes    C094CS C296FW T620KW T311HL            |    |
        | Resident Volumes     RES021 RES004                          |----*
        *-------------------------------------------------------------*

 How Is This Window Opened?

To open the Volume Information Window, type a V in the line command area of the Information Summary Line for the job and then press ENTER.

 What Is In This Window?

The first line of the Volume Information Window is the Information Summary Line for the job.

Subsequent lines list the volumes associated with the job at the time the BMC ThruPut Manager processed it.

From This Window: Where Can I Go?

From the Volume Information Window you can go:

  • To the Job Detail Window by entering D in the line command area of an Information Summary Line and hitting ENTER.
  • To the window for any BMC ThruPut Manager service for which an acronym is shown by tabbing to the particular acronym in the Information Summary Line and hitting ENTER.
  • If you invoked the Volume Information Window from the Job List Window, you can return to the Job List Window by hitting PF3, the END key.

 Job Setup Services Display Window

------------------------- TM/User Display Facility -------------------------
COMMAND INPUT ===>                                           SCROLL ===> CSR
NP JOBNAME TYPE JNUM PRTY C POS RMT   *---------- (Job List Display) ------*
   AP9002UP JOB  1145 12  E  1        |_ JC JB                      H      |
   PR4000PR JOB  1147 12  E  2        |  Exempt                            |
   GL3005TB JOB  1143 10  E  3        |_ JB JC JL                   H      |
   UPDATE   JOB  1177 10  U  1   17   |_ JS                         H      |
   BMP202   JOB  1155 10  F  1        |_ JB                                |
   BMP203   JOB  1156 10  F  2        |_ DC JB                      H      |
   COMPILE  JOB  1139 10  D  1   20   |_ Awaiting Analysis           D     |
   MYTEST   JOB  1142 10  T  1   20   |_ Data Only                         |
   TLT9 *------------------------(JSS Display) -----------------------*    |
   TLT9 | UPDATE(JOB01177)   _ JS                             H       |    |
   GL30 | Hold Categories: HSM                                        |    |
   RELO | HSM        Hold will be removed in 20 minutes or when all   |    |
        |            data sets have been recalled                     |----*
        |                                                             |
        |                                                             |
        *-------------------------------------------------------------*

How Is This Window Opened?

The JSS Window is opened from the Information Summary Line in any window by tabbing or moving the cursor to the JSS acronym and hitting ENTER.

What Is In This Window?

The first line of the JSS Window is the Information Summary Line for the job.

The next line lists the hold categories for the selected job.

For each hold category listed, a subsequent text line provides further explanation of the hold. Remember that jobs can also be held for reasons not summarized in this window.

From This Window: Where Can I Go?

From the JSS Window you can go:

  • To the Job Detail Window by entering D in the line command area of the Information Summary Line and hitting ENTER.
  • To the Volume Information Window by entering V in the line command area of the Information Summary Line and hitting ENTER.
  • To the window for any BMC ThruPut Manager service for which an acronym is shown by tabbing to the particular acronym in the Information Summary Line and hitting ENTER.
  • If you invoked the JSS Window from the Job List Window, you can return to the Job List Window by hitting PF3, the END key.

Managing the User Display Facility

The User Display Facility allows users to examine information that has been collected by BMC ThruPut Manager. You can also store information with each job to be displayed by users.

New Job Action Language statements are available with UDF, providing these functions:

  • A way to store information with each job. Authorized users can then use the TMUSER command to display the accumulated data.
  • A means to control which users are authorized to display information.

The ability to display the detailed level of information for a job can be restricted to specific ISPF users. Through the new JAL statements, authorities can be associated with individual jobs. These authorities determine which users or groups of users are allowed to display detailed information. Authorities can be based on RACF, ACF2, Top Secret, or TSO userids, and can also cause a prompt for users to match a specified string before allowing access.

Two levels of BMC ThruPut Manager information are therefore available through UDF:

  • General information is available to any user:
    • The BMC ThruPut Manager services that currently control the job, such as Job Binding Services.
    • Whether the job is being held by BMC ThruPut Manager.
  • Detailed information can be displayed only by those users permitted to do so by the job's authorities:
    • Information associated with the job during JAL processing.
    • Volume information.
    • Details about BMC ThruPut Manager services that currently control the job, for example Job Setup Services.

If not restricted by JAL, the access allowed by UDF depends on the method used to select the job. See the discussion later in this section.

Extensions to JAL to Support UDF

New JAL statements are available to support UDF. They are summarized here:

Statement

Description

JOB_DATADEF

Define information for later display by operators or ISPF users.

JOB STORE

Associates data defined by prior JOB_DATADEF statements with the job currently being processed by BMC ThruPut Manager.

JOB USER_DISPLAY

Provides authorization information to the User Display Facility.

These new statements can be applied to each job processed by BMC ThruPut Manager:

  • The JOB_DATADEF and JOB STORE statements make job-related information available to an ISPF user. Any data from JAL Job Descriptors can be passed to the BMC ThruPut Manager User Display Facility. The JOB STORE Action Statement then allows you to specify the intended use for data created with JOB_ DATADEF.
  • The JOB USER_DISPLAY statement provides a mechanism to restrict the display of job-related information to specific ISPF users.

Information collected during BMC ThruPut Manager processing is associated with individual jobs. To do this, you simply use the JOB_DATADEF statement to combine text with the Job Descriptors for the job. Alternatively, you can define messages that communicate decisions made in JAL that affect the job. For example:

JOB_DATADEF  TM_INFO_L1 (‘Requires ‘,$UNITS_CART_ALL,’ Tape Units’)
JOB_DATADEF  TM_INFO_L2 (‘Testing job, assigned Overnight Service’)

The information is made available to UDF with the JOB STORE statement through the USER_DATA keyword:

JOB STORE USER_DATA(LINE1(TM_INFO_L1),LINE2(TM_INFO_L2))

The information, however, is not necessarily available to all users. Also associated with a job are authorities that can be set during BMC ThruPut Manager processing using the JOB USER_DISPLAY statement:

JOB USER_DISPLAY USERID(ACC3*)

This statement assigns authorities to the job that allow only userids beginning with the characters ACC3 to examine detailed information.

For complete syntax descriptions and capability of the UDF JAL statements, see the JAL Reference Guide and the DAL/JAL User Guide.

Controlling Access to Information

The ability to display detailed job information can be restricted. The JAL statement JOB USER_DISPLAY allows you to choose the restrictions you want to apply to the display of detailed job information:

  • You can use JAL pattern matching to authorize specific users for individual jobs.
  • You can elect to pass information to the same exit your installation uses to process the TSO STATUS command.

Note that if in your JAL you code:

JOB USER_DISPLAY USERID(*)

then the installation exit used to process the TSO STATUS command is not called, and all ISPF users are authorized to view job-related data. This is the default.

Using Your Installation's Exit

If you code the EXIT form of the JOB USER_DISPLAY statement, the installation exit used to process the TSO STATUS command is assumed to perform all authorization checking. This is indicated in JAL by coding:

JOB USER_DISPLAY EXIT

For a syntax description of the JOB USER_DISPLAY EXIT statement, see the JAL Reference Guide.

When the JOB USER_DISPLAY statement is processed, authorization information about the job is stored for use by UDF. When a user attempts to use UDF, it calls the exit routine your installation uses to process the TSO STATUS command.

The exit routine as supplied by IBM is called IKJEFF53. It is invoked in the manner documented in the manual SPL: TSO Extensions User Exits and Modifications Volume 2, except that registers 2 and 3 contain information identifying the call as an UDF request.

Registers At Entry

The following describes the expected contents of the registers at entry to your installation's exit.

Register 1

Register 1 contains the address of the standard ten-word parameter list.

To format the parameter list pointed to by register 1, you can code the following IKJEFFIE mapping macro instruction:

IKJEFFIE   IETYPE=CANST

This generates a parameter list as shown in the table below.  

WORD

CONTENTS

1

Address of the jobname.

2

Address of a halfword containing the length of the jobname.

3

Address of the userid.

4

Address of one byte containing the length of the userid.

5

This field is set to zeros.

6

This field is set to zeros.

7

Address of one byte containing a command code of zero (0), indicating a STATUS-type request.

8

Address of the JES2 jobid.

9

Address of a halfword containing the length of the jobid.

10

This field is set to zeros, except that the high-order bit is turned on to indicate the end of the parameter list.

Register 2

Register 2 contains the character string 'TMIN'. This distinguishes a UDF request from that of a STATUS or CANCEL.

Register 3

Register 3 contains the address of the DATA string provided by JAL. This register contains zeros if no DATA string was provided. The format of this area is:

llstring

Where:

ll

Is a two-byte field containing the length of the entire string (including the length field).

tring

Is a maximum of 255 bytes of your data. The length field does not count towards this maximum.

UDF and Variable Spool Manager Headers

Some spool managers, such as CA/Sysview, allow you to vary the information in the headers used in their displays. It is also possible that these headings can vary from release to release of a product. Because UDF uses this header information to locate the JES2 job numbers on the screen, it might be necessary to indicate to BMC ThruPut Manager what the possible headings are for your installation. This is the purpose of the UDF SET initialization statement.

---------------------------- TM/User Display Facility ----------------------
COMMAND INPUT ===>                                           SCROLL ===> CSR

NP JOBNAME TYPE JES2# PRTY C POS RMT *---------- (Job List Display) ------*
   AP9002UP JOB  1145 12  E  1      |_ JC JB                      H      |
   PR4000PR JOB  1147 12  E  2      |  Exempt                            |
   GL3005TB JOB  1143 10  E  3      |_ JB JC JL                   H      |
   UPDATE   JOB  1177 10  U  1   17 |_ JS                         H      |
   BMP202   JOB  1155 10  F  1      |_ JB                                |
   BMP203   JOB  1156 10  F  2      |_ DC JB                      H      |
   COMPILE  JOB  1139 10  D  1   20 |_ Awaiting Analysis           D     |
   MYTEST   JOB  1142 10  T  1   20 |_ Data Only                         |
   TLT90    JOB  1173 10  T  3      |_ JS                                |
   TLT91    JOB  1174 10  T  4      |_ JC JB                             |
   GL3005FR JOB  1169  9  T  5   7  |_ JB JL                             |
   RELOCAT  JOB  1175  9  H  1      |_ JL                                |
                                    *------------------------------------*

In the screen above, the highlighted portion of the header line:

JES2#

is an example of a header that has been altered. To inform BMC ThruPut Manager of this change so that UDF will work properly, you use the UDF SET initialization statement:

UDF SET SDSF_JOBID(JES2#)

Details of the syntax and usage of this statement are found in TMSS Initialization Statements.

Implementation Summary

UDF can be added to an ISPF environment quickly and easily. UDF uses standard ISPF interfaces and requires no modifications to the system. UDF has the following "parts":

  • TMUSER, a ISPF command to invoke UDF.
  • A set of ISPF panels.
  • ISPF HELP entries.
  • A set of ISPF messages.
  • A command table for TMUSER subcommands.

Details concerning the installation of UDF can be found in the Installation Guide.

Dependencies

There are no other dependencies with this facility.


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*