DBATOOLS
Invokes the DBATOOLS utility.
Transfers control from your current process (which then
hibernates) to the specified process.
The DBATOOLS ATTACH and DBATOOLS SPAWN com-
mands cannot be used if your terminal has an associated
mailbox.
Note that this command is only available for users with DCL
access.
Parameters
process-name
Specifies the name of a parent process or spawned subpro-
cess to which control passes. The process must already exist,
be part of your current job, and share the same input stream
as your current process. However, the process cannot be your
current process or a subprocess created with the /NOWAIT
qualifier.
Process names can contain from 1 to 15 alphanumeric char-
acters. If a connection to the specified process cannot be
made, an error message is displayed.
Exactly one of the process-name parameter or /IDENTIFICATION
or /PARENT qualifiers must be specified. No combinations
are allowed.
Qualifiers
/IDENTIFICATION=pid
Specifies the process identification (PID) of the process to
which terminal control will be transferred. Leading zeros can
be omitted.
Exactly one of the process-name parameter or /IDENTIFICATION
or /PARENT qualifiers must be specified. No combinations
are allowed.
/PARENT
Indicates that you want to attach to the parent process of
your current process. If you did not access the DBATOOLS
utility by using the SPAWN command, an error message is
displayed.
Exactly one of the process-name parameter or /IDENTIFICATION
or /PARENT qualifiers must be specified. No combinations
are allowed.
Examples
1.
$ DBATOOLS ATTACH JONES_2
The ATTACH command transfers the terminal's control
to the subprocess JONES_2.
2.
DBATOOLS> ATTACH/IDENTIFICATION=30019
The ATTACH command switches control from the cur-
rent process to a process having the PID 30019. Notice
that because the /IDENTIFICATION qualifier is specified,
the process-name parameter is omitted.