GDSX (Extended General Device Support) Manual

Service Routines
Extended General Device Support (GDSX) Manual—529931-001
8-40
GIVEBREAK
name-length returned value
INT:value
is the length in bytes of the SCF object name. If the SU or LINE is unconverted,
the value returned is always 24 bytes. If SU or LINE is converted, the value
returned is always the length of the object name, with a maximum of 32 bytes.
tcb input
INT .EXT:ref
is a pointer to a task’s TCB. The TCB pool can be scanned for the TCB
addresses. See the example for the TCBADDR on page 8-81.
name output
INT:ref:12
is the SCF object name (not the access name), whether the object was configured
by means of SCF, or the object was not configured explicitly and the object name
was derived by TSCODE from a device name. This SU or LINE name is taken
from the variable name in either the dcb^template or the line^template, depending
on whether the calling task is a DEVICE^HANDLER task or LINE^HANDLER task,
respectively.
GIVEBREAK
A task calls this procedure to give up the break ownership of the terminal it controls.
The following condition code settings are valid
GIVE^CPSEM
The checkpoint semaphore maintained internally by TSCODE guarantees that only
one task (system or user task) can initiate a checkpoint operation until the semaphore
CALL GIVEBREAK
= CCE indicates that the task successfully released break ownership for its
terminal.
< CCL indicates one of the following conditions:
•
An I/O error occurred on the SETPARAM issued by TSCODE to release
break ownership (the error number can be obtained by calling ^FILEINFO).
•
The checkpoint semaphore could not be obtained when the backup process
was to be updated with the break ownership information (only applies if
GDSX is run as a process pair).