| type=page |
| status=published |
| title=attach |
| next=backup-domain.html |
| prev=apply-http-lb-changes.html |
| ~~~~~~ |
| |
| = attach |
| |
| [[attach-1]][[GSRFM825]][[attach]] |
| |
| == attach |
| |
| Attaches to subcommands that were started using `asadmin --detach` or |
| that contain progress information |
| |
| [[sthref32]] |
| |
| === Synopsis |
| |
| [source] |
| ---- |
| asadmin [asadmin-options] attach [--help] |
| job_id |
| ---- |
| |
| [[sthref33]] |
| |
| === Description |
| |
| The `attach` subcommand attaches to subcommands that were started using |
| the `asadmin` utility option `--detach` or that contain progress |
| information. The `--detach` option detaches long-running subcommands and |
| executes them in the background in detach mode. |
| |
| Job IDs are assigned to the subcommands (jobs), and can be used to view |
| the status of a job and its output. Use the |
| link:list-jobs.html#list-jobs-1[`list-jobs`(1)] subcommand to view the |
| jobs and their job IDs, and the |
| link:configure-managed-jobs.html#configure-managed-jobs-1[`configure-managed-jobs`(1)] |
| subcommand to configure how long information about the jobs is kept. |
| |
| This subcommand is supported in remote mode only. |
| |
| [[sthref34]] |
| |
| === Options |
| |
| asadmin-options:: |
| Options for the `asadmin` utility. For information about these |
| options, see the link:asadmin.html#asadmin-1m[`asadmin`(1M)] help page. |
| `--help`:: |
| `-?`:: |
| Displays the help text for the subcommand. |
| |
| [[sthref35]] |
| |
| === Operands |
| |
| job_id:: |
| The ID of the job for which you want to view status and output. |
| |
| [[sthref36]] |
| |
| === Examples |
| |
| [[GSRFM826]][[CBHDFEGB]] |
| |
| ==== Example 1 Attaching to a Subcommand and Checking Its Status |
| |
| This example attaches to the `deploy` subcommand with a job ID of `20` |
| and shows that the job is finished. If a subcommand is still in |
| progress, the output displays the current status, for example, |
| `64%: Uploading bits`. |
| |
| [source] |
| ---- |
| asadmin> attach 20 |
| Finished execution of deploy |
| Command attach executed successfully. |
| ---- |
| |
| [[sthref37]] |
| |
| === Exit Status |
| |
| 0:: |
| subcommand executed successfully |
| 1:: |
| error in executing the subcommand |
| |
| [[sthref38]] |
| |
| === See Also |
| |
| link:asadmin.html#asadmin-1m[`asadmin`(1M)] |
| |
| link:configure-managed-jobs.html#configure-managed-jobs-1[`configure-managed-jobs`(1)], |
| link:list-jobs.html#list-jobs-1[`list-jobs`(1)] |
| |
| |
