0LASubrEnvGetParentProc < Main

Tags: view all tags
---+ .ENV GET PARENT PROC

_This subroutine returns the name and type of the parent process._

<br />%TOC%
---++ Usage:
<pre>      PASS         &lt;parent_type&gt;              FIELD            SHARE? Y
      PASS         &lt;parent_name&gt;              FIELD            SHARE? Y
      PASS         &lt;parent_app&gt;               FIELD            SHARE? Y
      GOSUB    --- .ENV GET PARENT PROC
      *        Check for errors
      IF       --- .ENV GET PARENT PROC     NE

</pre>
---++ Description:

This subroutine returns the name and type of the parent process. All parameters are required, if any are missing the subroutine will CANCEL.

&lt;parent_type&gt; returns the process type of the parent process (Required). This must be PASSed with Share "Y" to return the value.

&lt;parent_name&gt; returns the process name of the parent process (Required). This must be PASSed with Share "Y" to return the value.

&lt;parent_app&gt; returns the application id of the parent process (Required). This must be PASSed with Share "Y" to return the value.

If any field you passed is too short to contain the data, --- .ENV GET PARENT PROC will be set to "Data was truncated".

Notes:

   * If you invoke this process via GOSUB, then the parent information will refer to the parent of the current process, since ILF code is compiled into the current process. If you invoke this process via SUBR, then the parent information will refer to the process that invoked the SUBR, since a SUBR invocation creates a new child process.
   * You cannot use this in a File Level Event Point, it will return blanks for all parameters.

---++ Comments:

_Read what other users have said about this page or add your own comments._

<br />%COMMENT%

-- Main.JeanNeron - 2012-01-26
Topic revision: r5 - 2020-05-12 - JeanNeron