Profile Syntax Message Routine

z/OS MVS Programming: Writing Transaction Schedulers for APPC/MVS

Profile Syntax Message Routine

z/OS MVS Programming: Writing Transaction Schedulers for APPC/MVS
SA23-1398-00

This message routine is provided by IBM to enable TP profile syntax exits to write messages to the SYSPRINT data set about any errors that they find in the scheduling information being specified on a TPADD or TPMODIFY command through the APPC/MVS administration utility or dialog.

Environment

The profile syntax message routine receives control in the following environment:

Authorization:

Supervisor state and PSW key 1

Dispatchable unit mode:

Task mode

Cross memory mode:

PASN = HASN = SASN

AMODE:

31-bit

RMODE:

ANY

ASC mode:

Primary

Storage key:

TCB protect key:

Interrupt status:

Enabled

Locks:

The routine does not hold any locks on entry.

The TP profile syntax message routine runs under the APPC administration utility's task in the APPC administration utility's address space.

Entry Specifications

The profile syntax message routine receives information through registers and a parameter list.

Registers on Entry

On entry to the syntax message routine, the registers contain the following information:

Register	Contents
GPR 0	Does not contain any information for use by the exit.
GPR 1	The address of the parameter list described in Parameter List Contents.
GPRs 2-12	Do not contain any information for use by the exit.
GPR 13	The address of a standard 72-byte save area.
GPR 14	The return address.
GPR 15	The entry-point address.

Parameter List Contents

Figure 1 shows the input parameters to the TP profile syntax message routine.

Figure 1. Input to the TP Profile Syntax Message Routine

Return Specifications

Before returning control to its caller, the profile syntax message routine sets the register contents as follows:

Register	Contents
GPRs 0-14	The routine restores the contents to what they were when the routine received control.
GPR 15	One of the following decimal return code values: Value Meaning 0 No syntax errors encountered. 4 Errors encountered; no messages were sent to SYSPRINT.