Guardian Procedure Calls Reference Manual

MYTERM Procedure (Superseded by PROCESS_GETINFOLIST_ Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameter
Considerations
Summary
NOTE: This procedure is supported for compatibility with previous software and should not be
used for new development.
The MYTERM procedure provides a process with the file name of its home terminal. The file name
returned from MYTERM is suitable for passing directly to any Guardian procedure that accepts a
file name in internal form.
Syntax for C Programmers
This procedure does not have a C syntax, because it is superseded and should not be used for
new development. This procedure is supported only for compatibility with previous software.
Syntax for TAL Programmers
CALL MYTERM ( file-name ); ! o
Parameter
file-name
output
INT:ref:12
is a 12-word array where MYTERM returns the device name and the subdevice name, if any, of
the home terminal in one of these two forms:
$devname [#subdev-name]
$process-name [#subname]
Considerations
• The file name returned from MYTERM is the same form as that used by the file-system
procedures.
• The home terminal is always the same as the home terminal of a process' true creator (not the
process that adopted it through STEPMOM or PROCESS_SETINFO_), unless the home terminal
is altered by SETMYTERM or the home terminal option in PROCESS_CREATE_,
PROCESS_SPAWN_, NEWPROCESS, NEWPROCESSNOWAIT, OSS tdm_fork(), OSS
tdm_spawn(), or one of the OSS tdm_exec set of functions.
If the process calling MYTERM is a descendant of a command interpreter, then the home
terminal is the same as that of the command interpreter or that of an explicit TERM specifier
on the RUN command.
• If the home terminal is on a remote node and has either a device name consisting of more
than seven characters or a process name consisting of more than five characters, the call to
MYTERM fails; a Guardian TNS process terminates with a limits exceeded trap (trap 5): an
OSS or native process receives a SIGLIMIT signal. If the home terminal is unnamed and its
I/O process is running at a high PIN, MYTERM also fails with a trap 5 or a SIGLIMIT signal.
MYTERM Procedure (Superseded by PROCESS_GETINFOLIST_ Procedure) 845