| 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,oac_no_warn] |
| ---- |
| 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,oac_no_warn] |
| ---- |
| 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)] |
| |
| |