ITTUTERM — End external CTRACE recording

Description

Note: ITTUTERM is a linkable system service.

Use the ITTUTERM service to close the trace data set and unallocate resources that were allocated by the ITTUINIT service. uffer.

Environment

The requirements for the caller are:

Environmental factor Requirement
Minimum authorization: Problem state with PSW key 8-15
Dispatchable unit mode: Task
Cross memory mode: PASN=HASN=SASN
AMODE: 24- or 31-bit
ASC mode: Primary
Interrupt status: Enabled for I/O and external interrupts
Locks: No locks held
Control parameters: Must be in the primary address space.

Programming requirements

The caller determines whether ITTUTERM processing was successful by examining the return code.

Restrictions

The caller cannot have any enabled, unlocked task (EUT) FRRs established.

Input register information

Before linking to ITTUTERM, the caller must ensure that the following general purpose registers (GPRs) contain the specified information:
Register
Contents
1
Address of parameter list
13
Address of a standard 72-byte save area in the primary address space

Before linking to ITTUTERM, the caller does not have to place any information into any access register (AR).

Output register information

When control returns to the caller, the GPRs contain:
Register
Contents
0-1
Used as work registers by the system
2-13
Unchanged
14
Used as work register by the system
15
Return code
When control returns to the caller, the ARs contain:
Register
Contents
0-1
Used as work registers by the system
2-13
Unchanged
14-15
Used as work registers by the system

Some callers depend on register contents remaining the same before and after issuing a service. If the system changes the contents of registers on which the caller depends, the caller must save them before issuing the service, and restore them after the system returns control.

Performance implications

None.

Syntax

Use the following form of the LINK macro to invoke the ITTUTERM service: 
Read syntax diagramSkip visual syntax diagram
>>-label-------------------------------------------------------->

>--+-LINK--EP--=--ITTUTERM--,--MF--=--(--E--,--parmarea--)--------------------------------------+-><
   '-LINKX--EP--=--ITTUTERM--,--MF--=--(--E--,--parmarea--)--+--------------------------------+-'   
                                                             '-,--SF--=--(--E--,--parmlist--)-'     
Note: As an alternative to using LINK or LINKX, callers in 31-bit AMODE can also:
  1. Issue the MVS™ LOAD macro to load the ITTUTERM service and obtain its entry point address.
  2. Issue the CALL macro to call the service. Specify MF=(E,your_parmlist) on the call.

Parameters

The parameters are explained as follows:

label
The name on the macro invocation.
LINK
LINKX
Names the system service that is to be used for linkage.
EP=ITTUTERM
Specifies the entry point name for the ITTUTERM service.
,MF=(E,parmarea)
Specifies the address of the parameter list to be passed to ITTUTERM. The parameter list consists of the following address:
  • The address of the token passed from ITTUINIT.
,SF=(E,parmlist)
For use with LINKX when your program is reentrant. Before you call LINKX with this parameter, define parmlist using the LIST form of LINKX.

Return and reason codes

When the ITTUTERM service returns control to your program, Register 15 contains a return code.

Decimal Return Code Meaning and Action
00 Meaning: The ITTUTERM request completed successfully.

Action: None required.
non-zero Meaning: Warning. The ITTUTERM request did not complete successfully.

Action: Reissue ITTUTERM.