Updated February 2017
-j <jobname>
The -j switch forces A-Shell to use the specified jobname, provided it is not already in use. Otherwise A-Shell generates jobnames TSKAAA, TSKAAB, etc. (or uses the TRMDEF statements).
The -j switch supports two optional suffixes:
| # | will be converted into digit 1-9 to make the job name unique. Example: -j jack# will generate job names of JACK1, JACK2, etc.) |
| % | Same as #, above, but does not allow jobs originating from different workstations to share the same base jobname. This requires ATE to enforce the workstation identification aspect of that. |
Comments
Warning: If the specified jobname is already in use, the user will be prompted to kill the existing job (by sending the SIGKILL signal to it, generating ASB Error 251, generally followed by an exit.) And if the current launch command is executing in a background session (Unix), it will assume an affirmative response, i.e. will always try to kill a job with a conflicting name.
(Windows) The -j <jobnam> switch will automatically replace a conflicting entry in the job table if the job has not shown any signs of life in the last minute. This refinement is intended to improve recovery from situations where a service job is aborted in such a way that it is unable to remove itself from the job table (such as a Task Manager abort), causing the auto-restart of the job to fail.
History
2025 June, A-Shell 7.0.1733: The -j <jobnam> switch will now automatically replace a conflicting entry in the job table. See additional notes above.
2012 August, A-Shell 6.0.1255: Add optional suffixes as described above
