SBMDKTJOB (Submit Diskette Jobs)

SBMDKTJOB Command syntax diagram

 

Purpose

The Submit Diskette Jobs (SBMDKTJOB) command allows jobs that are running to submit other jobs to job queues to be run as batch jobs. The input stream is read from a diskette. This command specifies:

A Submit Diskette Jobs operation reads the file once and ends when the end-of-file is read or when an ENDINP (End Input) command (delimiter) is encountered. The ENDINP command (delimiter) is not recognized if it is within an inline file that ends with characters that are not default ending characters (as specified in the ENDCHAR parameter of the DATA command). The SBMDKTJOB operation can be canceled either by canceling the request from the system request menu or by canceling the job in which the operation is running.

In contrast to a spool reader started with the Start Diskette Reader (STRDKTRDR) command, the SBMDKTJOB command operates in the same process as the requesting function and does not do syntax checking on the input stream.

Note: This command cannot be used to read the data files of diskettes that are in the save/restore format.

 

Required Parameters

DEV
Specifies the name of the diskette device used to read the input stream. Specify the name of the diskette device.

LABEL
Specifies the data file label (identifier) of the diskette data file on the diskette that contains the input stream. Specify the data file identifier. The data file identifier can be no longer than eight characters.

 

Optional Parameters

VOL
Specifies one or more volume identifiers used by the file. More information on this parameter is in Commonly used parameters.

*NONE: No volume identifiers are specified. The current volume is used.

volume-identifier: Specify the identifiers of one or more volumes in the order that they are put on the diskette device and used. Each volume identifier contains up to six characters. A blank is used as the separator character when listing multiple identifiers.

CRTDATE
Specifies the creation date of the object.

Note: The creation date should not be specified if the date is not checked. If the date written on the diskette containing the data file does not match the date specified here, an error message is sent to the message queue named in the MSGQ parameter.

*NONE: The creation date is not specified, and no check is made.

creation-date: Specify the creation date of the data file to be read. The date should be in the format specified by the QDATFMT system value.

CODE
Specifies the character code used. The code can be either extended binary-coded decimal interchange code (*EBCDIC) or the American National Standard Code for Information Interchange (*ASCII).

*EBCDIC: The extended binary-coded decimal interchange code (EBCDIC) character set code is used.

*ASCII: The ASCII character code is used.

JOBQ
Specifies the job queue on which the job entries are placed. A job entry is placed on this queue for each job in the input stream that has JOBQ(*RDR) specified on the Batch Job (BCHJOB) command. If *RDR is not specified on the BCHJOB command, the job queue specified on the BCHJOB command or in the job description is used. (The job queue for each job in the input stream can be different.) This parameter is valid only if ACTION(*SUBMIT) is specified on this command, in the existing network job entry, or in a subsequent Change Network Job Entry (CHGNETJOBE) command.

Note: If both the user identified in the job description of the job being read and the user processing the Submit Diskette Job (SBMDKTJOB) command are not authorized to the job queue on which the job should be placed, the job ends and a diagnostic message is placed in the job log. The input stream, continues to be processed, starting with the next job. If either user is authorized to the job queue, the job runs without error.

The name of the job queue can be qualified by one of the following library values:

*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 searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

QBATCH: The job entry is placed on the QBATCH job queue, which is the default job queue if JOBQ(*RDR) is specified on the BCHJOB command.

job-queue-name: Specify the name of the job queue to which each job in the job stream is sent if JOBQ(*RDR) is specified on its BCHJOB command.

MSGQ
Specifies the qualified name of the message queue to which messages are sent.

*DEVD: The messages are sent to the message queue indicated by the device description of the device being used.

*REQUESTER: The messages are sent to the workstation message queue of the workstation of the user who started the process. If this value is specified for a batch job, *OUTQ is used.

The name of the message queue can be qualified by one of the following library values:

*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 searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

message-queue-name: Specify the name of the message queue to which operational messages are being sent.

DSPSBMJOB
Specifies whether the jobs being submitted can be displayed on the submitted jobs display. Any submitted job of the type specified by the SBMFROM parameter of the WRKSBMJOB command can be displayed if *YES is specified.

*YES: This job can be displayed by the WRKSBMJOB command.

*NO: This job is not displayed on any display produced by the WRKSBMJOB command.

Example for SBMDKTJOB 

SBMDKTJOB  DEV(QDKT)  LABEL(OCT24)  VOL(SALES)

This command submits diskette jobs using diskette input from the device QDKT. The submit diskette jobs function gets its input from the data file named OCT24 with the volume identifiers SALES. The default job queue QBATCH is used as the receiving job queue when JOBQ(*RDR) is found in the job description. Operational messages are sent to the message queue defined by the device.

Error messages for SBMDKTJOB

*ESCAPE Messages

CPF1751
Error while processing job &3/&2/&1.
CPF1752
Device &1 not correct device type.
CPF1760
Submit jobs command not allowed.
CPF2207
Not authorized to use object &1 in library &3 type *&2.
CPF3307
Job queue &1 in &2 not found.
CPF3330
Necessary resource not available.
CPF3363
Message queue &1 in library &2 not found.
CPF9802
Not authorized to object &2 in &3.
CPF9814
Device &1 not found.
CPF9845
Error occurred while opening file &1.
CPF9846
Error while processing file &1 in library &2.

*STATUS Messages

CPF1755
Reading job &3/&2/&1 from volume &4.