Submit CODE Batch Job (SBMCODEJOB)

Where allowed to run:
  • Batch job (*BATCH)
  • Interactive job (*INTERACT)
  • Batch program (*BPGM)
  • Interactive program (*IPGM)
  • Batch REXX procedure (*BREXX)
  • Interactive REXX procedure (*IREXX)
  • Using QCMDEXEC, QCAEXEC, or QCAPCMD API (*EXEC)
Threadsafe: No
Parameters
Examples
Error messages

The CL command SBMCODEJOB submits a command to be run in batch, and optionally informs the work station when the job is complete and returns error feedback information from certain compile commands to the work station.

This command is intended to be used by the "CoOperative Development Environment/400" and "VRPG Client/2" features of the "IBM Application Development ToolSet Client Server/400" (ADTS CS/400) program product.

Top

Parameters

Keyword Description Choices Notes
CMD Command to run Command string Required, Positional 1
JOBD Job description Qualified object name Optional, Positional 2
Qualifier 1: Job description Name, *USRPRF
Qualifier 2: Library Name, *LIBL, *CURLIB
JOBQ Job queue Qualified object name Optional, Positional 3
Qualifier 1: Job queue Name, *JOBD
Qualifier 2: Library Name, *LIBL, *CURLIB
NOTIFY Notification message *YES, *NO Optional, Positional 4
SERVER Host server name Character value, OS400 Optional, Positional 5
ADDPARMS Additional SBMJOB parameters Character value, *NONE Optional, Positional 6
Top

Command to run (CMD)

Specifies the CL command that is to be run in batch.

Top

Job description (JOBD)

Specifies the name that is associated with the job when it is processed by the system.

The possible values are:

*USRPRF
The job description in the user profile under which the submitted job runs is used as the job description of the submitted job.
job-description-name
Specify the name (library-name/job-description-name) of the job description used for the job.

The possible values are:

*LIBL
All libraries in the job's library list are searched until the first match is found.
*CURLIB
The current library for the job is used to locate the job description name. If no library is specified as the current library for the job, QGPL is used.
library-name
Specify the name of the library where the job description name is located.
Top

Job queue (JOBQ)

Specifies the name of the job queue in which this job is placed.

The possible values are:

*JOBD
The submitted job is placed on the job queue named in the specified job description.
job-queue-name
Specify the name (library-name/job-queue-name) of the job queue on which the submitted job is placed.

The possible values are:

*LIBL
All libraries in the job's library list are searched until the first match is found.
*CURLIB
The current library for the job is used to locate the job queue name. If no library is specified as the current library for the job, QGPL is used.
library-name
Specify the name of the library where the job queue name is located.
Top

Notification message (NOTIFY)

Specify Yes to have the batch job inform the work station of the completion of the submitted command.

To use this option, an ICF file named EVFCICFF must be found in the library list of the batch job. This identifies the location of the work station. See the CODE/400 Installation Guide for more information on setting up the ICF file.

Top

Host server name (SERVER)

Specifies the name of a CODE/400 or VRPG/2 server that has already been started by the Start CODE (STRCODE) command.

This parameter is only used when the command being submitted generates error feedback information for use by the CODE/400 workstation editor. Only commands with the parameters OPTION(*SRCDBG), OPTION(*LSTDBG) and OPTION(*EVENTF) generate such error feedback.

Top

Additional SBMJOB parameters (ADDPARMS)

Specifies parameters to be used in the Submit Job (SBMJOB) command.

The SBMCODEJOB command invokes SBMJOB for you. It uses the system defaults for all SBMJOB parameters except CMD, JOBD and JOBQ. This parameter allows you to specify additional parameters for the SBMJOB command in order to override the system default. For example, to use your job description's library list in the batch job, specify 'INLLIBL(*JOBD)' in this parameter.

You can specify multiple SBMJOB parameters, but each must be separated by one or more blanks.

If 'INLLIBL(*JOBD)' is specified, that job description's library list must include a library with an EVFCICFF ICF file in it.

Top

Examples

None
Top

Error messages

Unknown
Top