Use the ZLINK command to add the edited routine to the current image. ZLINK automatically recompiles and relinks the routine. If the routine was the most recent one ZEDITed or ZLINKed, you do not have to specify the routine name with the ZLINK command.
![[Caution]](images/caution.png)
|
|
|
When you issue a DO command, GT.M determines whether the routine is part of the current image, and whether compiling or linking is necessary. Because this routine is already part of the current image, GT.M does not recompile or relink the edited version of the routine if you run the routine again without ZLINKing it first. Therefore, GT.M executes the previous routine image and not the edited routine. |
![[Note]](images/note.png)
|
|
|
You may have to issue a ZGOTO or a QUIT command to remove the unedited version of the routine from the M invocation stack before ZLINKing the edited version. |
Example:
GTM>ZLINK
%GTM-E-LOADRUNNING, Cannot ZLINK an active routine
This illustrates a GT.M error report caused by an attempt to ZLINK a routine that is part of the current invocation stack.
To ZLINK the routine, remove any invocation levels for the routine off of the call stack. You may use the ZSHOW "S" command to display the current state of the call stack. Use the QUIT command to remove one level at a time from the call stack. Use the ZGOTO command to remove multiple levels off of the call stack.
Example:
GTM>ZSHOW "S"
name+3^DMEX ($ZTRAP) (Direct mode)
beg^DMEX (Direct mode)
+1 ^GTM$DMOD (Direct mode)
GTM>ZGOTO
GTM>ZSHOW "S"
+1 ^GTM$DMOD (Direct mode)
GTM>ZLINK
This example uses a ZSHOW "S" command to display the current state of the call stack. A ZGOTO command without an argument removes all the calling levels above the first from the stack. The ZLINK automatically recompiles and relinks the routine, thereby adding the edited routine to the current image.