GDSX (Extended General Device Support) Manual

Service Routines
Extended General Device Support (GDSX) Manual—529931-001
8-75
^SETMYTERM
Considerations
•
Because the working stack images of tasks are swapped to and from an extended
data segment during I/O operations, I/O must be performed to and from global
buffers.
•
Some applications may require the monitoring of 3270 device status by a call to
^SETMODENOWAIT with function code 53. In this case, the param2 parameter is
not passed on to AM3270. Instead, TSCODE passes the task number of the
caller. Then, when a type -21 system message is received by GDSX, it may route
the message to the proper task.
•
When a task owns break and a break occurs, the -20 system message is routed to
that task by way of $RECEIVE. The user task must issue ^SETMODENOWAITs to
restore the terminal to break and/or normal access.
•
Param1 is necessary for ITC files else an error FEMissParam is returned
^SETMYTERM
This procedure allows a task to change the object name of its corresponding SU or
LINE. If the task is converted, the DCB or LINE name and name length is updated in
the control block. If the task is not converted, only the DCB or LINE name is updated.
object-name input
INT:ref:16
is the SCF object name (not the access name). This SU or LINE name is assigned
to the variable name in the dcb^template or the lcb^template, depending on
whether the calling task is a DEVICE^HANDLER task or LINE^HANDLER task,
respectively.
filenum output
INT:ref
is the number of the file to which the calling task is associated. This is drawn from
the variable term in tcb^template, and is the same as the terminal file number or
the LINE file number for a DEVICE^HANDLER task or LINE^HANDLER task,
respectively.
CALL ^SETMYTERM ( object-name !
i
,[ filenum ] !
o
,length ] ); !
i