Interface to the exit

The daily-planning-report exit is invoked in task mode, problem state, and key 8 and the job-step task is APF-authorized. The active task runs with the same access authority as the job-step task. The exit must restore this state before returning to its caller.

Control is passed to the exit using the BAL instruction. The exit must return to its caller using the address and addressing mode passed to it in general register 14.

The exit is entered in AMODE 31 but must switch to AMODE 24 before performing any input or output operations, and then switch back to AMODE 31 before returning to the caller.

If the exit abends, it is flagged as not executable; Tivoli Workload Scheduler for z/OS does not try to call the exit again.

When the exit is entered, register 1 contains the address of the parameter list. Each address in this list is used to locate the parameter value. These parameters are passed to the exit:

EQQDPUE1 parameters

 REPTYPE   DC   H      (Report type)
 REPLINE   DC   CL127  (Line of report)
 LINETYPE  DC   H      (Type of line)
 WSNAME    DC   CL4    (Name of WS (if REPTYPE=3))
 LINEBACK  DC   CL127  (Line to insert from exit)
 ACTION    DC   H      (Action for line)

REPTYPE

The call type. These values are valid:

1: All reports ended (no line available in this call)
2: Daily operating plan
3: Plan for workstation.

REPLINE

The line supplied to this exit; it has a maximum of 127 characters. This parameter specifies the line to print.

LINETYPE

Specifies the line type to print. These values are valid:

1: Subheader/its underscore/company heading
2: Sub-subheader/its underscore
3: Space line (type ---------------)
4: Space line (type | | | )
5: Data line
6: Blank line.

WSNAME

Specifies the name of the workstation. It is used only if REPTYPE=3; for the others, it remains blank.

LINEBACK

The output line; it has a maximum of 127 characters. The first character must be blank (it is an ASA control character).

ACTION

Specifies the action for the line. These values are valid:

0: Line unchanged
4: Line changed
8: Delete line
12: Insert line before line passed
16: Do not call any more; line unchanged.