Guardian Procedure Calls Reference Manual

SETMYTERM Procedure (Superseded by PROCESS_SETSTRINGINFO_
Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameter
Condition Code Settings
Considerations
Summary
NOTE: This procedure is supported for compatibility with previous software and should not be
used for new development.
The SETMYTERM procedure permits a process to change the terminal that is used as its home
terminal (the default home terminal is the home terminal of a process' creator).
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 SETMYTERM ( terminal-name ); ! i
Parameter
terminal-name
input
INT:ref:12
contains the internal-format file name of the terminal or the process that is to function as the
caller's home terminal.
Condition Code Settings
indicates that the terminal cannot be reassigned, terminal-name is invalid, terminal-name is
not a terminal or a named process, or terminal-name has a second level qualifier (as in the example,
$TERM.#Q1.Q2).
< (CCL)
indicates that the SETMYTERM is successful.= (CCE)
does not return from SETMYTERM.> (CCG)
Considerations
If the caller to SETMYTERM creates any processes after the call to SETMYTERM, the new home
terminal is the home terminal for those processes. SETMYTERM has no effect on any existing process
created by the caller.
1348 Guardian Procedure Calls (S)