DETACH function
The DETACH function corresponds to the DETACH line command, which can be issued for System Layers from the TSYSLYR view or Sysplex Layers from the TPLXLYR view.
The DETACH function allows you to delete objects and sets of objects that were previously generated by the ATTACH command; for example:
- With a System Layer, deletes generated objects and sets based on the layer objects and layer sets that are included in the System Layer definition. The objects are deleted for the system from which you are detaching the System Layer.
- With a Sysplex Layer, deletes objects and sets defined to each System Layer that are included in the Sysplex Layer definition. The objects are deleted for each system in the sysplex from which you are detaching the System Layer.
The following REXX variables should be set in the EXEC before the TOMEXEC FUNC(DETACH) statement:
- LINE.SYSPLEX = name_of_sysplex_from_which_the_Sysplex_Layer_is_to_be_detached
- LINE.SYSPLEXLAYER = name_of_Sysplex_Player_to_detach_from_the_sysplex
- LINE.SYSTEM = name_of_system_from_which_the_System_Layer_is_to_be_detached
- LINE.SYSTEMLAYER = name_of_System_Layer_to_detach_from_the_system
- LINE.DEFBASE = name_of_definition_base_where_the_generated_objects_are_stored
The following table shows the command and parameters:
Command | Parameters |
|---|---|
TOMEXEC FUNCTION(DETACH) | TYPE(SYSPLEX|SYSTEM) [STEM(LINE)] [TOMID(’tom ID’) | TOMPLEX(’tomplex name’)] SYSPLEX(‘name’) | DEFBASE(‘name’) |
The following table describes the parameters:
Parameter | Function |
|---|---|
TYPE | Specify SYSPLEX or SYSTEM where: SYSPLEX: REXX EXEC must specify stem variables LINE.SYSPLEX (for the sysplex to detach from) and LINE.SYSPLEXLAYER (for the sysplex-layer to detach) before the TOMEXEC FUNCTION(DETACH) TYPE(SYSPLEX) command is issued SYSTEM: REXX EXEC must specify stem variables LINE.LAYERSYSPLEX (for the sysplex that owns LINE.SYSTEM) and LINE.SYSTEM (for the system to detach from) and LINE.SYSTEMLAYER (for the system-layer to detach) before the TOMEXEC FUNCTION(DETACH) TYPE(SYSTEM) command is issued |
STEM | Specify the prefix of the REXX stem variables that contain the properties of the item to be detached. The default REXX stem value is LINE. |
DEFBASE | Specify the definition base that contains the generated objects or sets for the attached system (or sysplex) to be deleted. This value is associated with the SYSPLEX keyword value. If it is not specified, the currently active object base is used. |
SYSPLEX | Specify the sysplex associated with the definition base (object or calendar) specified by the DEFBASE parameter value where the deleted item should be deleted from the registry. If it is not specified, the sysplex of the system where the TOM PAS is running will be used. |
TOMID | Specify the ID of the TOM PAS on which you want the command issued. |
TOMPLEX | Specify the name of the TOMPLEX where you want to issue the function. See Specifying-the-TOMID-and-TOMPLEX-parameters for usage information. |
This section contains the following topics:
Related topic