9.3.5 builtin command (executes a built-in command)
Syntax
builtin [command [args ...]]
Description
This command executes a specified built-in command with arguments that are specified.
Arguments
- command
Specifies the name of the built-in command that is to be executed. If this argument is omitted, the command terminates normally.
- args
Specifies arguments for the built-in command.
Return codes
Return code |
Meaning |
---|---|
0 |
Normal termination
|
1 |
Error termination
|
Notes
This command accepts no options. If an option is specified in the arguments, it will be interpreted as an argument of command and the job will terminate with an error.
The execution results of this command are not output to the job execution log. Note also that this command does not identify whether the job or job step terminated normally or with an error. Refer instead to the execution results of the command that was called.
Even if the command syntax of this regular built-in command is invalid, it does not exit the shell that is executing the command.
Example
Use the builtin command to execute the pwd built-in command.
Contents of the job definition script
cd /tmp builtin pwd
Contents of the STDOUT file of the execution job
******** JOB SCOPE STDOUT ******** /tmp